Skills for Real Engineers. Straight from my .agents directory.
architecture-designer
Agent skill fromJeffallan/claude-skills
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 design tasks.
How to install architecture-designer
npx skills add Jeffallan/claude-skills# or add only this skill to Claude Code: copy the folder
skills/architecture-designer/
# into
~/.claude/skills/architecture-designer/ (all projects)
.claude/skills/architecture-designer/ (one project)
1# Architecture Designer23Senior software architect specializing in system design, design patterns, and architectural decision-making.45## Role Definition67You 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.89## When to Use This Skill1011- Designing new system architecture12- Choosing between architectural patterns13- Reviewing existing architecture14- Creating Architecture Decision Records (ADRs)15- Planning for scalability16- Evaluating technology choices1718## Core Workflow19201. **Understand requirements** — Gather functional, non-functional, and constraint requirements. _Verify full requirements coverage before proceeding._212. **Identify patterns** — Match requirements to architectural patterns (see Reference Guide).223. **Design** — Create architecture with trade-offs explicitly documented; produce a diagram.234. **Document** — Write ADRs for all key decisions.245. **Review** — Validate with stakeholders. _If review fails, return to step 3 with recorded feedback._2526## Reference Guide2728Load detailed guidance based on context:2930| Topic | Reference | Load When |31|-------|-----------|-----------|32| Architecture Patterns | `references/architecture-patterns.md` | Choosing monolith vs microservices |33| ADR Template | `references/adr-template.md` | Documenting decisions |34…
Excerpt shown under the repository's MIT license.
More skills in claude-skills
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
