Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.
documentation-and-adrs
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 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 co…”. The project has 82k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add addyosmani/agent-skills`.
Installation
Add documentation-and-adrs to your agent with:
/plugin marketplace add addyosmani/agent-skillsAlways review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.
When to use it
Reach for documentation-and-adrs when you want docs help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.
Strengths
- Clear MIT license — safe to read and adapt
- Ships in addyosmani/agent-skills, an established project with 82,220 GitHub stars
- Actively maintained (recent commits)
Topics
Frequently asked questions
- What does documentation-and-adrs do?
- 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.
- 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.
- Where does documentation-and-adrs come from?
- documentation-and-adrs ships inside addyosmani/agent-skills, a repository that contains 25 catalogued skills in total. The repository's 82,220 GitHub stars apply to that whole collection, not to this skill on its own.
Related skills
More Docs →
Automated Cherry Studio review for local branches, PRs, commits, files, architecture docs, and repository skills. Use for code or documentation reviews that need project-specific naming, main/renderer/shared placement and dependency rules, IpcApi and DataApi boundaries, lifecycle/service ownership, renderer hooks, React/UI conventions, and tests. Supports single-agent review with interactive fix selection or multi-agent reviewer-verifier review with risk-based auto-fix. To diagnose gaps in the skill after a review session, run `/gh-pr-review diag`.
This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation.
Agent skill that removes signs of AI-generated writing from text
Persistent project memory for AI coding agents. Structured scaffold + drift detection CLI.