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.
Data as of from the GitHub API and skills.sh; description from the skill's SKILL.md. Report an error
- Multi-skill repo
- Plugin marketplace
- Docs & writing
- Maintained
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-workflowsIn 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 projectsStandalone 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 projectsSource (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
Customer Inquiry Intake
anthropics/claude-plugins-official
Reads a customer RFQ in whatever shape it arrived — a PDF drawing package, a 40-line spreadsheet, a portal export, a phone photo of a marked-up print, or a forwarded thread where the real…
Maintained · last commit Nov 14, 2026
OfficialDocs & writingPythonNature Paper2word
Yuan1z0825/nature-skills
Compile an academic Markdown manuscript into a journal- or school-compliant Word (.docx): declared typography, native OMML equations, three-line tables, cross-references, per-section page numbers…
Maintained · last commit Nov 16, 2026
Docs & writingPython2slides Ppt Generator
sickn33/agentic-awesome-skills
AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style, summarize documents into decks, add AI voice narration, and export pages/audio.
Active · last commit Nov 15, 2026
Docs & writingPythonBook To Skill
virgiliojr94/book-to-skill
Converts books and documents (PDF, EPUB, DOCX, HTML, Markdown, plain text, RTF, MOBI/AZW with Calibre) into structured agent skills, extracting frameworks, mental models, principles, techniques, and…
Active · last commit Nov 3, 2026
Docs & writingPythonSimplified English
paperclipai/paperclip
Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the…
Active · last commit Nov 16, 2026
Docs & writingTypeScriptDefuddle
obsidianmd/obsidian-skills
Extract clean Markdown from HTML pages with Defuddle CLI.
Active · last commit Nov 11, 2026
Docs & writingShell
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.