skill-developer

version	4.1.0-fractal
name	skill-developer
description	Create and manage Claude Code skills following Anthropic best practices. Use when creating new skills, modifying skill-rules.json, understanding trigger patterns, working with hooks, debugging skill activation, or implementing progressive disclosure. Covers skill structure, YAML frontmatter, trigger types (keywords, intent patterns, file paths, content patterns), enforcement levels (block, suggest, warn), hook mechanisms (UserPromptSubmit, PreToolUse), session tracking, and the 500-line rule.

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