Addy Osmani documentation and ADRs

Workflow

Addy Osmani’s documentation skill records architecture choices, public API changes and operational context so future maintainers can understand the reasoning behind the code.

Run this command in your project after reviewing the instructions and access terms. Install complete upstream directories to keep referenced rules and scripts.

npx skills add https://github.com/addyosmani/agent-skills/tree/aeac41d4d005999432bb7312f7ff06383a91d59d/skills/documentation-and-adrs --skill documentation-and-adrs --agent claude-code

Project file: .claude/skills/documentation-and-adrs/SKILL.md

This brief helps you choose the skill. Read the complete upstream SKILL.md and companion files for its actual instructions.

# Addy Osmani documentation and ADRs (addy-osmani-documentation-adrs)
Addy Osmani’s documentation skill records architecture choices, public API changes and operational context so future maintainers can understand the reasoning behind the code.

## Use when
- Record an architectural choice or document a changed public interface.

## Required inputs
- Decision and relevant implementation
- Alternatives, constraints and existing documentation

## Prerequisites
- Accurate project facts and access to the documentation location.
- Use the repository’s existing documentation format and ownership conventions.

## Expected outputs
- Decision record or updated documentation
- Clear context, consequences and references

Source: https://github.com/addyosmani/agent-skills/blob/aeac41d4d005999432bb7312f7ff06383a91d59d/skills/documentation-and-adrs/SKILL.md
Full SKILL.md: https://agenttaste.dev/skills/addy-osmani-documentation-adrs/SKILL.md

## Popularity evidence
- 108,660 GitHub repo stars — addyosmani/agent-skills; checked 2026-10-20. Source: https://github.com/addyosmani/agent-skills/stargazers
- 58,973 skill installs (all time) — addyosmani/agent-skills / documentation-and-adrs · skills.sh · all time; checked 2026-10-20. Source: https://skills.sh/addyosmani/agent-skills/documentation-and-adrs
Adoption counts are not user ratings or guarantees of quality.