What problem does it solve?
This Skill provides a comprehensive framework and best practices for creating, managing, and troubleshooting Claude Code skills, ensuring they are effective, maintainable, and adhere to Anthropic's guidelines. It reduces complexity and saves time in skill development by centralizing knowledge on skill structure, triggers, enforcement, and debugging.
Core Features & Use Cases
- Skill Creation & Management: Guides you through structuring new skills, defining trigger patterns (keywords, intent, file paths, content), and configuring enforcement levels (block, suggest, warn).
- Debugging & Troubleshooting: Offers detailed steps to diagnose and resolve issues with skill activation, false positives, and hook execution, ensuring your skills work as intended.
- Best Practices Enforcement: Promotes Anthropic's 500-line rule and progressive disclosure patterns for high-quality, maintainable skills, fostering a consistent development approach.
- Use Case: When you need to create a new "database-verification" guardrail skill, this guide walks you through defining its triggers, setting its enforcement to "block" to prevent critical errors, and testing its activation to ensure it functions correctly.
Quick Start
To create a new skill, start by creating a new directory under .claude/skills/ and add a SKILL.md file with the required YAML frontmatter. Then, add its configuration to skill-rules.json following the examples provided in this skill.
