Writing Skills

Overview

A skill should capture reusable judgment, not a story about one session.

Core principle: Write the minimum instructions that reliably change future agent behavior on the right class of tasks.

Directory Choice

Choose the source of truth before editing:

• Shared skill source: edit the repo-managed Claude skill, not the generated runtime copy
• Codex-only adaptation: edit the repo-managed Codex override, not the generated runtime copy

In this dotfiles setup, those live under:

• claude-code/.claude/skills/<skill-name>/
• claude-code/codex-overrides/skills/<skill-name>/