← All skills

decision-records

95 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By fvadicamo/dev-agent-skills (GitHub) · coding · 72 stars · scanned at commit 8e710c5

Creates, supersedes and validates decision records (ADRs) against the convention a collection already follows, instead of imposing a published one. Use when the user wants to record a decision, write an ADR, supersede an existing decision, audit or lint a decisions folder, check that an ADR index is in sync, or asks "why did we decide X". Deduces the filename scheme, section set and status vocabulary from the records already there; ships a validator with an exit code, so the audit is a check an…

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-records' ] || [ -L ~/.agents/skills/'decision-records' ]; then echo 'A skill folder named decision-records already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/fvadicamo/dev-agent-skills' "$d" && git -C "$d" checkout --quiet '8e710c57b4aa34fec63752ccf04a47adb4a8be65' -- 'plugins/decision-records/skills/decision-records' && mkdir -p ~/.agents/skills && cp -R "$d"/'plugins/decision-records/skills/decision-records' ~/.agents/skills/'decision-records' && 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-records' ~/.claude/skills/'decision-records' (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 fvadicamo/dev-agent-skills shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/fvadicamo/dev-agent-skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/fvadicamo/dev-agent-skills/)

Score history