CtrlK
BlogDocsLog inGet started
Tessl Logo

architecture-designer

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

Quality

88%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
Jeffallan/claude-skills
Reviewed

Table of Contents

Is this your skill?

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.