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 102,166 GitHub stars across a repository of 13 listed skills.
github.com/addyosmani/agent-skills/skills/documentation-and-adrs (opens in a new tab)
- Multi-skill repo
- Plugin marketplace
- Docs & writing
- Actively maintained
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
Writing Plans
obra/superpowers
Use when you have a spec or requirements for a multi-step task, before touching code.
Docs & writingShellWriting Skills
obra/superpowers
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
Docs & writingShellWriting Beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
Docs & writingShellWriting Shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
Docs & writingShellKarpathy Guidelines
multica-ai/andrej-karpathy-skills
Behavioral guidelines to reduce common LLM coding mistakes.
Docs & writingDocument Generate
garrytan/gstack
Generate missing documentation from scratch for a feature, module, or entire project.
Docs & writingTypeScript
What is the Documentation And Adrs skill?
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 102,166 GitHub stars across a repository of 13 listed skills. Its SKILL.md lives at github.com/addyosmani/agent-skills/skills/documentation-and-adrs.
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 3, 2026. Its latest release is 0.6.12. appsgit only lists skills from repositories with a commit in the last six months.