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 the rules/ directory.

2. Metadata (HIGH)

meta-frontmatter - Include complete YAML frontmatter in SKILL.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