CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Well-structured content: a validated five-step workflow with a feedback loop, complete Mermaid and ADR templates, and exemplary one-level-deep reference routing. The residual weaknesses are mild — persona/redundancy padding and abstract phrasing in the requirements-gathering steps.

Suggestions

Remove the persona paragraph, the 'When to Use This Skill' section (it duplicates the frontmatter description verbatim in substance), and the maintainer/footer lines — none of them change model behavior.

Give the abstract workflow steps a concrete mechanism, e.g. 'verify requirements coverage by cross-checking against references/nfr-checklist.md' or 'score each candidate pattern against the NFRs' so steps 1–2 are as actionable as the output templates.

Provide a brief format for the 'Risks and mitigation strategies' output item, since it is the only listed deliverable with no template or example.

DimensionReasoningScore

Conciseness

The body is mostly efficient — it never explains concepts Claude already knows, and the MUST DO / MUST NOT DO lists are terse. However, the persona paragraph ('You are a principal architect with 15+ years of experience...'), the 'When to Use This Skill' section that duplicates the frontmatter description, and the maintainer/footer lines are padding that could be trimmed. It is not 5 due to these trims; not 3 because the padding is minor relative to the whole.

4 / 5

Actionability

Concrete, usable artifacts: a syntactically complete Mermaid diagram example, a full ADR template with alternatives and consequences, an explicit five-item output checklist, and hard behavioral rules (MUST DO / MUST NOT DO). It is not 5 because early workflow steps remain abstract — 'Gather functional, non-functional, and constraint requirements' and 'Match requirements to architectural patterns' give no concrete mechanism, deferring all detail to the references. It is clearly above 3: the templates are real and copy-paste-ready, not pseudocode.

4 / 5

Workflow Clarity

The Core Workflow is a clear five-step sequence with an explicit upfront checkpoint ('Verify full requirements coverage before proceeding') and an explicit error-recovery feedback loop ('If review fails, return to step 3 with recorded feedback'). This matches the anchor-5 pattern of validation step plus retry loop; anchor 4's example lacks such a feedback loop, so 4 would undersell it. This is not a destructive/batch operation, so the cap does not apply.

5 / 5

Progressive Disclosure

The body is an overview with core templates inline, and all five referenced files (references/architecture-patterns.md, adr-template.md, system-design.md, database-selection.md, nfr-checklist.md) exist in the bundle, are one level deep, and are clearly signaled via a table with explicit 'Load When' conditions. Navigation is trivial; no organization gaps remain, so it fits anchor 5 rather than 4.

5 / 5

Total

18

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete action inventory, explicit dual 'Use when/Use for' triggers, and an explicit scope boundary against adjacent skills. The only notable weakness is trigger-term breadth — it restates the same concepts in two phrasings instead of adding synonyms a user might naturally say.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability' — plus a second set ('microservices structuring, ADR authoring, scalability planning, and infrastructure pattern selection'), giving comprehensive, non-abstract coverage. It is not 4 because the coverage goes beyond 'minor gaps' into a full inventory of the skill's actions.

5 / 5

Completeness

It explicitly answers both questions: 'what' via 'Invoke to create architecture diagrams, write ADRs, evaluate technology trade-offs...' and 'when' via two explicit trigger clauses ('Use when designing new high-level system architecture, reviewing existing designs...' and 'Use for system design, architecture review, microservices structuring...'). This matches the anchor-5 example structure exactly; it is not 4 because the 'when' clauses are already explicit and concrete, not merely present.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'system design', 'architecture review', 'microservices', 'scalability', 'ADR', 'infrastructure pattern selection' — phrases a user would plausibly say. It is not 5 because common synonyms like 'tech stack', 'service decomposition', or 'distributed systems' are missing, and some concepts are repeated in two phrasings ('plan for scalability' / 'scalability planning') rather than broadening coverage; it is clearly above 3's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The description ends with an explicit boundary — 'distinct from code-level design patterns or database-only design tasks' — carving a clear niche alongside concrete, unambiguous triggers. It is not 4 because overlap risk is actively disclaimed rather than left as a minor unaddressed gap.

5 / 5

Total

19

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Jeffallan/claude-skills

Path

skills/architecture-designer/SKILL.md

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.