Topic · Development

Best architecture decision records skills for Claude Code, Codex and other agents.

Skills that capture design decisions and their trade-offs as architecture decision records and design docs.
skills
562
official
19

Architecture decision records skills, ranked

Ranked by score. Sort bymost stars,trending,newest,recently updated

Architecture decision records skills, ranked
#SkillRepositoryStarsUsed inTokensAuto-checkLicenceUpdated
1

For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

OpenHands/OpenHands90k—~2.4kAutomated safety check: PassMITtoday
2

Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

Ibrahim-3d/orchestrator-supaconductor3804 repos~2.4kAutomated safety check: PassMIT9 days ago
3

Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.

ywwynm/EverythingDone14415 repos~1.3kAutomated safety check: PassGPL-3.023 days ago
4

Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk.

brim-borium/spotify_sdk1665 repos~806Automated safety check: PassApache-2.0today
5

Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.

SpillwaveSolutions/design-doc-mermaid1751 repo~5.6kAutomated safety check: PassNo licence1 mo ago
6

Facilitates deliberate skill development during AI-assisted coding.

DrCatHicks/learning-opportunities2.5k—~2.5kAutomated safety check: PassCC-BY-4.01 mo ago
7

Records decisions and documentation. An agent skill from dzhalaevd/Donatello.

dzhalaevd/Donatello1358 repos~2.4kAutomated safety check: NotesApache-2.03 days ago
8

Check a code change against the repo's Accepted Architecture Decision Records (ADRs) in handbook/engineering/decisions/ and report violations with citations.

polarsource/polar10k—~771Automated safety check: PassMITtoday
9

Guides feature work in the Mistral Vibe Python CLI so each change lands in the right module and matches the project's architecture decision records.

mistralai/mistral-vibe5.1k—~1.2kAutomated safety check: PassApache-2.0yesterday
10

撰写机构级个股投资研究报告(二级市场深度研究)。Use whenever the user wants to research, analyze, or value a specific publicly-traded stock — e.g.

rollingSirius/equity-research-skill452—~1.5kAutomated safety check: PassMIT1 mo ago
11

Plan Mode の <proposedplan を出す直前に、計画の段階・依存関係・検証観点を一時HTMLで視覚確認したい時に使う agent-internal skill。Use this agent-internal skill to create a temporary HTML preview for a plan just before presenting…

u-ichi/reviewable-html-workbench2981 repo~1.8kAutomated safety check: PassMIT27 days ago
12

Guides a three-stage workflow for turning partial context into a clear PRD, RFC or design doc: capture context, draft section by section, then test with a fresh reader.

shareAI-lab/Kode-CLI5.2k—~977Automated safety check: PassApache-2.01 mo ago
13

Review a change to the ffmpeg-skill repository for the failures its own contract makes possible — a claim in a result document that is true at one layer and false at the layer a caller reads, a new…

kajisho5/ffmpeg-skill1.9k—~2.3kAutomated safety check: PassMIT2 days ago
14

Define and maintain machine-readable research project state for multi-stage computational chemistry work.

JCLiuGroup/AI-Computational-Chemist1431 repo~1.8kAutomated safety check: PassUnknown9 days ago
15

Spec-driven workflow for non-trivial work. An agent skill from ikarenkov/Modo.

ikarenkov/Modo343—~2.4kAutomated safety check: PassNo licence3 mo ago
16

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

egma-ai/egma14432 repos~135Automated safety check: PassUnknown7 days ago
17
17.Docs

Author and edit PiFinder's user-facing documentation in the project's house style.

brickbots/PiFinder250—~6.2kAutomated safety check: PassGPL-3.0today
18

Run an ASSERT evaluation against a described risk. An agent skill from responsibleai/ASSERT.

responsibleai/ASSERT327—~11kAutomated safety check: NotesMITtoday
19

要求・設計・アーキテクチャ・未決事項を整理し、レビュー可能な設計資料HTMLを作りたい時に使う。Use this skill to structure requirements, design, architecture, alternatives, decisions, and unresolved issues into a review-ready HTML design document.

u-ichi/reviewable-html-workbench2981 repo~8.6kAutomated safety check: PassMIT27 days ago
20

A skill your agent uses to create or maintain Cabloy suite specifications under repo-specs, including PRD, SRS, PDP/WBS, acceptance planning, progress, and suite ADRs.

cabloy/cabloy982—~3.2kAutomated safety check: NotesMITtoday
21

Reverse engineer a detailed product and technical specification document from a git branch's implementation.

blader/schematic239—~2.2kAutomated safety check: PassMIT6 mo ago
22

Facilitates evidence-aware scientific ideation with independent generation, structured discussion, explicit assumptions, transparent evaluation, adversarial review, and decision logs.

Oleafly/Oleafly2052 repos~3.5kAutomated safety check: PassMITtoday
23

Converts grill-with-docs output — CONTEXT.md glossaries, ADRs, and approved domain decisions — into typed architecture.

modernweb-dev/rocket395—~1.1kAutomated safety check: PassMIT8 days ago
24

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.

meain/dotfiles28521 repos~875Automated safety check: PassMIT1 mo ago
25

Write well-formatted notes to the atmosphere-vault Obsidian knowledge base.

Atmosphere/atmosphere3.8k—~2.6kAutomated safety check: PassApache-2.0yesterday
26

Solutioning skill (Winston, the Architect). An agent skill from aj-geddes/claude-code-bmad-skills.

aj-geddes/claude-code-bmad-skills487—~1.9kAutomated safety check: NotesUnknown3 mo ago
27

A skill your agent uses when running the full idea workflow: capture a rough idea, expand it into design/UI/implementation docs, research similar products, and generate build-ready Markdown artifacts.

AkoliteZA/hermes-agent-idea-workflow270—~3.9kAutomated safety check: PassMIT5 mo ago
28

Sweep completed plan files (tasks Status:done, specs Status:shipped, PRDs Status:superseded, ADRs Status:superseded or deprecated) out of the working tree and into git history via git rm.

alexandremendoncaalvaro/CorridorKey-Runtime7551 repo~1.6kAutomated safety check: PassUnknown2 mo ago
29

Persists a durable Arroxy lesson — a gotcha, user preference, workflow rule, or design decision — to the right tracked file (project memory, AGENTS.md, CONTEXT.md, dev-docs, or an ADR) so any coding…

antonio-orionus/Arroxy389—~571Automated safety check: PassMIT2 days ago
30

Create, update, review, and execute manual Markdown implementation plans when harness planning mode is not being used.

fjrevoredo/mini-diarium308—~3.7kAutomated safety check: PassMIT2 days ago
31

A skill your agent uses when the user wants to analyze a listed company, stock, business, or investment target; challenge or revise an existing company report; compare A/H or primary-listing/ADR…

zhu1090093659/dsh-trading230—~4.2kAutomated safety check: PassUnknown4 days ago
32

Writes, repairs and copyedits project docs against the Google developer documentation style guide, verifying claims in the repository before stating them.

bgauryy/octocode946—~2kAutomated safety check: PassMIT3 days ago
33

Universal UI/UX design principles covering visual hierarchy, interaction laws, typography foundations, and WCAG accessibility requirements.

bergside/typeui2k—~861Automated safety check: PassMIT3 mo ago
34

Lightweight standalone design spec for AI coding agents: codebase scan → bounded clarify pass (3–5 questions, not a grill) → reviewed design doc written to docs/plans/ → independent scored review →…

maddhruv/absolute2181 repo~2.3kAutomated safety check: PassMIT3 mo ago
35

Deliberate-choice procedure for a medium-to-high-stakes engineering fork — when the first plausible solution (the instinct, the default next-token pull) would be costly to get wrong.

syahiidkamil/Software-Engineer-AI-Agent-Atlas397—~3.4kAutomated safety check: PassNo licence3 mo ago
36

Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components.

adobe/spectrum-design-data155—~868Automated safety check: PassApache-2.04 days ago
37

Maintain bounded, durable AI project memory in a repository's docs/ai/ pack.

tudoumashu/ai-memory-skillpack411—~1.1kAutomated safety check: PassMIT29 days ago
38

Orchestrates multi-agent task execution using a Royal Navy squadron metaphor — from mission planning through parallel work coordination to stand-down.

Aspegio/nelson421—~11kAutomated safety check: WarnMIT3 mo ago
39
39.Write Vibe ADROfficial

Creates or updates concise Architecture Decision Records for the Mistral Vibe CLI and registers each one in the AGENTS.md decisions table.

mistralai/mistral-vibe5.1k—~942Automated safety check: PassApache-2.0yesterday
40

Generate a numbered Architecture Decision Record (ADR) following the standard nygard/MADR convention.

skrun-dev/skrun210—~861Automated safety check: PassMIT14 days ago
41

Audit a finished design document for hard-to-read or hard-to-understand paragraphs, then harden the house-style rules so future design docs avoid them.

JetBrains/youtrackdb437—~2.3kAutomated safety check: PassApache-2.0today
42

A skill your agent uses when drafting or revising internal technical design docs, review notes, architecture writeups, or sharing posts in Chinese, especially when the tone should stay…

luoling8192/technical-writing216—~2.2kAutomated safety check: PassMIT4 mo ago
43

A skill your agent uses when about to propose, brainstorm, review or revise a design, fix approach or plan for a feature or behaviour change in this repo, including "brief" or "quick" design…

andrew-blake/melcloudhome142—~1.1kAutomated safety check: PassMIT2 days ago
44

When you have a decision to make and want a structured workflow that picks the load-bearing questions, walks through them, reaches a call (or "wait"), and archives the rationale for future reference.

coreyhaines31/makerskills844—~1.9kAutomated safety check: PassMIT1 mo ago
45

Before answering any technical question, code request, architecture decision, or factual claim, call searchknowledge to check the local corpus.

lyonzin/knowledge-rag290—~1.4kAutomated safety check: PassMIT3 days ago
46

Writes every KEEP/CUT/DEFER/PIVOT scope decision into an append-only team log with rationale, author, and timestamp.

MAGA2010/hackathon-run349—~847Automated safety check: PassMIT3 days ago
47

Route implementation, design, review, diagnosis, and testing work on the Moon CLI and MoonBuild to canonical glossary, ADR, design, behavioral-reference, and testing documents.

moonbitlang/moon423—~1.1kAutomated safety check: PassApache-2.07 days ago
48

Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records…

bybren-llc/safe-agentic-workflow421—~1.2kAutomated safety check: PassMIT2 mo ago

Questions, answered from the data.

What is the best architecture decision records skill?

PR Design Doc from OpenHands/OpenHands ranks first of the 562 architecture decision records skills listed here, with the highest score: its repository has 90k GitHub stars, its SKILL.md loads about 2.4k tokens and it passes the automated safety check with no findings. Next come Cto Advisor and Improve Codebase Architecture.

Which architecture decision records skills are official?

19 of the 562 architecture decision records skills are official, published by the vendor's own GitHub organization: Create Vibe Feature, Write Vibe ADR, Readability Feedback, Review GitHub PR, Adk Style and 14 more.

How are these skills ranked?

By Skill Navigator score, which combines the GitHub stars of the skill's repository (shared across that repo's skills and discounted for large collections), how many other GitHub owners carry a copy of the skill, and automated SKILL.md quality checks, minus penalties for safety-check warnings and for each further skill from the same repository. Skills that fail the safety check are not listed.