architecture-designer SKILL.md skillA

architecture-designer from jeffallan/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jeffallan/claude-skills/architecture-designer@v1.1.1

Pins v1.1.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jeffallan/claude-skills
Path
skills/architecture-designer/SKILL.md
Versions recorded
5
Latest version
v1.1.1, committed Oct 3, 2026
First version recorded
Mar 6, 2026
Size
4,926 bytes
Repository stars
12,006
License
MIT

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 planning, and infrastructure pattern selection — distinct from code-level design patterns or database-only…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Architecture Designer

Senior software architect specializing in system design, design patterns, and architectural decision-making.

## Role Definition

You are a principal architect with 15+ years of experience designing scalable, distributed systems. You make pragmatic trade-offs, document decisions with ADRs, and prioritize long-term maintainability.

## When to Use This Skill

- Designing new system architecture
- Choosing between architectural patterns
- Reviewing existing architecture
- Creating Architecture Decision Records (ADRs)
- Planning for scalability
- Evaluating technology choices

## Core Workflow

1. **Understand requirements** — Gather functional, non-functional, and constraint requirements. _Verify full requirements coverage before proceeding._
2. **Identify patterns** — Match requirements to architectural patterns (see Reference Guide).
3. **Design** — Create architecture with trade-offs explicitly documented; produce a diagram.
4. **Document** — Write ADRs for all key decisions.
5. **Review** — Validate with stakeholders. _If review fails, return to step 3 with recorded feedback._

## Reference Guide

Load detailed guidance based on context:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jeffallan/claude-skills/architecture-designer@sha256:d8f3d98c54bbf35a

The line at the top of this page pins the label v1.1.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_axknaqtelaaedrw2.svg)](https://markdownregistry.com/a/art_axknaqtelaaedrw2)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Mar 6, 2026 and Oct 3, 2026, about one every 53 days.

versioncommittedcommitsizeaudit
v1.1.1 latest2026-10-03 958e60f 4,926 BA view · diff
v1.1.12026-10-03 ec755b7 4,844 BA view · diff
v1.1.12026-04-29 efebc44 4,750 BA view · diff
v1.1.12026-03-23 3ba746e 4,644 BA view · diff
v1.1.02026-03-06 c7afefb 4,604 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4926 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jeffallan/claude-skills · 12,006 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_axknaqtelaaedrw2
GET https://markdownregistry.com/api/v1/resolve?ref=jeffallan/claude-skills/architecture-designer
GET https://markdownregistry.com/api/v1/blob/d8f3d98c54bbf35ad07e068c7ae4c9b570a3e0e51041d7669e91e8593a7655c7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jeffallan/claude-skills

CLAUDE.md CLAUDE.md file
jeffallan/claude-skills · CLAUDE.md
git:20261003.eae31de · audit A · 12,006 stars
angular-architect SKILL.md skill
jeffallan/claude-skills · skills/angular-architect/SKILL.md · Generates Angular 17+ standalone components, configures advanced routing with lazy loading and guards, implements NgRx…
v1.1.0 · audit A · 12,006 stars
api-designer SKILL.md skill
jeffallan/claude-skills · skills/api-designer/SKILL.md · Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for…
v1.1.0 · audit A · 12,006 stars
atlassian-mcp SKILL.md skill
jeffallan/claude-skills · skills/atlassian-mcp/SKILL.md · Integrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying…
v1.1.0 · audit A · 12,006 stars
chaos-engineer SKILL.md skill
jeffallan/claude-skills · skills/chaos-engineer/SKILL.md · Designs chaos experiments, creates failure injection frameworks, and facilitates game day exercises for distributed…
v1.1.0 · audit A · 12,006 stars
cli-developer SKILL.md skill
jeffallan/claude-skills · skills/cli-developer/SKILL.md · Use when building CLI tools, implementing argument parsing, or adding interactive prompts. Invoke for parsing flags and…
v1.1.0 · audit A · 12,006 stars
cloud-architect SKILL.md skill
jeffallan/claude-skills · skills/cloud-architect/SKILL.md · Designs cloud architectures, creates migration plans, generates cost optimization recommendations, and produces…
v1.1.0 · audit A · 12,006 stars
code-documenter SKILL.md skill
jeffallan/claude-skills · skills/code-documenter/SKILL.md · Generates, formats, and validates technical documentation — including docstrings, OpenAPI/Swagger specs, JSDoc…
v1.1.0 · audit A · 12,006 stars
code-reviewer SKILL.md skill
jeffallan/claude-skills · skills/code-reviewer/SKILL.md · Analyzes code diffs and files to identify bugs, security vulnerabilities (SQL injection, XSS, insecure…
v1.1.0 · audit A · 12,006 stars
cpp-pro SKILL.md skill
jeffallan/claude-skills · skills/cpp-pro/SKILL.md · Writes, optimizes, and debugs C++ applications using modern C++20/23 features, template metaprogramming, and…
v1.1.0 · audit A · 12,006 stars
csharp-developer SKILL.md skill
jeffallan/claude-skills · skills/csharp-developer/SKILL.md · Use when building C# applications with .NET 8+, ASP.NET Core APIs, or Blazor web apps. Builds REST APIs using minimal…
v1.1.0 · audit A · 12,006 stars
database-optimizer SKILL.md skill
jeffallan/claude-skills · skills/database-optimizer/SKILL.md · Optimizes database queries and improves performance across PostgreSQL and MySQL systems. Use when investigating slow…
v1.1.1 · audit A · 12,006 stars

Every file in jeffallan/claude-skills

Other files named architecture-designer

architecture-designer SKILL.md skill
nicholyx/ai-skills · .agents/skills/architecture-designer/SKILL.md · Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions…
v1.1.1 · audit A · 6 stars
architecture-designer SKILL.md skill
jahidulislamseo/antigravity-ai-skills · skills/architecture-designer/SKILL.md · Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions…
v1.1.1 · audit A · 4 stars
architecture-designer SKILL.md skill
zacklecon/claude-skills · skills/architecture-designer/SKILL.md · Use when designing new system architecture, reviewing existing designs, or making architectural decisions. Invoke for…
v1.0.0 · audit A · 3 stars

Browse by kind, by grade A, or by owner.