Overview
documentation-and-adrs is an open-source docs skill for Claude Code and compatible agents, published by addyosmani. Its author describes it as: “Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record conte…”. The project has 98k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add addyosmani/agent-skills`.
What documentation-and-adrs does
Document decisions, not just code. The most valuable documentation captures the *why* — the context, constraints, and trade-offs that led to a decision. Code shows *what* was built; documentation explains *why it was built this way* and *what alternatives were considered*. This context is essential for future humans and agents working in the codebase.
Best for
What’s inside
The SKILL.md for documentation-and-adrs is organised into these sections:
- Overview
- When to Use
- Architecture Decision Records (ADRs)
- When to Write an ADR
- Match the existing convention first
- ADR Template
- ADR Lifecycle
- Inline Documentation
- When to Comment
- When NOT to Comment
- Document Known Gotchas
- API Documentation
Installation
Add documentation-and-adrs to your agent with:
/plugin marketplace add addyosmani/agent-skillsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- Antigravity — declared in the repository topics
License
documentation-and-adrs is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in addyosmani/agent-skills, an established project with 97,992 GitHub stars
- Works with Claude Code, Codex, Cursor, Antigravity
- Actively maintained — repository updated in the last 30 days
- Its repository gained 16,916 GitHub stars over the last 52 days
Author
Topics
Alternatives to documentation-and-adrs
Similar skills from other repositories:
Frequently asked questions
- What does documentation-and-adrs do?
- Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.
- How do I install documentation-and-adrs?
- Run /plugin marketplace add addyosmani/agent-skills in your agent, then reload your skills. Review the source at https://github.com/addyosmani/agent-skills before installing.
- Is documentation-and-adrs free to use?
- Yes. documentation-and-adrs is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does documentation-and-adrs work with?
- documentation-and-adrs lists Claude Code, Codex, Cursor, and Antigravity — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does documentation-and-adrs come from?
- documentation-and-adrs ships inside addyosmani/agent-skills, a repository that contains 26 catalogued skills in total. The repository's 97,992 GitHub stars apply to that whole collection, not to this skill on its own.
