Documentation and ADRs

by addyosmani

Documentation and ADRs is a Writing skill for Claude Code, published by addyosmani in agent-skills.

86.7K stars9.3K forkson addyosmani/agent-skillsAdded 2026/08/13Repository updated 2026/08/11

View source on GitHub Download repo ZIP

agent-skillsantigravityclaude-codecodexcursorskills

Install in seconds

Install Documentation and ADRs

Copy Documentation and ADRs into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/addyosmani/agent-skills/tree/main/skills/documentation-and-adrs ~/.claude/skills/documentation-and-adrs

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/addyosmani/agent-skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/documentation-and-adrs/SKILL.md in addyosmani/agent-skills
Installs to: ~/.claude/skills/documentation-and-adrs
Collection: One of 24 skills cataloged from this repository
Category: Writing — 1012 skills

What Documentation and ADRs does

Documentation and ADRs records architectural decisions and writes documentation explaining why code was built a certain way. Use when making architectural decisions, changing public APIs, shipping features, or recording context for future engineers and agents.

Documentation and ADRs is cataloged under Writing on DirSkills. Documentation and ADRs comes from a repository tagged agent-skills, antigravity, claude-code, codex and cursor.

Documentation

README

Excerpt

Documentation and ADRs

Overview

Document decisions, not just code. The most valuable documentation captures the why — the context, constraints, and trade-offs that led to a decision. Code shows what was built; documentation explains why it was built this way and what alternatives were considered. This context is essential for future humans and agents working in the codebase.

When to Use

Making a significant architectural decision
Choosing between competing approaches
Adding or changing a public API
Shipping a feature that changes user-facing behavior
Onboarding new team members (or agents) to the project
When you find yourself explaining the same thing repeatedly

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Documentation and ADRs

What else does addyosmani publish alongside Documentation and ADRs?
Documentation and ADRs is one of 24 skills that DirSkills catalogs from addyosmani/agent-skills, the repository it ships in. Its siblings there include API and Interface Design, Agent Skill Discovery and Browser Testing. Each one is a separate skill with its own page in this directory, installs the same way Documentation and ADRs does, and is maintained by addyosmani in that same repository. The rest of the collection is listed on the addyosmani/agent-skills page.
How does Documentation and ADRs compare to other Writing skills?
Documentation and ADRs ranks #12 by stars among the 1012 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Documentation and ADRs against them. Open each page to compare what they document and how they install.