Skip to main content
skill CX Codex

adr — Claude Code skill: what it does, how to install

Guides creation and review of Architecture Decision Records using MADR templates and Olaf Zimmermann's criteria.

no license 146 installs ★ 54 updated 2026-02-26

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ncklrs/startup-os-skills --skill adr -a claude-code
Open on GitHub

What adr does

This skill guides teams through the entire lifecycle of Architecture Decision Records (ADRs). It checks decision readiness against the START framework, drafts documents using MADR structure, and detects 11 common writing anti-patterns. Acceptance relies on the ECADR criteria to ensure evidence and review plans exist before marking decisions as final.

Interaction runs through explicit flags: create walks through questions step-by-step, review audits existing files, check-ready and check-done validate stage criteria, while template outputs clean Markdown. If a decision lacks high business impact or cross-component effects, the built-in significance test flags it early so you avoid documenting routine technical tasks.

What it helps with

  • draft structured decision records using MADR markdown format
  • verify decision readiness against five START checklist points
  • audit existing ADR files for structural anti-patterns
  • determine architectural significance before writing documentation

Example prompts for the agent

  • Run adr check-ready to see if we have enough context to choose our database
  • Output a blank decision layout using adr template
  • Audit docs/adr/0002-auth.md with adr review

How to install adr

1Skills CLI (Vercel)

npx skills add ncklrs/startup-os-skills --skill adr -a claude-code

2Manually: put the files in place

~/.claude/skills/adr/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/adr/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about adr

How to install adr in Claude Code?

Run npx skills add ncklrs/startup-os-skills --skill adr -a claude-code. The definition gets placed into ~/.claude/skills/adr/SKILL.md.

What does the adr skill do?

It assists developers in drafting, evaluating, and cataloging architectural choices. It provides structured MADR formats and tests decisions against research-backed quality criteria.

What does the ECADR criteria check?

ECADR serves as a definition of done: it verifies evidence, comparative criteria for options, stakeholder consensus, shared documentation, and an active review plan.

Similar skills

All skills for Writing and docs →

From the same set51

The whole set →
competitive-strategist The competitive-strategist skill supports competitor research, win/loss analysis, battlecards, market maps, and positioning work for B2B/SaaS teams. CX Codex +1 163installs account-executive account-executive guides enterprise B2B SaaS sales strategy, deal qualification with MEDDPICC, buying committee mapping, and pipeline planning. CX Codex +1 162installs customer-health-analyst customer-health-analyst guides customer health scoring, churn prediction models, and product retention analytics. CX Codex +1 159installs renewal-manager renewal-manager gives the agent a renewal playbook for subscription accounts: pipeline forecasts, churn risk, pricing and expansion talks. CX Codex +1 152installs qbr-facilitator qbr-facilitator turns a quarterly review with a customer into a working session: timed agenda, the value story in money and hours, and commitments that survive the meeting. CX Codex +1 151installs cs-strategist cs-strategist — a planning skill for Customer Success teams: segment accounts, set outcome metrics, build playbooks, and map the customer journey. CX Codex +1 150installs logging-best-practices logging-best-practices guides AI coding agents to implement wide request events, structured records, and tail sampling instead of scattered debug strings. CX Codex +1 148installs partnership-marketer partnership-marketer — a skill that walks your agent through partner marketing: picking partners, shaping a tiered program, sizing a joint campaign budget. CX Codex +1 148installs

Project sponsors

Companies that keep this analytics open