CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plan-design-review

Designer's eye plan review — interactive, like CEO and Eng review. Rates each design dimension 0-10, explains what would make it a 10, then fixes the plan to get there. Works in plan mode. For live site visual audits, use /design-review. Use when asked to "review the design plan" or "design critique". Proactively suggest when the user has a plan with UI/UX components that should be reviewed before implementation.

Quality

81%

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

71%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 highly actionable, well-sequenced design review workflow with concrete commands, table templates, and STOP checkpoints throughout. Its main weaknesses are a monolithic 1100-line body with zero bundle files (framework boilerplate, design rules, and blacklists all inlined) and a duplicate 'Step 0' heading that muddles step ordering.

Suggestions

Move the shared framework material (Voice, AskUserQuestion Format, Telemetry, Contributor Mode, Plan Status Footer — roughly the first 380 lines) into a bundled reference file and keep a one-line pointer, cutting body tokens by about a third.

Split the Design Hard Rules and AI Slop blacklist (Pass 4) into references/design-rules.md, keeping only the classifier and litmus checks inline in the pass.

Rename 'Step 0: Detect platform and base branch' (e.g., to 'Step 0P: Platform detection') or fold it into the preamble so 'Step 0' unambiguously means Design Scope Assessment in the priority hierarchy.

DimensionReasoningScore

Conciseness

The design-review core ('Rate 0-10', the AI slop blacklist, pass structure) is dense, but roughly 380 of ~1115 lines are shared framework material (Voice/persona rules, telemetry and proactive prompts, Contributor Mode, Plan Status Footer) that does not serve the design-review task. It fits anchor 3 rather than 2 because it never explains concepts Claude already knows — the padding is structural, not conceptual.

3 / 5

Actionability

Nearly everything is executable: exact commands ('$D variants --brief "..." --count 3 --output-dir', the feedback polling loop), the feedback JSON shape, the interaction state table template, and explicit substitution rules for placeholders like SKILL_NAME/OUTCOME. Copy-paste ready commands with specific examples covering the common cases match anchor 5.

5 / 5

Workflow Clarity

The sequence is explicit (Pre-review audit → Step 0 scope with STOP → Step 0.5 mockups → 7 passes each with STOP/AskUserQuestion → required outputs → review log → dashboard) and validation checkpoints exist ('$D check' quality gate, feedback confirmation loop, fallbacks on failure). Not 5 because two different sections are both titled 'Step 0' ('Detect platform and base branch' vs 'Design Scope Assessment') and the priority hierarchy references 'Step 0' ambiguously, leaving minor sequence gaps.

4 / 5

Progressive Disclosure

No bundle files exist; everything — Voice, Design Hard Rules, the 10-item AI Slop blacklist, dashboard formats — is inlined in a single 1100-line body. Section structure and in-file navigation are good and external framework pointers exist ('$GSTACK_ROOT/ETHOS.md'), but large content that should be in separate reference files is inline, fitting anchor 3 rather than 2 ('minimal structure') because the internal structure is solid.

3 / 5

Total

15

/

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: concrete actions, an explicit 'Use when' clause with quoted trigger phrases, and explicit disambiguation from the sibling /design-review skill. Its only gaps are unnamed design dimensions and trigger coverage that misses a few natural synonyms.

DimensionReasoningScore

Specificity

'Rates each design dimension 0-10, explains what would make it a 10, then fixes the plan to get there' names three concrete actions (rate, explain the gap, fix the plan). It stops short of anchor 5 because the design dimensions themselves are never named, leaving what is actually reviewed implicit.

4 / 5

Completeness

It explicitly answers both what ('Rates each design dimension 0-10... then fixes the plan to get there') and when ('Use when asked to "review the design plan" or "design critique"') with concrete trigger phrases, plus proactive-use guidance — the anchor 5 pattern.

5 / 5

Trigger Term Quality

Includes natural user phrases — 'review the design plan', 'design critique' — plus the contextual cue 'plan with UI/UX components'. Good coverage, but a few natural synonyms are missing (e.g., 'design feedback', 'UI review of the plan'), so it matches 'good keyword coverage; a few natural terms missing' rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche ('Works in plan mode', plan-stage review) and explicitly disambiguates the sibling skill ('For live site visual audits, use /design-review'). Minor overlap remains because 'design critique' could also apply to live-site critique, fitting 'mostly distinct; minor overlap risk with closely related skills' rather than minimal conflict risk.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1116 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/gstack/.agents/skills/gstack-plan-design-review/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.