SKILL: Claude-Pilot Standards

Purpose: Author reference for creating plugin components Target: Contributors creating skills, commands, agents

Quick Reference

| Component | Location | Purpose | Size Limit | |-----------|----------|---------|------------| | Skills | .claude/skills/{name}/ | Auto-discoverable capabilities | SKILL: 200, REF: 300 | | Commands | .claude/commands/ | Slash commands | 150 lines | | Agents | .claude/agents/ | Specialized configs | 200 lines | | Rules | .claude/rules/ | Delegation patterns | 200 lines |

Component Taxonomy

Skills

Structure: {name}/SKILL.md (≤200) + REFERENCE.md (≤300)

Required: name, description with trigger keywords

Examples: @.claude/skills/tdd/SKILL.md | @.claude/skills/vibe-coding/SKILL.md

Commands

Structure: Single .md with description frontmatter

Required: description with action verbs + scenarios

Examples: @.claude/commands/00_plan.md | @.claude/commands/02_execute.md

Agents

Required: name, description, model, tools

Examples: @.claude/agents/coder.md | @.claude/agents/plan-reviewer.md

Rules

Structure: core/, delegator/, documentation/

Examples: @.claude/rules/core/workflow.md | @.claude/rules/delegator/triggers.md

VIBE Coding Standards

| Target | Limit | |--------|-------| | Function | ≤50 lines | | File | ≤200 lines | | Nesting | ≤3 levels |

Principles: SRP, DRY, KISS, Early Return

Full: @.claude/skills/vibe-coding/SKILL.md

Cross-References

Format: @.claude/{path}/{file}

Best: Absolute paths, specific files, descriptive text

Frontmatter Patterns

Skill: name, description (trigger keywords) Command: description (action verbs + scenarios) Agent: name, description, model, tools

Common Patterns

Methodology extraction:

> **Methodology**: @.claude/skills/tdd/SKILL.md

MANDATORY marker:

> **⚠️ MANDATORY ACTION**: YOU MUST {action} NOW

Completion markers: <AGENT_COMPLETE>, <AGENT_BLOCKED>

claude-pilot-standards