Documentation And Adrs
Documentation And Adrs is an agent skill (a SKILL.md file) from addyosmani/agent-skills. Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice… It works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode and has 110,586 GitHub stars across a repository of 13 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. 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. Document decisions, not just code. The most valuable documentation captures the why — the context, constraints, and trade-offs that led to a decision.
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, or when you need to record context that future engineers and agents will need to understand
More skills in addyosmani/agent-skills
13 skills are listed from this repository.
Code Review And Qualityaddyosmani/agent-skills
Similar skills
More docs & writing skills
Open Source
browser-use/browser-use
Documentation reference for writing Python code using the browser-use open-source library.
Active · last commit Oct 22, 2026
OfficialDocs & writingPythonDoc Maintenance
paperclipai/paperclip
Keep project docs aligned with recent code and feature changes — detect drift, update affected pages, and add release-relevant notes without rewriting unchanged sections.
Active · last commit Oct 26, 2026
Docs & writingTypeScriptPonytail
DietrichGebert/ponytail
Lazy senior dev mode: the smallest change that fully solves the task, and a reply a busy human understands in one read.
Active · last commit Oct 18, 2026
Docs & writingJavaScriptClinical Case Report
nexu-io/open-design
Structured medical case presentation for clinical rounds, conferences, and documentation.
Active · last commit Oct 26, 2026
Docs & writingTypeScriptWriting Beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
Active · last commit Oct 19, 2026
Docs & writingShellWriting Skills
obra/superpowers
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
Active · last commit Oct 21, 2026
Docs & writingShell
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 Oct 13, 2026. Its latest release is 0.6.13. appsgit only lists skills from repositories with a commit in the last six months.