claude-pilot-standards

name	claude-pilot-standards
description	Author reference for claude-pilot components. Skills, commands, agents, rules documentation patterns. VIBE coding compliance.

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>

Further Reading

Internal: @.claude/skills/claude-pilot-standards/REFERENCE.md | @.claude/skills/claude-pilot-standards/TEMPLATES.md | @.claude/skills/claude-pilot-standards/EXAMPLES.md

External: Claude Code Best Practices