CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

architect

Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in. Use for /architect, 'architect this', 'design this', or non-trivial work where jumping to code would lock in the wrong shape.

69

Quality

87%

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.

A well-built orchestration skill: lean directive prose, concrete per-phase instructions, explicit feedback loops for deviation and redesign, and clean one-level-deep externalization of the runner prompt and rationale template. The only trims available are minor redundancy in Phase E and a few implicit invocation mechanics.

DimensionReasoningScore

Conciseness

The body is dense, directive prose that assumes competence — no concept explanations, and lines like "Naming a file isn't grounding" earn their tokens. It falls short of 'every token earns its place' because Phase E restates the pattern-vs-single-instance point three times (intro, the two-deviations bullet, and the "Use judgment" paragraph) and phrases like "This is the exhaust-the-design-space principle skill made concrete" add little.

4 / 5

Actionability

Concrete, executable guidance throughout for an orchestration skill: "Open a todolist with one entry per phase", "Run the **arena** skill with the design-sketch task", "Pass `references/runner-prompt.md` as each runner's prompt", named runner defaults (`opus`, `sonnet`, `haiku`), and a specific list of scrap tells. Not a 5 because nothing is copy-paste ready and mechanics like how to invoke arena or what 'the design-sketch task' literally is stay implicit.

4 / 5

Workflow Clarity

Five phases are named and sequenced up front with a todolist checkpoint, and error-recovery feedback loops are explicit: Phase D mandates surfacing deviations, Phase E gives concrete scrap triggers plus a recovery procedure (re-run **how**, redesign, subtract, return to Phase B), and human pushback loops back to re-grounding. This matches the top anchor's 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists'.

5 / 5

Progressive Disclosure

The body is a clear workflow overview and correctly externalizes detail: both referenced files (`references/runner-prompt.md`, `references/rationale-template.md`) exist in the bundle with real, purpose-matched content, are one level deep, and are clearly signaled in context with what each is for. No inlined content that belongs in a separate file.

5 / 5

Total

18

/

20

Passed

Description

83%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: third-person-style imperative voice, explicit what-and-when structure with concrete trigger phrases, and no fluff or over-claims. Its only weaknesses are the slightly vague 'stay in the loop' clause and trigger coverage that misses common synonyms like 'plan' or 'structure'.

DimensionReasoningScore

Specificity

Quotes several concrete actions — "Sketch types, signatures, and module structure before code" — plus a follow-through role ("stay in the loop while implementation fills in"), but that second clause is fuzzier and the description omits concrete outputs (rationale, module map), so it lands at 'several specific actions; minor gaps' rather than comprehensive.

4 / 5

Completeness

Both halves are explicit: the 'what' ("Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in") and a concrete 'when' clause ("Use for /architect, 'architect this', 'design this', or non-trivial work where jumping to code would lock in the wrong shape") with literal trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Natural invocation phrases are present — "/architect", "'architect this'", "'design this'" — matching the 'good keyword coverage; a few natural terms missing' anchor; synonyms like 'plan this', 'scaffold', or 'structure the code' are absent, keeping it below comprehensive.

4 / 5

Distinctiveness Conflict Risk

The niche (pre-implementation type/signature sketching) is distinct, but "'design this'" and the broad "non-trivial work" trigger could overlap with other design- or planning-oriented skills, so it is 'mostly distinct; minor overlap risk' rather than minimal conflict.

4 / 5

Total

17

/

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

adamsardo/pstack-claude

Path

plugins/pstack/skills/architect/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.