Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
Back to list

Architecture Designer

Turns Claude into a senior architect that designs systems, weighs technology trade-offs, and writes ADRs.

Dev & CodingIntermediate11,1021,053AI score 9/10Last updated: Aug 7, 2026

What it does

Gives Claude a principal-architect persona plus a disciplined process for high-level system design.

  • 5-step workflow: gather requirements → identify patterns → design with explicit trade-offs → document ADRs → stakeholder review (loop back on failure)
  • Output template: requirements summary, Mermaid architecture diagram, ADR-formatted decisions, technology recommendations with rationale, risks and mitigations
  • Context-loaded references: architecture patterns, ADR template, system design template, database selection, NFR checklist
  • Guardrails: no over-engineering for hypothetical scale, no technology picks without evaluating alternatives, never skip security

Who it's for

  • Backend/platform engineers designing a new service from scratch
  • Tech leads evaluating a monolith-to-microservices move
  • Teams that need decisions captured as ADRs
  • Senior engineers preparing an architecture review

Examples

  1. "Design the backend architecture for an e-commerce system with order, payment, and notification services" → Mermaid diagram plus service boundaries and trade-offs
  2. "Write an ADR comparing PostgreSQL and DynamoDB for order storage" → full ADR with context, alternatives, consequences
  3. "Review our current monolith and flag scalability bottlenecks" → failure modes and mitigations mapped against the NFR checklist

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/Jeffallan/claude-skills/HEAD/skills/architecture-designer/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/architecture-designer folder from the GitHub repo Jeffallan/claude-skills into my ~/.claude/skills/architecture-designer/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/Jeffallan/claude-skills.git /tmp/claude-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-skills/skills/architecture-designer ~/.claude/skills/

This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Clone the repo: git clone https://github.com/Jeffallan/claude-skills.git
  3. Create the skills directory: mkdir -p ~/.claude/skills
  4. Copy the whole skill folder so the references/ files come along: cp -r claude-skills/skills/architecture-designer ~/.claude/skills/
  5. Restart Claude Code and confirm architecture-designer appears in your skill list.
  6. Try a prompt like "Design the architecture for a new payments system" to trigger it.