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

Automated scan recorded

  • Automated scan: Checked 16 Nov 2026. Checks SKILL.md patterns and frontmatter; does not run the skill.
  • Source revision: 39b723ceebf8 (opens in a new tab). The install command targets this commit. Only SKILL.md was scanned.
  • Human reading: No full human-reading date recorded.
  • Runtime evidence: No runtime-test evidence recorded here.

A review is not a security audit or a guarantee.

Commands target the repository commits recorded with the automated scans. Scans cover only SKILL.md, not referenced files or runtime behavior. What the review covers.

Skills CLI

Skills CLI command
npx skills@latest add https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563 --skill documentation-and-adrs

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

Fieldbook review

Reviewed 16 Nov 2026

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

  • LicenceMIT
  • FrontmatterValid name and description
  • Risky patternsNone found
  • Size321 lines
  • Last checked16 Nov 2026 · a55e540b4544

What it can touch

  • Writes docs

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

Read the source

This link opens the exact SKILL.md scanned at the recorded repository commit. Read it and its referenced files before installing. The automated scan does not review those other files or run the skill.

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