CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

design-md

Generate 4-6 complete candidate design systems for a web project, let the user pick one visually in the browser, and freeze the winner into a Google-spec design.md at the project root. Use ONLY when the user explicitly invokes /design-md or explicitly asks to run the design-system picker. If a conversation merely suggests it would help, suggest it — never start it unasked (it launches a server, opens a browser, and writes many files).

Quality

89%

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.

An exceptionally lean, well-sequenced orchestration body with genuine validation feedback loops and thorough failure handling. Its one material defect is bundle integrity: the four load-bearing reference files the workflow depends on are absent, which both breaks navigation and blocks full executability.

Suggestions

Ship the four missing reference files under <skill>/reference/ (interview.md, directions.md, candidate-spec.md, distill.md) — they are load-bearing for Phases 1, 2, 3, and 6, and their absence makes the referenced paths dangling.

If any reference is intentionally excluded, inline its minimal content (e.g., a candidate-spec skeleton or a condensed interview question list) so the phase can still be executed from SKILL.md alone.

Add a one-line bundle manifest or file inventory so missing references are detectable before a run starts rather than mid-workflow.

DimensionReasoningScore

Conciseness

The ~60-line body is dense imperative instruction with no concept explanations: path conventions are defined once ("All paths below: `<skill>` = ... `<run>` = `.design-md/`"), phase steps are single-line directives, and failures are compressed into a table. Every token earns its place.

5 / 5

Actionability

Gives copy-paste commands (`node <skill>/scripts/validate.mjs <run>/candidates/<id> --pages <page,list>`, `node -e "console.log(crypto.randomUUID())"`, the server launch) and exact JSON shapes for run.json/manifest.json. Falls short of fully executable because Phases 1, 3, and 6 delegate their instruction content to `<skill>/reference/interview.md`, `candidate-spec.md`, and `distill.md`, none of which exist in the bundle.

4 / 5

Workflow Clarity

Clear phase sequence with explicit validation and feedback loops for a batch/destructive workflow: Phase 4 validates each candidate, retries failures once with validator errors fed back, enforces a >=3-valid threshold, and deletes invalid leftovers; Phase 6 finalize is transactional (tmp file → pinned lint → backup → rename → archive); Phase 0 gates resume/replacement; and the error-handling table covers server, lint, tab-close, and interruption failures with fallbacks.

5 / 5

Progressive Disclosure

The on-paper design is good — each phase points to a one-level-deep reference at the point of need — but scored against the actual bundle, all four referenced paths (`reference/interview.md`, `reference/directions.md`, `reference/candidate-spec.md`, `reference/distill.md`) are missing while only `scripts/` and `assets/picker/` exist. Dangling references for the majority of phase detail is a major organization gap, not the minor one anchor 4 allows, though structure and signaling are far above anchor 2's buried/inlined-content pattern.

3 / 5

Total

17

/

20

Passed

Description

87%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 three-step capability statement, an explicit and appropriately restrictive trigger clause with anti-trigger guidance, and clear distinctiveness. The only weakness is somewhat narrow keyword coverage beyond the exact invocation terms.

DimensionReasoningScore

Specificity

Names three parameterized concrete actions — "Generate 4-6 complete candidate design systems", "let the user pick one visually in the browser", "freeze the winner into a Google-spec design.md at the project root" — covering the core pipeline. Secondary capabilities (interview/brief, validation, linting) are omitted, so coverage has minor gaps rather than being comprehensive.

4 / 5

Completeness

Explicitly answers both questions: what ("Generate 4-6 complete candidate design systems ... freeze the winner into a Google-spec design.md") and when ("Use ONLY when the user explicitly invokes /design-md or explicitly asks to run the design-system picker"), with concrete trigger phrases plus explicit anti-trigger guidance. Matches the anchor-5 example structure.

5 / 5

Trigger Term Quality

Includes the natural invocation terms for its niche — "explicitly invokes /design-md", "design-system picker", "design.md" — so good keyword coverage with only a few natural variants missing (e.g., "visual style", "pick a design direction"). Not 5 because synonym coverage is narrow; not 3 because the phrases a user would actually say to trigger it are present.

4 / 5

Distinctiveness Conflict Risk

The explicit-invocation gate ("Use ONLY when the user explicitly invokes /design-md") and the distinct deliverable (a project-root design.md) give it a clear niche with minimal false-trigger risk; it may under-trigger, but it will not fire for the wrong skill.

5 / 5

Total

18

/

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

KennethJefferson/ccg_ccSkill_DesignMD

Path

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