Skip to main content
Skills are self-contained packages of domain knowledge, patterns, and workflows that agents and commands reference when performing tasks. They provide deep, actionable reference material for specific development domains.

What Are Skills?

Skills are markdown files (typically SKILL.md) with YAML frontmatter containing:
  • Workflow definitions - Step-by-step methodologies
  • Best practices - Patterns and anti-patterns
  • Code examples - Real implementations from the codebase
  • Reference material - Framework-specific knowledge

Skill Structure

Here’s an example from the tdd-workflow skill:
~/workspace/source/skills/tdd-workflow/SKILL.md

Step 2: Run Test - Verify FAIL

Step 3: Implement Minimal Code (GREEN)

Step 4: Run Test - Verify PASS

Step 5: Refactor (IMPROVE)

Step 6: Verify Coverage

Test Organization (from tdd-workflow)

Creating Custom Skills

You can create project-specific skills:
~/.claude/skills/my-skill/SKILL.md

Anti-Patterns to Avoid

  • ❌ Anti-pattern 1
  • ❌ Anti-pattern 2