CtrlK
BlogDocsLog inGet started
Tessl Logo

qa-plan

QA test plan for a sprint — classifies stories by Logic/Integration/Visual/UI, covers automated tests, manual cases, smoke scope.

60

Quality

76%

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/qa-plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a strongly operational skill: every phase gives copy-paste-ready commands, exact paths, a complete output template, and explicit validation guards with mandatory failure routing. Its weaknesses are localized verbosity (design-rationale prose in the guard blocks) and the absence of any progressive-disclosure structure — the full plan template and protocol could live in reference files.

Suggestions

Move the Phase 4 output template to references/plan-template.md and include only the section skeleton inline, trimming SKILL.md by ~100 lines.

Cut the design-history meta-commentary from the N=0 guard block (the /story-readiness comparison and 'harder half of the rule' notes), keeping only the operational rule and routing.

Consider moving the Collaborative Protocol and the config-resolution preamble (qa.level / workflow tier rules) into a referenced doc, keeping SKILL.md to the five-phase workflow.

DimensionReasoningScore

Conciseness

The body is mostly dense, project-specific instruction, but it carries trimmable meta-commentary: the N=0 guard block includes design-history prose ("Note the shape, because this skill already had the harder half of the rule... The same shape appears in /story-readiness...") and Phase 2 explains why full reads are costly — rationale Claude does not need to execute the skill. This matches the 'mostly efficient but includes some unnecessary explanation' anchor; it is not 2 because the padding is localized, not pervasive, and not 4 because the meta-commentary blocks are genuinely removable.

3 / 5

Actionability

The guidance is fully executable: exact Grep invocations with patterns, globs, and flags; exact output and evidence file paths; a complete copy-paste plan template ( fenced as a full markdown document ); verbatim AskUserQuestion text and options; the exact silent-append comment for session-state. Placeholders in the template are by-design and explicitly labeled, matching the top anchor.

5 / 5

Workflow Clarity

Five phases are clearly sequenced with explicit validation checkpoints and error-recovery paths: the mandatory N=0 guard ("If the resolved scope contains ZERO stories, stop"), MISSING-and-continue for individual missing files, the "Never treat an absent section as an absent story" fallback with a full-read, per-level config resolution, and terminal verdicts (COMPLETE vs NOT ASSESSED). This matches the anchor requiring explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

There are no references/, scripts/, or assets/ bundle files, so the skill is a single ~358-line document; the ~115-line plan template and the Collaborative Protocol are inlined where a split into reference files would serve progressive disclosure. Section headers and the clearly-signaled .claude/docs/ pointers give it real structure, so it sits at the 'some structure but content that should be separate is inline' anchor rather than 2, but it cannot reach 4 without any bundle-level split.

3 / 5

Total

16

/

20

Passed

Description

66%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 is specific and reasonably rich in natural trigger terms, but it omits any explicit "when to use" guidance, which caps its completeness and weakens its value for triggering. Adding a Use-when clause and a couple of common synonyms (test cases, playtest, quality assurance) would move it close to the top of the scale.

Suggestions

Append an explicit trigger clause, e.g. "Use when a sprint is being planned and the team needs to know what to automate, verify manually, and smoke-test before implementation begins."

Include common user phrasings as trigger synonyms — "test plan", "test cases", "playtest", "quality assurance" — alongside the current vocabulary.

Mention the output artifact (a QA plan document gating QA hand-off) so the description's 'what' covers the deliverable, not just the analysis steps.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "classifies stories by Logic/Integration/Visual/UI", "covers automated tests, manual cases, smoke scope" — matching the anchor for several specific actions with minor gaps. It is not 5 because coverage is incomplete (playtest requirements, the Definition-of-Done checklist, and the output artifact are all unmentioned), and not 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

It clearly answers "what" (classifies stories by test type, covers automated/manual/smoke scope) but contains no "Use when..." clause or equivalent explicit trigger guidance, which the judging guidelines cap at 3. The "when" is entirely absent rather than merely weakly implied, so 4 does not fit.

3 / 5

Trigger Term Quality

Natural keywords users would say are present — "QA test plan", "sprint", "automated tests", "manual cases", "smoke scope" — giving good keyword coverage. A few natural terms are missing ("test plan", "test cases", "playtest", "quality assurance", "testing"), so it falls short of the comprehensive-synonyms anchor 5.

4 / 5

Distinctiveness Conflict Risk

"QA test plan for a sprint" carves a clear niche in a game-dev QA workflow, and the type taxonomy makes it largely distinct. Minor overlap risk remains with closely related sibling skills (/smoke-check, /story-readiness, /story-done) that share the smoke-scope and QA-gating vocabulary, so it is mostly distinct rather than a clear 5.

4 / 5

Total

15

/

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.

Validation — 14 / 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

Total

14

/

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.