Skills Crafter
Comprehensive guide for creating, structuring, and maintaining agent skills.
When to use this skill
Reference these guidelines when:
- Creating a new skill from scratch
- Refactoring an existing skill
- Adding new rules to a skill
- Organizing skill resources and examples
- Validating skill structure and compliance
Rule Categories by Priority (Example)
[!NOTE] The following categories are examples. Skills can define their own categories and priorities based on their specific needs.
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Structure | CRITICAL | struct- |
| 2 | Metadata | HIGH | meta- |
| 3 | Content | MEDIUM | content- |
Quick Reference
1. Structure (CRITICAL)
struct-skill-scaffold- Follow the strict directory hierarchy (SKILL.md,rules/,examples/).struct-modular-rules- Break rules into individual markdown files in therules/directory.
2. Metadata (HIGH)
meta-frontmatter- Include complete YAML frontmatter inSKILL.md.meta-naming- Use semantic, kebab-case naming for skills and files.meta-rule-categories- Define priority categories and use prefixes for rule files.
3. Content (MEDIUM)
content-rule-format- Use the standard Why/Incorrect/Correct format for rule definitions.
How to Use
Read individual rule files for detailed explanations and examples:
rules/struct-skill-scaffold.md
rules/meta-frontmatter.md
rules/meta-rule-categories.md
rules/content-rule-structure.md
Each rule file contains:
- Brief explanation of why it matters
- Incorrect example with explanation
- Correct example with explanation