Skip to content
SkillModel-led790 tokens in use

Architecture Designer

Designs system architecture with Mermaid diagrams, written trade-offs and Architecture Decision Records, from requirements through stakeholder review.

12,471 stars on the repository MIT LicenseJeffallan/claude-skills · skills/architecture-designer
/plugin marketplace add jeffallan/claude-skills /plugin install fullstack-dev-skills@fullstack-dev-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Architecture Designer costs

88tokens idle
790tokens in use
4,515tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter15/15
  • Structure22/25
  • Examples15/15
  • Output15/15
  • Size15/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance100
  • Community60
  • Maturity36
  • Momentum40

Architecture Designer puts Claude in the role of a principal architect. It collects functional and non-functional requirements, matches them to architecture patterns, draws the result and records each significant choice as an ADR.

The skill pushes for explicit trade-offs, failure modes and operational cost, and warns against building for scale that nobody has asked for.

What You Get

  • A requirements summary covering functional and non-functional needs
  • A Mermaid architecture diagram of the main components and data flow
  • ADRs with status, context, decision, alternatives and consequences
  • Technology recommendations with a rationale for each
  • A list of risks with mitigations

Common Use Cases

  • Choosing between a monolith and microservices
  • Writing an ADR for a database selection
  • Reviewing an existing design for single points of failure
  • Planning how a system will scale
  • Gathering non-functional requirements before a build

What Makes It Unique

The skill is for high-level design, and it says so: it is separate from code-level design patterns and from database-only work. Its references include an ADR template, a database selection guide and a non-functional requirements checklist, and its rules require alternatives to be evaluated before any technology is chosen.

Under The Hood

The skill is a SKILL.md with five reference files on patterns, the ADR template, system design, database selection and non-functional requirements. It has no scripts and runs no commands. The agent reads the references that match the task and writes the design as text, Mermaid and markdown documents. It does not fetch web pages or call outside APIs.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers