CtrlK
BlogDocsLog inGet started
Tessl Logo

review-all-gdds

Holistic cross-GDD review — contradictions between systems, dominant strategies, economic imbalance, cognitive overload, pillar drift.

60

Quality

75%

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/review-all-gdds/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.

An exceptionally actionable, well-sequenced review workflow with strong validation and failure-mode guardrails — the strongest content is its executable precision. Its weaknesses are repetition of the same guardrail and a monolithic single-file structure that inlines checklist and template material a references/ bundle should carry.

Suggestions

Move the detailed Phase 2/3 checklists and the Phase 5 report template into references/ files (e.g., references/consistency-checks.md, references/report-template.md), keeping SKILL.md as the workflow overview.

Consolidate the zero-match/fail-open guardrail into one stated rule with a pointer instead of restating it in Phase 1a, Phase 1c, and the review-set discussion.

Tighten the ISO-date rationale and the NOT ASSESSED ranking prose to the operative rule each establishes, trimming the surrounding justification.

DimensionReasoningScore

Conciseness

The body is dense, non-pedagogical instruction with no concept explanations Claude already knows, but it restates the same guardrail three times (zero-match/fail-open handling in Phase 1a, Phase 1c, and the 'never shrinks the review set' repeats) and the ISO-date and NOT ASSESSED rationales run long. This fits anchor 3 ('mostly efficient but could be tightened') better than 4, where only minor trimming would be needed.

3 / 5

Actionability

Fully executable throughout: exact Grep patterns with flags and glob paths, a runnable scope script with a specified output contract, verbatim AskUserQuestion prompts and options, a copy-paste session-state block, and a complete report template. Phase checklists (2a-2f, 3a-3g) each include concrete output formats.

5 / 5

Workflow Clarity

Phases 1-7 are clearly sequenced with explicit validation checkpoints at every risky boundary: fail-open Summary handling, zero-match escalation to full reads, artifact-existence verification before treating a phase as done, NOT ASSESSED verdicts distinguishing unrun phases from clean ones, an error-recovery protocol with partial reports, and permission gates before any write. Feedback loops (fallback to full mode when PRIOR_REVIEW is NONE, retry with reduced scope) are explicit.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~780-line SKILL.md inlines everything — detailed phase checklists, the full report template, and scenario walkthrough examples — where the rubric rationale expects SKILL.md to be an overview pointing to reference material. Section headers are clear, but content that clearly belongs in separate files is inlined (anchor 3); it is not score 2 because the structure is genuinely well-organized and navigable.

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.

A terse, domain-fluent description that clearly states what the skill finds, but it lacks any "use when" trigger guidance and leans on a single action verb, so it under-serves discovery and completeness. Adding an explicit trigger clause and expanding GDD terminology would raise it substantially.

Suggestions

Add a 'Use when...' clause naming concrete trigger moments (e.g., 'Use when all MVP-tier GDDs are approved, after a GDD is significantly revised, or before creating architecture').

Expand the acronym and add synonyms — 'GDD (game design document)', 'cross-system consistency', 'GDD contradictions' — so users' natural phrasings match.

Briefly distinguish from the related per-GDD /design-review skill in the description itself, not only in the body.

DimensionReasoningScore

Specificity

Names the domain ("Holistic cross-GDD review") and five concrete finding types ("contradictions between systems, dominant strategies, economic imbalance, cognitive overload, pillar drift"), but relies on a single action verb rather than multiple distinct actions, matching anchor 4 rather than the comprehensive multi-action anchor 5.

4 / 5

Completeness

The "what" is clear (a holistic review finding five named issue classes), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines; it is not score 2 because the "what" is concrete and specific.

3 / 5

Trigger Term Quality

Includes natural domain terms ("GDD", "review", "contradictions", "dominant strategies") but never expands GDD to "game design documents" and omits synonyms like "consistency" or "design review", so good coverage with a few natural terms missing (anchor 4) rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

"Holistic cross-GDD review" carves a clear niche and the issue list is distinctive, but the project's closely related /design-review skill overlaps, and the description alone does not fully disambiguate the two — mostly distinct with minor overlap risk (anchor 4), not a fully conflict-free niche.

4 / 5

Total

15

/

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

skill_md_line_count

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

Warning

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

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.