This is the generic copy. If this project has been scaffolded, prefer the unprefixed
decision-recordskill: it is.ai-badger/skills/decision-record/SKILL.md, and it has this project's extensions and anyproject-local.mdmerged in. This copy has neither.The full procedure is in
SKILL.full.mdbeside this file, unchanged — read it if the project has no.ai-badger/, or runwelcome-ai-badgerto scaffold one.
Decision Record
Use when a change adds a feature or meaningfully changes how something works and the decision behind it has to be written down before implementation — "record this decision", "write an ADR", "open a spec change", "decision record", or the task skill's decision-record step. Detects what the project already uses (an ADR log in MADR, adr-tools or log4brains shape; OpenSpec, Spec Kit or Kiro specs; the CLIs on PATH), writes into that format, and writes a linked ADR-plus-spec pair when the project keeps both.
Decision Record by Arasz · b2c5afa
npx get-skill add arasz/decision-record File contents
---name: decision-recorddescription: >- Use when a change adds a feature or meaningfully changes how something works and the decision behind it has to be written down before implementation — "record this decision", "write an ADR", "open a spec change", "decision record", or the task skill's decision-record step. Detects what the project already uses (an ADR log in MADR, adr-tools or log4brains shape; OpenSpec, Spec Kit or Kiro specs; the CLIs on PATH), writes into that format, and writes a linked ADR-plus-spec pair when the project keeps both.version: 1.0.0author: ai-badgerlicense: MITplatforms: [linux, macos, windows]scope: defaultmetadata: source: https://skillmd.com/skills/arasz/decision-record hermes: tags: [adr, decisions, specification, openspec, documentation] related_skills: [task, create-task-spec, evidence-first-research]---> **This is the generic copy.** If this project has been scaffolded, prefer the unprefixed> `decision-record` skill: it is `.ai-badger/skills/decision-record/SKILL.md`, and it has this project's> extensions and any `project-local.md` merged in. This copy has neither.>> The full procedure is in `SKILL.full.md` beside this file, unchanged — read it if the project has no> `.ai-badger/`, or run `welcome-ai-badger` to scaffold one.
arasz/ai-badger commit b2c5afab07
Frequently asked questions
Run npx get-skill add arasz/decision-record in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Use when a change adds a feature or meaningfully changes how something works and the decision behind it has to be written down before implementation — "record this decision", "write an ADR", "open a spec change", "decision record", or the task skill's decision-record step. Detects what the project already uses (an ADR log in MADR, adr-tools or log4brains shape; OpenSpec, Spec Kit or Kiro specs; the CLIs on PATH), writes into that format, and writes a linked ADR-plus-spec pair when the project keeps both. It is listed under Productivity on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.
Arasz (@arasz) published this skill. Their other Agent Skills are listed on their SkillMD profile.