documentation-and-adrs

An agent skill by addyosmani, from addyosmani/agent-skills. Tags: api, developer-tools, documents.

What it 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.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add addyosmani/agent-skills --skill documentation-and-adrs

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/addyosmani/agent-skills
cp -r agent-skills/skills/documentation-and-adrs ~/.claude/skills/documentation-and-adrs

Safety box score

Not rated yet. A safety box score grades what a skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. Anyone can request one from this page; it is saved for everyone. How the score works.

Source

Repository

addyosmani/agent-skills (all skills from this repository)

Path

skills/documentation-and-adrs/SKILL.md

Branch

main

Updated

2026-09-19

Related skills

• deprecation-and-migration — Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another.
• source-driven-development — Grounds every implementation decision in official documentation.
• code-documenter — Generates, formats, and validates technical documentation — including docstrings, OpenAPI/Swagger specs, JSDoc annotations, doc portals, and user guides.
• intended-vs-implemented — The method for finding the gap between what a system is supposed to do and what the code actually does — the class of bug generic scanners miss because they.
• shipping-artifacts — The durable documentation set that makes an AI-built (vibe-coded) app reviewable before shipping.
• writing-skills — Use when creating new skills, editing existing skills, or verifying skills work before deployment