documentation-and-adrs
documentation-and-adrs is a Decision records & design docs skill for AI agents, published by addyosmani in the agent-skills repository on GitHub. Skillspace rates documentation-and-adrs D (60/100) and it passed the safety scan; a judge model has also reviewed it.
Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.
- Grade
- D
- Quality
- 60 / 100
- Safety
- Passed
- GitHub stars
- 79,566
Placed #2 of 6 in the judged category final for Decision records & design docs.
This rating describes the version of the repository we crawled; it may have changed since, so go by its current files.
Our review
- Architecture
- 86 / 100
- Maturity
- Basic: a single SKILL.md
- Security scan
- No issues found
- License
- MIT
- Adoption
- Adopted by 0 other repositories, in 1 collections
- Scope
- Portable: works in any project. General ADR and documentation practice for any codebase
Judge review
Placed #2 of 6 in the judged category final for Decision records & design docs.
- Trigger
88 88 - Instructions
82 82 - Specificity
90 90 - Safety
85 85 - Disclosure
72 72 - Maintenance
68 68
Strong convention-matching logic defers to an existing ADR scheme before applying its own, plus a fully worked example and concrete comment do/don'ts, though it broadens scope beyond ADRs into general commenting.
Not checked yet
- No blind task eval yet
- Sibling files (scripts, references) not fetched; security scan covers SKILL.md only
Skillspace indexes and rates this skill; it does not host or endorse it. Run third-party skills at your own risk.