Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.
8.1
Rating
0
Installs
Documentation
Category
Excellent comprehensive skill for ADR documentation. The description clearly conveys when to use the skill, and the single SKILL.md file is well-structured with multiple templates, decision tables, lifecycle diagrams, directory structures, automation commands, review checklists, and best practices. Provides substantial task knowledge including 5 different ADR templates (MADR, lightweight, Y-statement, deprecation, RFC), management workflows, and tooling integration. Structure is logical with clear sections, though at this length it could benefit from splitting into separate template files. Novelty is good - while ADRs are a known practice, the comprehensive guidance, multiple formats, and process integration would save significant tokens and provide structure a CLI agent would struggle to synthesize consistently. Minor improvement areas: could reference external template files for the 5 formats to reduce main file length, and add more automation examples.
wshobson
Skill Author
Loading SKILL.md…
