Architecture Designer
Designs system architecture and writes ADRs to document key technical decisions.
Test report
- Verdict
- Works with setup
- Score
- Tested
- Jul 12, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · c3014c3
Installed verbatim (git clone + cp) with valid YAML frontmatter and all 5 reference files present; no external dependencies or API keys. Trigger docked because the description claims to exclude code-level design patterns and database-only tasks, yet metadata.triggers lists 'design pattern' and the reference table routes database-selection questions inward. A/B on a URL-shortener system-design task showed the skill and base outputs at equal quality — both delivered a correct requirements summary, Mermaid diagram, well-formed ADR with 2+ datastore alternatives, and risk analysis; the skill's ADR/pattern reference framework produced no materially more rigorous design.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 3/5
- Output vs. baseline 5/10
- Docs & honesty 5/5
What Architecture Designer does
Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions. Invoke to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability. Use for system design, architecture review, microservices structuring, ADR authoring, scalability…
How to install Architecture Designer
git clone https://github.com/Jeffallan/claude-skills
cd claude-skills
mkdir -p ~/.claude/skills
cp -r skills/architecture-designer ~/.claude/skills/architecture-designer
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Architecture Designer
-
/architecture-designerDesigns system architecture and writes ADRs to document key technical decisions.
It also activates on plain-language prompts like these:
-
Design the architecture for this new microservice -
Write an ADR for choosing this database -
Review our architecture for scalability gaps
Frequently asked questions
- Is the Architecture Designer skill free?
- Yes. The skill itself is free from Jeffallan/claude-skills. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Architecture Designer work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 12, 2026. Verdict: Works with setup. Installed verbatim (git clone + cp) with valid YAML frontmatter and all 5 reference files present; no external dependencies or API keys. Trigger docked because the description claims to exclude code-level design patterns and database-only tasks, yet metadata.triggers lists 'design pattern' and the reference table routes database-selection questions inward. A/B on a URL-shortener system-design task showed the skill and base outputs at equal quality — both delivered a correct requirements summary, Mermaid diagram, well-formed ADR with 2+ datastore alternatives, and risk analysis; the skill's ADR/pattern reference framework produced no materially more rigorous design.
- What is the Architecture Designer SkillProof Score?
- 7.2/10 — installs cleanly 5/5, triggers reliably 3/5, output vs. baseline 5/10, docs & honesty 5/5.
- How do I install Architecture Designer?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Architecture Designer with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.