# Architecture Decision Records (agent skill)

> 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.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/wshobson/agents |
| Skill path | plugins/documentation-generation/skills/architecture-decision-records/SKILL.md |
| Skill name | architecture-decision-records |
| GitHub stars | 42,566 |
| Installs on skills.sh | 38 |
| License | MIT |
| Skills in repo | 6 |
| Plugin marketplace | claude-code-workflows |
| Official | no |
| Works with | Claude Code, Codex, Cursor, GitHub Copilot, OpenCode |
| Category | Docs & writing |
| Last commit | Nov 8, 2026 |

## When it triggers

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

## Add this skill

### Claude Code

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

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

### ChatGPT / Codex

```sh
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
```

### Cursor

```sh
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
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

skills.sh listing: https://www.skills.sh/wshobson/agents/architecture-decision-records

---

Canonical page: https://appsgit.com/skills/wshobson-architecture-decision-records
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
