Decision records This skill owns the registry tool decisions.py , symlinked into the repo at scripts/decisions.py (run decisions.py install to set up the symlink + a CI check). The tool finds the repo's docs/ by walking up from the CWD, so run it from anywhere in the repo: python scripts/decisions.py build [ --relink ]

regenerate INDEX.md (+ refresh links)

python scripts/decisions.py check

validate (CI-safe; exit 1 if stale)

python scripts/decisions.py promote < name…

[ --deref ] [ --allow-replace ]

draft(s) -> accepted/

python scripts/decisions.py rename-draft-id < name

< NEW

re-ID a draft

python scripts/decisions.py install [ repo ]

adopt in a repo: symlink + pre-commit

Layout Everything the convention owns lives under docs/decisions/ : Show more Installs 761 Repository skymavis/skills First Seen Jun 29, 2026 Security Audits Gen Agent Trust Hub Pass Socket Pass Snyk Pass