Skip to content
appsgit

Architecture Decision Records

Architecture Decision Records is an agent skill (a SKILL.md file) from wshobson/agents. Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. It works with Claude Code, Codex, Cursor, GitHub Copilot and OpenCode and has 42,566 GitHub stars across a repository of 6 listed skills.

github.com/wshobson/agents/plugins/documentation-generation/skills/architecture-decision-records (opens in a new tab)

Data as of from the GitHub API and skills.sh; description from the skill's SKILL.md. Report an error

Add this skill

Claude

This repository is a Claude Code plugin marketplace. In Claude Code:

/plugin marketplace add wshobson/agents
/plugin install documentation-generation@claude-code-workflows

In the Claude apps, zip the architecture-decision-records folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

ChatGPT / Codex

Codex reads skills from .agents/skills/ in a repo or ~/.agents/skills/ for every project:

git clone --depth 1 https://github.com/wshobson/agents.git
cp -r agents/plugins/documentation-generation/skills/architecture-decision-records .agents/skills/architecture-decision-records   # repo; ~/.agents/skills for all projects

Standalone skills also load in the ChatGPT desktop app.

Cursor

Cursor loads skills from .cursor/skills/ (or ~/.cursor/skills/) and also reads .claude/skills/:

git clone --depth 1 https://github.com/wshobson/agents.git
cp -r agents/plugins/documentation-generation/skills/architecture-decision-records .cursor/skills/architecture-decision-records   # project; ~/.cursor/skills for all projects

Source (checked Oct 7, 2026): code.claude.com/docs/en/skills (opens in a new tab), code.claude.com/docs/en/plugin-marketplaces (opens in a new tab), support.claude.com/en/articles/12512180-using-skills-in-claude (opens in a new tab), learn.chatgpt.com/docs/build-skills (opens in a new tab), cursor.com/docs/context/skills (opens in a new tab)

What this skill does

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes. Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.

When it triggers

  • Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

More skills in wshobson/agents

6 skills are listed from this repository.

Similar skills

More docs & writing skills

All Docs & writing

FAQ

Architecture Decision Records FAQ

Still curious? Email info@appsgit.com.

How do I install the Architecture Decision Records skill?

In Claude Code, run /plugin marketplace add wshobson/agents and then /plugin install documentation-generation@claude-code-workflows. For Codex or Cursor, copy the architecture-decision-records folder into .agents/skills/ or .cursor/skills/.

Is the Architecture Decision Records skill free?

Yes. The repository is open source under the MIT license.

Is Architecture Decision Records maintained?

The repository's most recent commit was on Nov 8, 2026. appsgit only lists skills from repositories with a commit in the last six months.