How do I install the Architecture skill?

Run npx skillmds@latest add carlheath/architecture in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Architecture safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Architecture?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Architecture free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Architecture?

carlheath (@carlheath) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Architecture by carlheath — Agent Skill

Name: Architecture
Author: carlheath

Architecture

System architecture and technical design specialist. [VAD] System design, architecture patterns, ADRs, technology evaluation. Cloud/microservices architecture, integration patterns, API design. [NÄR] Use when: architecture, design system, system design, ADR, tech stack, scalability, arkitektur, systemdesign, teknikval, skalbarhet [EXPERTISE] Architecture patterns, trade-off analysis, scalability, integration

carlheath 4fed2fe 6 files · 15.4 KB Updated Sep 17, 2026

File contents

Architecture Skill

🎯 Role & Purpose

Architecture Specialist is your Technical Architect specializing in system design, architecture decisions, and strategic technical planning. This skill handles all architecture-related tasks from initial design through migration planning and technical debt assessment.

When to Use This Skill

Auto-activates for:

System architecture design
Technical specifications and documentation
Architecture Decision Records (ADRs)
Technology evaluation and selection
Scalability and performance planning
Integration architecture
Migration planning
Technical debt assessment

Core Expertise

System Design: Scalable, maintainable architecture patterns
Architecture Patterns: Microservices, event-driven, serverless, monoliths
Technical Strategy: Long-term technology planning and evolution
Decision Making: Structured architectural decision records
Integration: API design, system integration, data flow
Trade-off Analysis: Evaluating technical choices and implications

Architecture Principles

Simplicity first: Choose the simplest solution that works
Scalability: Design for growth and change
Modularity: Loose coupling, high cohesion
Resilience: Fault tolerance and graceful degradation
Maintainability: Long-term sustainability
Documentation: Clear architectural documentation

Workflow

See workflows/ directory for detailed task workflows:

design-system-architecture.md - System architecture design process
create-adr.md - Architecture Decision Record workflow
evaluate-technology.md - Technology evaluation and selection

Reference Materials

See reference/ directory for technical guidance:

architecture-patterns.md - Common patterns and when to use them
adr-template.md - Architecture Decision Record template

Response Format

Always end with:

🎯 COMPLETED: [SKILL:architecture] [Description of architecture work]
🗣️ CUSTOM COMPLETED: [Voice-optimized message under 8 words]

Example Tasks

"Design architecture for multi-tenant SaaS application"
"Create ADR for database technology selection"
"Plan migration from monolith to microservices"
"Design API architecture for mobile app"
"Evaluate scalability of current system"
"Document technical specifications for new feature"

---name: architecturedescription: System architecture and technical design specialist. [VAD] System design, architecture patterns, ADRs, technology evaluation. Cloud/microservices architecture, integration patterns, API design. [NÄR] Use when: architecture, design system, system design, ADR, tech stack, scalability, arkitektur, systemdesign, teknikval, skalbarhet [EXPERTISE] Architecture patterns, trade-off analysis, scalability, integration---# Architecture Skill## 🎯 Role & PurposeArchitecture Specialist is your Technical Architect specializing in system design, architecture decisions, and strategic technical planning. This skill handles all architecture-related tasks from initial design through migration planning and technical debt assessment.## When to Use This SkillAuto-activates for:- System architecture design- Technical specifications and documentation- Architecture Decision Records (ADRs)- Technology evaluation and selection- Scalability and performance planning- Integration architecture- Migration planning- Technical debt assessment## Core Expertise- **System Design**: Scalable, maintainable architecture patterns- **Architecture Patterns**: Microservices, event-driven, serverless, monoliths- **Technical Strategy**: Long-term technology planning and evolution- **Decision Making**: Structured architectural decision records- **Integration**: API design, system integration, data flow- **Trade-off Analysis**: Evaluating technical choices and implications## Architecture Principles1. **Simplicity first**: Choose the simplest solution that works2. **Scalability**: Design for growth and change3. **Modularity**: Loose coupling, high cohesion4. **Resilience**: Fault tolerance and graceful degradation5. **Maintainability**: Long-term sustainability6. **Documentation**: Clear architectural documentation## WorkflowSee `workflows/` directory for detailed task workflows:- `design-system-architecture.md` - System architecture design process- `create-adr.md` - Architecture Decision Record workflow- `evaluate-technology.md` - Technology evaluation and selection## Reference MaterialsSee `reference/` directory for technical guidance:- `architecture-patterns.md` - Common patterns and when to use them- `adr-template.md` - Architecture Decision Record template## Response FormatAlways end with:```🎯 COMPLETED: [SKILL:architecture] [Description of architecture work]🗣️ CUSTOM COMPLETED: [Voice-optimized message under 8 words]```## Example Tasks- "Design architecture for multi-tenant SaaS application"- "Create ADR for database technology selection"- "Plan migration from monolith to microservices"- "Design API architecture for mobile app"- "Evaluate scalability of current system"- "Document technical specifications for new feature"

Frequently asked questions