skill-developer
- Repo stars 437
- Author repo antigravity-ide
Skill Developer Guide
Purpose
Comprehensive guide for creating and managing skills in Claude Code with auto-activation system, following Anthropic's official best practices including the 500-line rule and progressive disclosure pattern.
When to Use This Skill
Automatically activates when you mention:
- Creating or adding skills
- Modifying skill triggers or rules
- Understanding how skill activation works
- Debugging skill activation issues
- Working with skill-rules.json
- Hook system mechanics
- Claude Code best practices
- Progressive disclosure
- YAML frontmatter
- 500-line rule
System Overview
🧠 Knowledge Modules (Fractal Skills)
1. Two-Hook Architecture
2. Configuration File
3. 1. Guardrail Skills
4. 2. Domain Skills
5. Step 1: Create Skill File
6. Step 2: Add to skill-rules.json
7. Step 3: Test Triggers
8. Step 4: Refine Patterns
9. Step 5: Follow Anthropic Best Practices
10. BLOCK (Critical Guardrails)
11. SUGGEST (Recommended)
12. WARN (Optional)
13. 1. Session Tracking
14. 2. File Markers
15. 3. Environment Variables
16. TRIGGER_TYPES.md(TRIGGER_TYPES.md)
17. SKILL_RULES_REFERENCE.md(SKILL_RULES_REFERENCE.md)
18. HOOK_MECHANISMS.md(HOOK_MECHANISMS.md)
19. TROUBLESHOOTING.md(TROUBLESHOOTING.md)
20. PATTERNS_LIBRARY.md(PATTERNS_LIBRARY.md)
21. ADVANCED.md(ADVANCED.md)
22. Create New Skill (5 Steps)
23. Trigger Types
24. Enforcement
25. Skip Conditions
26. Anthropic Best Practices
27. Troubleshoot
- Fluxly category
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 92 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @Dokhacgiakhoa · v4.1.0-fractal · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Plug-and-play
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Write / modify
- Env read
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. 5. [Step 1: Create Skill File](./sub-skills/step-1-create-skill-file.md)
5. [Step 1: Create Skill File](./sub-skills/step-1-create-skill-file.md)
6. [Step 2: Add to skill-rules.json](./sub-skills/step-2-add-to-skill-rulesjson.md)
6. [Step 2: Add to skill-rules.json](./sub-skills/step-2-add-to-skill-rulesjson.md)
# Skill Developer Guide
## Purpose
Comprehensive guide for creating and managing skills in Claude Code with auto-activation system, following Anthropic's official best practices including the 500-line rule and progressive disclosure pattern.
## When to Use This Skill
Automatically activates when you mention:
- Creating or adding skills
- Modifying skill triggers or rules
- Understanding how skill activation works
- Debugging skill activation issues
- Working with skill-rules.json
- Hook system mechanics
- Claude Code best practices
- Progressive disclosure
- YAML frontmatter
- 500-line rule
---
## System Overview
## 🧠 Knowledge Modules (Fractal Skills)
### 1. [Two-Hook Architecture](./sub-skills/two-hook-architecture.md)
### 2. [Configuration File](./sub-skills/configuration-file.md)
### 3. [1. Guardrail Skills](./sub-skills/1-guardrail-skills.md)
### 4. [2. Domain Skills](./sub-skills/2-domain-skills.md)
### 5. [Step 1: Create Skill File](./sub-skills/step-1-create-skill-file.md)
### 6. [Step 2: Add to skill-rules.json](./sub-skills/step-2-add-to-skill-rulesjson.md)
### 7. [Step 3: Test Triggers](./sub-skills/step-3-test-triggers.md)
### 8. [Step 4: Refine Patterns](./sub-skills/step-4-refine-patterns.md)
### 9. [Step 5: Follow Anthropic Best Practices](./sub-skills/step-5-follow-anthropic-best-practices.md)
### 10. [BLOCK (Critical Guardrails)](./sub-skills/block-critical-guardrails.md)
### 11. [SUGGEST (Recommended)](./sub-skills/suggest-recommended.md)
### 12. [WARN (Optional)](./sub-skills/warn-optional.md)
### 13. [1. Session Tracking](./sub-skills/1-session-tracking.md)
### 14. [2. File Markers](./sub-skills/2-file-markers.md)
### 15. [3. Environment Variables](./sub-skills/3-environment-variables.md)
… Evidence boundary and execution chain
Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> Purpose → When to Use This Skill → System Overview → 🧠 Knowledge Modules (Fractal Skills) → 1. [Two-Hook Architecture](./sub-skills/two-hook-architecture.md) → 2. [Configuration File](./sub-skills/configuration-file.md)
terms -> no emphasized key terms
files/cmd -> skill-rules.js · ./sub-skills/two-hook-architecture.md · ./sub-skills/configuration-file.md · ./sub-skills/1-guardrail-skills.md · ./sub-skills/2-domain-skills.md · ./sub-skills/step-1-create-skill-file.md · ./sub-skills/step-2-add-to-skill-rulesjson.md · ./sub-skills/step-3-test-triggers.md
body sha256 -> e27b4ece600a
Decide Fit First
Design Intent
How To Use It
Boundaries And Review