# Documentation And ADRs · Addy Osmani

Records decisions and documentation\.

Canonical: https://claudelist.com/listings/skill-addyosmani-agent-skills-documentation-and-adrs

Category: Skills

Source: community · Addy Osmani

Source checked: 2026-10-14

Website: https://github.com/addyosmani/agent-skills/tree/main/skills/documentation-and-adrs

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.

## Install or set up

1. Review this skill’s `SKILL.md` and any prerequisites at the source.
2. From the project where you use Claude Code, run the command below. It installs only this skill into project scope; add `-g` for your personal scope.
3. Restart Claude Code and invoke `/documentation-and-adrs` or ask Claude to use the skill. If it does not appear, check `.claude/skills/` and the source’s setup notes.

```sh
npx skills add https://github.com/addyosmani/agent-skills/tree/main/skills/documentation-and-adrs --agent claude-code
```

Installation guide: https://github.com/addyosmani/agent-skills/tree/main/skills/documentation-and-adrs