Erk Skill Onboarding

Complete guide for adding a new skill to erk. Covers the decision tree, every file you need to touch, and which tests validate each registration.

Decision Tree

Answer three questions to determine which files to update:

1. Bundled or Unbundled?

• Bundled = distributed to external projects via erk init capability add <name>
• Unbundled = lives in .claude/skills/ but is only used within the erk repo itself

2. Codex Portable or Claude-Only?

• Codex Portable = works with any AI agent (no Claude-specific features like hooks, session logs, slash commands)
• Claude-Only = references Claude Code features (hooks, session logs, $ skill references, slash commands)

3. Required or Optional? (bundled only)