Community · by addyosmani

Documentation and ADRs Claude skill

The Documentation and ADRs skill helps an AI assistant write architecture decision records and other project documentation that explains the reasoning behind choices.

MIT licence
★ 108,503 on GitHub (whole repository)
Verified against its source 19 Oct 2026

View SKILL.md Repository

What the Documentation and ADRs skill does

It helps the assistant document the why behind technical decisions, not just the code. It covers writing architecture decision records (ADRs) and checking the repository for an existing documentation convention before creating one. It is used when documenting an architecture decision or the reasoning behind a design choice.

What it covers

Matching existing ADR conventions in a repository before creating new ones
Maintaining changelog entries for shipped features

How to install it

In Claude Code

/plugin marketplace add addyosmani/agent-skills

/plugin install agent-skills@addy-agent-skills

This plugin also installs: api-and-interface-design, browser-testing-with-devtools, ci-cd-and-automation, code-review-and-quality, code-simplification, constraint-driven-development, context-engineering, debugging-and-error-recovery, deprecation-and-migration, doubt-driven-development, frontend-ui-engineering, git-workflow-and-versioning, idea-refine, incremental-implementation, interview-me, observability-and-instrumentation, performance-optimization, planning-and-task-breakdown, security-and-hardening, shipping-and-launch, source-driven-development, spec-driven-development, test-driven-development, using-agent-skills.

Steps change between versions. Check the official instructions before you install.