Documentation And Adrs
Documentation And Adrs is an agent skill (a SKILL.md file) from addyosmani/agent-skills. Records decisions and documentation, and detects when documentation has drifted from the code it describes. It works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode and has 118,103 GitHub stars across a repository of 16 listed skills.
github.com/addyosmani/agent-skills/skills/documentation-and-adrs (opens in a new tab)
Data as of from the GitHub API and skills.sh; description from the skill's SKILL.md. Report an error
- Multi-skill repo
- Plugin marketplace
- Docs & writing
- Active
Add this skill
Claude
This repository is a Claude Code plugin marketplace. In Claude Code:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skillsIn the Claude apps, zip the documentation-and-adrs folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).
ChatGPT / Codex
Codex reads skills from .agents/skills/ in a repo or ~/.agents/skills/ for every project:
git clone --depth 1 https://github.com/addyosmani/agent-skills.git
cp -r agent-skills/skills/documentation-and-adrs .agents/skills/documentation-and-adrs # repo; ~/.agents/skills for all projectsStandalone skills also load in the ChatGPT desktop app.
Cursor
Cursor loads skills from .cursor/skills/ (or ~/.cursor/skills/) and also reads .claude/skills/:
git clone --depth 1 https://github.com/addyosmani/agent-skills.git
cp -r agent-skills/skills/documentation-and-adrs .cursor/skills/documentation-and-adrs # project; ~/.cursor/skills for all projectsSource (checked Oct 7, 2026): code.claude.com/docs/en/skills (opens in a new tab), code.claude.com/docs/en/plugin-marketplaces (opens in a new tab), support.claude.com/en/articles/12512180-using-skills-in-claude (opens in a new tab), learn.chatgpt.com/docs/build-skills (opens in a new tab), cursor.com/docs/context/skills (opens in a new tab)
What this skill does
Records decisions and documentation, and detects when documentation has drifted from the code it describes. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, when docs may be stale or out of sync with the code they describe, when working out which module docs are still accurate, or when setting up a check so docs cannot silently go out of date again. Document decisions, not just code.
When it triggers
- Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, when docs may be stale or out of sync with the code they describe, when working out which mo
More skills in addyosmani/agent-skills
16 skills are listed from this repository.
Code Review And Qualityaddyosmani/agent-skills
Security And Hardeningaddyosmani/agent-skills
Frontend UI Engineeringaddyosmani/agent-skills
Performance Optimizationaddyosmani/agent-skills
Spec Driven Developmentaddyosmani/agent-skills
Code Simplificationaddyosmani/agent-skills
API And Interface Designaddyosmani/agent-skills
Debugging And Error Recoveryaddyosmani/agent-skills
Test Driven Developmentaddyosmani/agent-skills
Context Engineeringaddyosmani/agent-skills
Incremental Implementationaddyosmani/agent-skills
Idea Refineaddyosmani/agent-skills
Similar skills
More docs & writing skills
Clinical Case Report
nexu-io/open-design
Structured medical case presentation for clinical rounds, conferences, and documentation.
Active · last commit Nov 16, 2026
Docs & writingTypeScriptCareer Ops
career-ops-hq/career-ops
Open-source AI job search agent -- evaluate offers, generate CVs, scan portals, track applications.
Active · last commit Nov 16, 2026
OfficialDocs & writingJavaScriptPDF
anthropics/skills
Use this skill whenever the user wants to do anything with PDF files.
Maintained · last commit Nov 14, 2026
OfficialDocs & writingPythonRelease Announcement
paperclipai/paperclip
Write a release announcement — changelog, blog post, in-app note, or social post — that leads with user impact, names the audience, and includes upgrade/migration steps without filler.
Active · last commit Nov 16, 2026
Docs & writingTypeScriptWriting Skills
obra/superpowers
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
Active · last commit Nov 3, 2026
Docs & writingShellPpt Master
hugohe3/ppt-master
AI-driven presentation workflow for generating editable PPTX decks and slides, reconstructing page visuals, creating reusable Brand/Style/Layout/Deck workspaces, filling native PPTX templates, and…
Active · last commit Nov 15, 2026
Docs & writingPython
How do I install the Documentation And Adrs skill?
In Claude Code, run /plugin marketplace add addyosmani/agent-skills and then /plugin install agent-skills@addy-agent-skills. For Codex or Cursor, copy the documentation-and-adrs folder into .agents/skills/ or .cursor/skills/.
Is the Documentation And Adrs skill free?
Yes. The repository is open source under the MIT license.
Is Documentation And Adrs maintained?
The repository's most recent commit was on Nov 14, 2026. Its latest release is 0.6.16. appsgit only lists skills from repositories with a commit in the last six months.