Documentation & ADRs
Recording architectural decisions so the reasoning survives the people who made it.
Installation
$ npx skills add addyosmani/agent-skillsThe CLI's unit is the repository, so this installs everything in addyosmani/agent-skills, not documentation-and-adrs alone. It writes into whichever agent directories it finds — Claude Code, Codex, Cursor, Copilot, Windsurf, Zed.
Summary
Recording architectural decisions so the reasoning survives the people who made it.
- Reach for it when a decision that will look arbitrary in a year unless the alternatives are written down now.
- Spans Design & architect and Operate & maintain, so it is usually worth loading for the whole piece of work rather than at one moment in it.
- Stack-agnostic — nothing in it assumes a particular language or framework.
- Published by Addy Osmani. Well regarded, but not the vendor of the thing it covers.
- Installing pulls the whole addyosmani/agent-skills repository: this catalogue lists 19 other entries from it, and the repo may hold more.
Where it sits in delivery
Design & architectInterfaces, module boundaries and domain language — decided before the code sets them in concrete.Everything in Design →
Operate & maintainProduction reality: debugging, performance, instrumentation, and writing down why the system is the way it is.Everything in Operate →
The skill itself
The full text lives with its publisher and changes when they change it. Read it there rather than here — a mirrored copy of somebody else's procedure goes stale silently, and this page would have no way of telling you.
Related
More in Design & architect
- Diagramming codeProduces accurate architecture and data-flow diagrams from the code that exists, not the code somebody described.
trailofbits/skills - Analyzing .NET performanceTraces, dumps and allocation analysis, from the team that builds the runtime.
dotnet/skills - Frontend designAnthropic's guidance for producing interfaces that look designed rather than defaulted.
anthropics/skills - Vercel optimizeFinding and fixing what is slow or expensive in a Vercel-hosted app.
vercel-labs/agent-skills - Web design guidelinesVercel's design rules for agent-generated web interfaces: layout, spacing, typography, motion, state.
vercel-labs/agent-skills - Web performanceCloudflare's view of web performance — caching, edge behaviour and delivery.
cloudflare/skills