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.
90
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that excels across all dimensions. It provides specific concrete actions, rich natural trigger terms, explicit 'Use when' guidance, and even includes boundary language to distinguish it from adjacent skills. The description is well-structured, concise, and uses appropriate third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: create architecture diagrams, write ADRs, evaluate technology trade-offs, design component interactions, and plan for scalability. These are clearly defined, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (create diagrams, write ADRs, evaluate trade-offs, design component interactions, plan scalability) and 'when' (designing new architecture, reviewing existing designs, making architectural decisions) with explicit 'Use when' clauses. Also includes boundary clarification distinguishing it from code-level patterns or database-only tasks. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'system architecture', 'architecture diagrams', 'ADRs', 'Architecture Decision Records', 'technology trade-offs', 'scalability', 'microservices', 'system design', 'architecture review', 'infrastructure pattern'. These are terms users would naturally use when seeking architectural guidance. | 3 / 3 |
Distinctiveness Conflict Risk | Explicitly carves out its niche by stating it is 'distinct from code-level design patterns or database-only design tasks,' which directly reduces conflict risk with related skills. The focus on high-level system architecture, ADRs, and infrastructure patterns creates a clear and unique scope. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured architecture skill with strong actionability through concrete examples (Mermaid diagrams, full ADR) and a clear workflow with validation checkpoints. Its main weaknesses are some unnecessary verbosity (persona definition, redundant 'When to Use' section) and the absence of the five referenced files that the progressive disclosure structure depends on. The constraints section (MUST DO / MUST NOT DO) adds genuine value by bounding behavior.
Suggestions
Remove or drastically shorten the 'Role Definition' section — Claude doesn't need persona framing like '15+ years of experience' to follow instructions.
Provide the five referenced files (architecture-patterns.md, adr-template.md, etc.) or remove the reference table, since currently it points to non-existent resources.
Consider merging the 'When to Use This Skill' section into the frontmatter description to avoid redundancy and save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The role definition section ('You are a principal architect with 15+ years of experience...') is unnecessary persona framing that Claude doesn't need. The 'When to Use This Skill' section largely duplicates what the frontmatter description already covers. However, the reference table, constraints, and examples are reasonably efficient. | 2 / 3 |
Actionability | The skill provides concrete, executable outputs: a complete Mermaid diagram example, a fully fleshed-out ADR template with realistic content, a clear reference table for loading guidance, and specific output templates. These are copy-paste ready and directly usable. | 3 / 3 |
Workflow Clarity | The core workflow is clearly sequenced with five numbered steps and includes explicit validation checkpoints: 'Verify full requirements coverage before proceeding' at step 1 and 'If review fails, return to step 3 with recorded feedback' at step 5. This provides a feedback loop for error recovery in a non-destructive design process. | 3 / 3 |
Progressive Disclosure | The reference table clearly signals five separate reference files with 'Load When' conditions, which is excellent progressive disclosure design. However, no bundle files were provided, meaning none of these referenced files actually exist. The inline content (ADR example, Mermaid diagram) is appropriately sized, but the missing references undermine the structure. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
5e8b6b8
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.