Claude Skills for decision records
A Claude Skill is a packaged set of
instructions an AI assistant loads for a particular kind of task. This project ships two,
living in skills/ alongside the guide, template, and examples they draw on.
decision-records-skill
For anyone writing a decision record
Walks a person through whether a choice needs a record, choosing the lightweight or comprehensive template, drafting the core fields, filing it, and the pre-publish checklist — pointing back at this repo’s guide, tutorial, and examples for depth.
decision-records-maintainer-skill
For maintainers of this repository
Covers this repo’s own conventions: the index.md / README.md symlink pattern, adding a new worked example, the root README’s versioned header, and known cross-reference gaps to check before closing related work.
Using a skill
- Clone the repo:
git clone https://github.com/decision-records/decision-records.git - Copy the skill folder you want into wherever your agent loads project skills from — for
Claude Code, that's typically
.claude/skills/<name>in your own project. - Ask your assistant to use it — e.g. "use decision-records-skill to help me write a decision record about …".
The skill files themselves reference the rest of this repo by relative path (its guide,
template, tutorial, examples, and checklist), so keep the skill folder inside a checkout
of this repo rather than copying SKILL.md alone.