CtrlK
BlogDocsLog inGet started
Tessl Logo

quick-design

Lightweight spec for small changes — tuning adjustments, minor mechanics. Embeds directly into stories; skips full GDD.

57

Quality

72%

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/quick-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 a highly actionable, well-sequenced workflow with strong validation checkpoints and copy-paste-ready templates for all four change categories. Its main weakness is moderate duplication of redirect criteria and next-step guidance, which inflates length without adding information.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete templates, but the redirect criteria are stated twice (Section 1's "If the change does NOT fit these categories" list and Section 5 Pipeline Notes' four-bullet redirect list), and next-step guidance is duplicated between the Handoff output block and Recommended Next Steps. This is more than the "minor instances" of over-explanation that anchor 4 allows, but well short of the padded explaining-foundational-concepts pattern of anchor 2.

3 / 5

Actionability

Fully executable instruction guidance: copy-paste-ready AskUserQuestion prompts with exact option labels, three complete spec templates with tables and placeholder fields, exact output and handoff blocks, and concrete file-naming examples (e.g., "jump-height-tuning-2026-03-10"). Anchor 5 — a spec writer can follow this without inventing structure.

5 / 5

Workflow Clarity

Clear five-step sequence (Classify → Context Scan → Draft → Approval and Filing → Handoff) with explicit validation checkpoints at every decision point: classification confirmation widget, approve/revise loop with re-presentation, explicit permission before writing the file, and separate explicit approval (with old-vs-new text shown) before any GDD edit. The revise → re-present loop is a proper feedback loop, matching anchor 5.

5 / 5

Progressive Disclosure

A single well-sectioned file with numbered stages and clear headers; the three full spec templates are working content used on every run, so inlining them is defensible, though they could be split into references/ to slim the ~290-line body. Good structure with minor organization gaps fits anchor 4; not 5 because nothing is split out at all and the file exceeds the simple-skill size range.

4 / 5

Total

17

/

20

Passed

Description

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

The description communicates a clear niche (lightweight spec vs. full GDD) with a couple of concrete characteristics, but it lacks any "Use when..." trigger guidance and misses the natural phrasings users would say when they need it. It is serviceable but below the quality of the reference good examples.

Suggestions

Add an explicit trigger clause, e.g., "Use when a change is too small for a full GDD: tuning a value, a minor tweak, or a small addition to an existing system."

Include natural trigger terms and synonyms users would actually say — "tweak", "balance change", "minor adjustment", "quick spec" — to improve trigger-term coverage.

State the concrete output, e.g., "Writes a quick design spec to design/quick-specs/", to sharpen the description of what the skill does.

DimensionReasoningScore

Specificity

Names the domain ("small changes — tuning adjustments, minor mechanics") and 1-2 concrete characteristics ("Embeds directly into stories; skips full GDD"), but does not state concrete actions or the output artifact. Not 4 because it lists only two properties rather than several specific actions; not 2 because both domain and some concrete behavior are named.

3 / 5

Completeness

The "what" is clear (lightweight spec that embeds into stories and skips the full GDD), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because a 4 requires both what and an explicit, if imperfect, when.

3 / 5

Trigger Term Quality

"tuning adjustments", "minor mechanics", and "small changes" are relevant keywords, but common user phrasings like "tweak", "balance change", "minor fix", or "quick spec" are missing. Anchor 3 (some relevant keywords, missing common variations) fits better than 4, which expects broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

"skips full GDD" clearly positions this as the lightweight alternative to the heavyweight design path, giving it a mostly distinct niche with only minor overlap risk against the sibling full-GDD skill. Not 5 because the description alone doesn't include trigger phrases that fully disambiguate it from closely related design skills.

4 / 5

Total

13

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

13

/

16

Passed

Repository
Donchitos/Claude-Code-Game-Studios
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.