CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plan-design-review

Review a written plan or design doc through a designer's lens before implementation - seven passes over information architecture, interaction states, emotional arc, AI-slop risk, design-system alignment, responsive and accessibility coverage, and unresolved decisions. Each dimension is rated 0-10 with an explicit statement of what would make it a 10, then the plan is edited to get there. Use when a plan has a UI surface and you want the design gaps closed before code is written. Not for auditing a live site.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/plan-design-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is maximally lean but is a pure redirect: all actual guidance lives in an external file that is not part of the skill bundle, leaving no workflow, examples, or validation steps in the skill itself. Conciseness is perfect, yet actionability, workflow clarity, and navigation all suffer because the content is not shipped with the skill.

Suggestions

Ship the shared skill's content inside the bundle (e.g., copy the seven-pass workflow into references/) and reference it with a bundle-relative path, so the skill is self-contained instead of depending on ~/.agents/skills/plan-design-review/SKILL.md.

Add a brief overview of the workflow to the body — the seven named passes, the 0-10 rating with an explicit 'what would make it a 10', and the edit loop — so Claude has a sequenced process with checkpoints before loading any details.

Verify the external path exists at runtime or provide an inline fallback; a pointer to a home-directory file that may not be present leaves the skill unusable as a standalone bundle.

DimensionReasoningScore

Conciseness

The body is two lines — a generator comment and 'Load and follow the shared skill at `~/.agents/skills/plan-design-review/SKILL.md`' — with zero padding and no explanation of concepts Claude already knows. Every token earns its place, matching the 5 anchor ('lean and efficient; assumes Claude's competence').

5 / 5

Actionability

The single instruction is concrete and executable (an exact file path to load), but the body contains no task-level guidance — none of the seven passes, the 0-10 rating scale, or the editing steps the description promises. This fits anchor 3 ('some concrete guidance but incomplete; missing key details') rather than 4, where the gaps would be minor.

3 / 5

Workflow Clarity

The multi-step process the description advertises ('seven passes', rating, editing) is entirely absent from the body — only a single delegating 'Load and follow' directive is present, with no sequence and no validation for the actual work. It sits between anchor 1 (steps missing) and anchor 2 (rough sequence, many gaps); the lone directive is coherent and well-defined, so 2 rather than 1.

2 / 5

Progressive Disclosure

The body is a clearly signaled, one-level-deep pointer, but it targets an absolute path outside the skill bundle (`~/.agents/skills/plan-design-review/SKILL.md`) and no references/, scripts/, or assets/ files exist, so the body provides no overview and the skill ships none of its content. Fits anchor 3 ('some structure but could be better organized') rather than 4, since the organization gap is not minor.

3 / 5

Total

13

/

20

Passed

Description

88%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: it concretely enumerates the skill's seven review passes and the rating/edit mechanism, provides an explicit third-person 'Use when...' trigger with a scope exclusion, and stays concise. The only gaps are a few missing natural trigger synonyms (wireframe, mockup, spec) and slight overlap risk with generic design-review requests.

DimensionReasoningScore

Specificity

It enumerates multiple concrete actions — 'seven passes over information architecture, interaction states, emotional arc, AI-slop risk, design-system alignment, responsive and accessibility coverage, and unresolved decisions', each 'rated 0-10', then 'the plan is edited to get there' — comprehensive coverage matching the 5 anchor. Not 4, because there are no meaningful gaps in the enumerated actions.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' is the seven-pass rating-and-edit loop, and the 'when' is concrete — 'Use when a plan has a UI surface and you want the design gaps closed before code is written' — plus a negative scope ('Not for auditing a live site'). Not 4, because the when-clause is already explicit and trigger-phrase-level specific.

5 / 5

Trigger Term Quality

Natural terms like 'plan', 'design doc', 'UI surface', 'design gaps', and 'before code is written' are present, but common variations users would say — 'wireframe', 'mockup', 'spec', 'design review' — are missing. Matches anchor 4 (good keyword coverage, a few natural terms missing) rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The pre-implementation plan-review niche and the explicit 'Not for auditing a live site' boundary distinguish it well, but broad terms like 'review' and 'design' leave minor overlap risk with general design-critique or code-review skills. Fits anchor 4 (mostly distinct, minor overlap risk) rather than 5's minimal-conflict clear niche.

4 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.claude/skills/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.