Plan & designMIT

Documentation and ADRs

by Addy Osmani (opens in a new tab) addyosmani/agent-skills

Records architecture decisions and the reasoning future engineers and agents will need.

Installation

Skills CLI

Skills CLI command
npx skills@latest add addyosmani/agent-skills --skill documentation-and-adrs

Requires Node.js and npm. Choose your agents in the installer; add -g for a global installation.

Fieldbook review

Reviewed 27 Sept 2026

Matches your repo's existing ADR convention before introducing its own template.

  • LicenceMIT
  • FrontmatterValid name and description
  • Risky patternsNone found
  • Size289 lines
  • Last checked27 Sept 2026 · 87ae44a0c7bb3eefc2131a9d11caabcc14e4d8dcb27d66a3a675551ee2ce1671

What it can touch

  • Writes docs

    Creates or updates documents such as specs, plans or ADRs.

Read the source

Fieldbook links to the original instead of copying it, so you always read the version you install.

skills/documentation-and-adrs/SKILL.md on GitHub (opens in a new tab)