Topic · Development
Best architecture decision records skills for Claude Code, Codex and other agents.
- skills
- 562
- official
- 19
Architecture decision records skills, ranked
Ranked by score. Sort bymost stars,trending,newest,recently updated
| # | Skill | Repository | Stars | Used in | Tokens | Auto-check | Licence | Updated |
|---|---|---|---|---|---|---|---|---|
| 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/ | 90k | — | ~2.4k | Automated safety check: Pass | MIT | today |
| 2 | Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. | Ibrahim-3d/ | 380 | 4 repos | ~2.4k | Automated safety check: Pass | MIT | 9 days ago |
| 3 | Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. | ywwynm/ | 144 | 15 repos | ~1.3k | Automated safety check: Pass | GPL-3.0 | 23 days ago |
| 4 | Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk. | brim-borium/ | 166 | 5 repos | ~806 | Automated safety check: Pass | Apache-2.0 | today |
| 5 | Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code. | SpillwaveSolutions/ | 175 | 1 repo | ~5.6k | Automated safety check: Pass | No licence | 1 mo ago |
| 6 | Facilitates deliberate skill development during AI-assisted coding. | DrCatHicks/ | 2.5k | — | ~2.5k | Automated safety check: Pass | CC-BY-4.0 | 1 mo ago |
| 7 | Records decisions and documentation. An agent skill from dzhalaevd/Donatello. | dzhalaevd/ | 135 | 8 repos | ~2.4k | Automated safety check: Notes | Apache-2.0 | 3 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/ | 10k | — | ~771 | Automated safety check: Pass | MIT | today |
| 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/ | 5.1k | — | ~1.2k | Automated safety check: Pass | Apache-2.0 | yesterday |
| 10 | 撰写机构级个股投资研究报告(二级市场深度研究)。Use whenever the user wants to research, analyze, or value a specific publicly-traded stock — e.g. | rollingSirius/ | 452 | — | ~1.5k | Automated safety check: Pass | MIT | 1 mo ago |
| 11 | 11.Plan Preview 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/ | 298 | 1 repo | ~1.8k | Automated safety check: Pass | MIT | 27 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/ | 5.2k | — | ~977 | Automated safety check: Pass | Apache-2.0 | 1 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/ | 1.9k | — | ~2.3k | Automated safety check: Pass | MIT | 2 days ago |
| 14 | Define and maintain machine-readable research project state for multi-stage computational chemistry work. | JCLiuGroup/ | 143 | 1 repo | ~1.8k | Automated safety check: Pass | Unknown | 9 days ago |
| 15 | Spec-driven workflow for non-trivial work. An agent skill from ikarenkov/Modo. | ikarenkov/ | 343 | — | ~2.4k | Automated safety check: Pass | No licence | 3 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/ | 144 | 32 repos | ~135 | Automated safety check: Pass | Unknown | 7 days ago |
| 17 | 17.Docs Author and edit PiFinder's user-facing documentation in the project's house style. | brickbots/ | 250 | — | ~6.2k | Automated safety check: Pass | GPL-3.0 | today |
| 18 | Run an ASSERT evaluation against a described risk. An agent skill from responsibleai/ASSERT. | responsibleai/ | 327 | — | ~11k | Automated safety check: Notes | MIT | today |
| 19 | 要求・設計・アーキテクチャ・未決事項を整理し、レビュー可能な設計資料HTMLを作りたい時に使う。Use this skill to structure requirements, design, architecture, alternatives, decisions, and unresolved issues into a review-ready HTML design document. | u-ichi/ | 298 | 1 repo | ~8.6k | Automated safety check: Pass | MIT | 27 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/ | 982 | — | ~3.2k | Automated safety check: Notes | MIT | today |
| 21 | 21.Schematic Reverse engineer a detailed product and technical specification document from a git branch's implementation. | blader/ | 239 | — | ~2.2k | Automated safety check: Pass | MIT | 6 mo ago |
| 22 | Facilitates evidence-aware scientific ideation with independent generation, structured discussion, explicit assumptions, transparent evaluation, adversarial review, and decision logs. | Oleafly/ | 205 | 2 repos | ~3.5k | Automated safety check: Pass | MIT | today |
| 23 | Converts grill-with-docs output — CONTEXT.md glossaries, ADRs, and approved domain decisions — into typed architecture. | modernweb-dev/ | 395 | — | ~1.1k | Automated safety check: Pass | MIT | 8 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/ | 285 | 21 repos | ~875 | Automated safety check: Pass | MIT | 1 mo ago |
| 25 | Write well-formatted notes to the atmosphere-vault Obsidian knowledge base. | Atmosphere/ | 3.8k | — | ~2.6k | Automated safety check: Pass | Apache-2.0 | yesterday |
| 26 | Solutioning skill (Winston, the Architect). An agent skill from aj-geddes/claude-code-bmad-skills. | aj-geddes/ | 487 | — | ~1.9k | Automated safety check: Notes | Unknown | 3 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/ | 270 | — | ~3.9k | Automated safety check: Pass | MIT | 5 mo ago |
| 28 | 28.Ad Archive 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/ | 755 | 1 repo | ~1.6k | Automated safety check: Pass | Unknown | 2 mo ago |
| 29 | 29.Remember 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/ | 389 | — | ~571 | Automated safety check: Pass | MIT | 2 days ago |
| 30 | Create, update, review, and execute manual Markdown implementation plans when harness planning mode is not being used. | fjrevoredo/ | 308 | — | ~3.7k | Automated safety check: Pass | MIT | 2 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/ | 230 | — | ~4.2k | Automated safety check: Pass | Unknown | 4 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/ | 946 | — | ~2k | Automated safety check: Pass | MIT | 3 days ago |
| 33 | Universal UI/UX design principles covering visual hierarchy, interaction laws, typography foundations, and WCAG accessibility requirements. | bergside/ | 2k | — | ~861 | Automated safety check: Pass | MIT | 3 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/ | 218 | 1 repo | ~2.3k | Automated safety check: Pass | MIT | 3 mo ago |
| 35 | 35.Free Will 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/ | 397 | — | ~3.4k | Automated safety check: Pass | No licence | 3 mo ago |
| 36 | 36.S2 Docs Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components. | adobe/ | 155 | — | ~868 | Automated safety check: Pass | Apache-2.0 | 4 days ago |
| 37 | Maintain bounded, durable AI project memory in a repository's docs/ai/ pack. | tudoumashu/ | 411 | — | ~1.1k | Automated safety check: Pass | MIT | 29 days ago |
| 38 | 38.Nelson Orchestrates multi-agent task execution using a Royal Navy squadron metaphor — from mission planning through parallel work coordination to stand-down. | Aspegio/ | 421 | — | ~11k | Automated safety check: Warn | MIT | 3 mo ago |
| 39 | Creates or updates concise Architecture Decision Records for the Mistral Vibe CLI and registers each one in the AGENTS.md decisions table. | mistralai/ | 5.1k | — | ~942 | Automated safety check: Pass | Apache-2.0 | yesterday |
| 40 | 40.Adr Writer Generate a numbered Architecture Decision Record (ADR) following the standard nygard/MADR convention. | skrun-dev/ | 210 | — | ~861 | Automated safety check: Pass | MIT | 14 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/ | 437 | — | ~2.3k | Automated safety check: Pass | Apache-2.0 | today |
| 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/ | 216 | — | ~2.2k | Automated safety check: Pass | MIT | 4 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/ | 142 | — | ~1.1k | Automated safety check: Pass | MIT | 2 days ago |
| 44 | 44.Decide 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/ | 844 | — | ~1.9k | Automated safety check: Pass | MIT | 1 mo ago |
| 45 | Before answering any technical question, code request, architecture decision, or factual claim, call searchknowledge to check the local corpus. | lyonzin/ | 290 | — | ~1.4k | Automated safety check: Pass | MIT | 3 days ago |
| 46 | 46.Decision Log Writes every KEEP/CUT/DEFER/PIVOT scope decision into an append-only team log with rationale, author, and timestamp. | MAGA2010/ | 349 | — | ~847 | Automated safety check: Pass | MIT | 3 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/ | 423 | — | ~1.1k | Automated safety check: Pass | Apache-2.0 | 7 days ago |
| 48 | Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records… | bybren-llc/ | 421 | — | ~1.2k | Automated safety check: Pass | MIT | 2 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.
Explore related skills
Category
More topics in Development
- Pull requests1,927
- Refactoring1,154
- Debugging1,154
- Changelog and release notes1,147
- Code review1,053
- Technical documentation998
- Linting and formatting830
- Git workflow809
- Diagrams801
- Project scaffolding742
- Root cause analysis610
- Code quality579
- Commit messages556
- Git worktrees528
- Performance optimization440
- Design patterns408
- Error handling317
- Type safety301
- Dependency management285
- Software architecture280
- Monorepo tooling267
- Async programming243
- Issue triage234
- Codebase onboarding232