# Documentation And Adrs (agent 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.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/addyosmani/agent-skills |
| Skill path | skills/documentation-and-adrs/SKILL.md |
| Skill name | documentation-and-adrs |
| GitHub stars | 102,166 |
| Installs on skills.sh | 853 |
| License | MIT |
| Skills in repo | 13 |
| Plugin marketplace | addy-agent-skills |
| Official | no |
| Works with | Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode |
| Category | Docs & writing |
| Last commit | Oct 3, 2026 |

## 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

## Add this skill

### Claude Code

```sh
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
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 projects
```

### Cursor

```sh
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 projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

skills.sh listing: https://www.skills.sh/addyosmani/agent-skills/documentation-and-adrs

---

Canonical page: https://appsgit.com/skills/addyosmani-documentation-and-adrs
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.