← All skills

decision-record

85 / 100 · Low risk

Fine to try.

By bmad-code-org/BMAD-METHOD (GitHub) · other · 55,255 stars · scanned at commit a867e16

Writes an architecture decision record (ADR). Use when the user says "record this decision", "write an ADR" or "we decided X, capture it".

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'decision-record' ] || [ -L ~/.agents/skills/'decision-record' ]; then echo 'A skill folder named decision-record already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/bmad-code-org/BMAD-METHOD' "$d" && git -C "$d" checkout --quiet 'a867e1604b365d48ea03cbd109da1066ba0c84bc' -- 'skills/bmad-toolsmith/shapes/plain-skill/assets/sample-skill' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/bmad-toolsmith/shapes/plain-skill/assets/sample-skill' ~/.agents/skills/'decision-record' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'decision-record' ~/.claude/skills/'decision-record' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for bmad-code-org/BMAD-METHOD shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/bmad-code-org/BMAD-METHOD.svg)](https://zalavijaysinh.github.io/skilltrust/repos/bmad-code-org/BMAD-METHOD/)

Score history