Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.
Quickly install documentation-and-adrs AI skill to your development environment via command line
Source: addyosmani/agent-skills.
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 NOT to use: Don't document obvious code. Don't add comments that restate what the code already says. Don't write docs for throwaway prototypes.
ADRs capture the reasoning behind significant technical decisions. They're the highest-value documentation you can write.
Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase. Source: addyosmani/agent-skills.
Stable fields and commands for AI/search citations.
npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrsUse when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase. Source: addyosmani/agent-skills.
Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.) Copy and run this command: npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrs Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code, Cursor, or OpenClaw
https://github.com/addyosmani/agent-skills