CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-a-design

Reviews whether a design is SOUND — solving the right problem, derived from its stated goals and constraints — and emits ranked, evidence-backed findings, not edits. Read when asked to 'review this design', 'is this design sound', 'pressure-test this proposal', 'do a design review', 'does this solve the right problem', 'poke holes in this spec', 'should we build this', or to critique a proposal / spec / ADR / architecture or product decision. Do NOT read when the user wants to AUTHOR one of these — routing a new proposal is frame-a-proposal, a spec is write-a-spec, a decision record is record-a-decision, a postmortem is write-a-postmortem. Do NOT read for code review of a diff, or to fact-check individual claims (that is a correctness pass, a different job).

Quality

94%

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

88%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-crafted, highly actionable skill body: the soundness-vs-completeness-vs-correctness framing, hard read-first gates, the nine failure-named lenses, and the ranked finding schema give Claude everything needed to execute. The only deductions are minor — some repetition of the findings-not-edits principle and a 128-line single file where lens details could be split into a reference.

Suggestions

State the 'findings, not edits' principle once (ideally in the intro) and let the Non-goals section carry the variants, cutting the repetition in Steps 3 and 5.

Consider moving the nine lens definitions (Step 2) into a references/lenses.md with a one-line summary per lens in SKILL.md, shortening the always-loaded overview while keeping the details one level deep.

DimensionReasoningScore

Conciseness

The body is dense craft guidance with no concept padding — e.g., the nine lenses each carry a named question plus the failure they catch, knowledge Claude does not already have. However, the "findings, not edits" principle is repeated four times ("You produce findings, not edits" in the intro, "A finding with no evidence pointer is an opinion" in Step 3, "Never edit the design under review" in Step 5, "Not a rewrite" in Non-goals), and a few rhetorical flourishes ("spends the author's trust on partial understanding") could be trimmed — minor over-explanation, not the lean-every-token-earns-its-place level.

4 / 5

Actionability

Guidance is fully executable: copy-paste commands ("exec(\"cat proposals/0003-feature.md\")", "exec(\"grep -rln <subsystem-keyword> decisions/\")", "write({ document: { path: \"proposals/0003-feature-review.md\" } })"), concrete file-path patterns, and a complete finding schema (Claim / Evidence / Severity with three defined levels / Resolution) with example resolutions ("consider a two-way-door version that does X, which drops the migration"). As an instruction-only skill, the guidance is specific and actionable throughout.

5 / 5

Workflow Clarity

Steps 0–6 are clearly sequenced with explicit validation gates: "never review a design you have not read end to end", "Do not proceed until you can name the goal, the constraints, and the prior decisions", and Step 1's stop condition ("If you cannot state the goal... the reviewable object does not exist yet — and that IS the finding"). Step 4 adds an explicit adversarial feedback loop — re-read each finding and try to kill it — which is a genuine validate-and-retry checkpoint on the review itself.

5 / 5

Progressive Disclosure

The file is well-organized with clear section headers (Steps 0–6, Non-goals) and no external references to navigate, so structure is good. But at ~128 lines with the nine-lens catalog (Step 2) and knowledge-base navigation details inlined, it exceeds the under-50-line self-contained case; the lens definitions could live in a one-level-deep reference file for a tighter overview. Minor organization gap rather than a monolith — hence 4, not 3.

4 / 5

Total

18

/

20

Passed

Description

100%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.

An exemplary description: it states the skill's concrete capability and output format, provides abundant natural trigger phrases including synonyms, and uses explicit do-NOT-read routing to carve out a distinct niche from authoring, code-review, and fact-check skills. Written in third person with no fluff.

DimensionReasoningScore

Specificity

The description lists concrete, specific actions — "Reviews whether a design is SOUND — solving the right problem, derived from its stated goals and constraints — and emits ranked, evidence-backed findings, not edits" — covering both the review function and the output artifact. Coverage is comprehensive: it also scopes the review types it is not (completeness, correctness, code review), leaving no gaps in what the skill does.

5 / 5

Completeness

Both "what" ("Reviews whether a design is SOUND... and emits ranked, evidence-backed findings, not edits") and "when" ("Read when asked to 'review this design'...") are answered explicitly with concrete trigger phrases. The explicit 'Read when' clause satisfies the trigger-guidance requirement, so no cap applies.

5 / 5

Trigger Term Quality

Natural trigger phrases a user would actually say are comprehensively covered: "review this design", "is this design sound", "pressure-test this proposal", "do a design review", "poke holes in this spec", "should we build this", plus artifact synonyms (proposal / spec / ADR / architecture / product decision). Score 4 would require missing natural terms, and none are identifiable.

5 / 5

Distinctiveness Conflict Risk

The description has a clear niche (soundness review of designs) and explicitly de-conflicts via negative triggers: "Do NOT read when the user wants to AUTHOR one of these" (routing to frame-a-proposal / write-a-spec / record-a-decision / write-a-postmortem), "Do NOT read for code review of a diff, or to fact-check individual claims". Conflict risk with adjacent skills is minimal.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 2 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

inkeep/open-knowledge

Path

packages/server/assets/skills/packs/software-lifecycle/review-a-design/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.