CtrlK
BlogDocsLog inGet started
Tessl Logo

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).

76

Quality

96%

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

92%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, instruction-only skill body with a tightly sequenced workflow, hard gates, concrete executable commands, and a calibration feedback loop. It assumes Claude's competence throughout; only minor conciseness gains are available in the extended framing prose.

DimensionReasoningScore

Conciseness

Lean and assumes Claude's competence — it never explains what a proposal or postmortem is — but the nine lenses and extended framing on the three-review distinction add length that could be trimmed without losing the load-bearing guidance.

4 / 5

Actionability

Fully actionable: concrete commands (`exec("cat proposals/0003-feature.md")`, `grep -rln`, `write({document:{path:...}})`), a four-part finding template with severities, and specific lens questions each paired with the failure they catch.

5 / 5

Workflow Clarity

A clear Step 0–Step 6 sequence with hard gates ('never review a design you have not read end to end'), an explicit reconstruction checkpoint before critique, and an adversarial calibration step with falsifier-per-finding validation before delivery.

5 / 5

Progressive Disclosure

Single self-contained file with no bundle references needed; well-organized into clearly headed sections (Steps 0–6, Non-goals) that function as a clean overview with easy navigation — the simple-skill exception applies cleanly.

5 / 5

Total

19

/

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.

A highly specific, well-triggered description that clearly scopes the skill's niche and explicitly disambiguates it from neighboring authoring and review skills. It earns top marks across all four dimensions with concrete actions, natural trigger phrases, and strong boundary guidance.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'reviews whether a design is SOUND', 'emits ranked, evidence-backed findings', reconstructing the design's argument, running nine named soundness lenses — with comprehensive, domain-specific coverage.

5 / 5

Completeness

Explicitly answers both 'what' (reviews soundness, emits ranked evidence-backed findings) and 'when' ('Read when asked to...') with concrete trigger phrases, and adds explicit 'Do NOT read when...' boundaries.

5 / 5

Trigger Term Quality

Comprehensive natural phrasing users would say: 'review this design', 'is this design sound', 'pressure-test this proposal', 'poke holes in this spec', 'should we build this', plus synonyms (critique, ADR, architecture, product decision).

5 / 5

Distinctiveness Conflict Risk

Clear niche (soundness review) with explicit negative routing distinguishing it from frame-a-proposal, write-a-spec, record-a-decision, write-a-postmortem, code review, and correctness passes — minimal conflict risk.

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.

Validation14 / 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
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.