CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-all-gdds

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

Quality

84%

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

92%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 exemplary orchestration skill: the body stays a lean overview that delegates each phase to a real, well-signaled reference file, while retaining fully concrete sub-agent contracts, explicit validation/artifact-verification steps, and error-recovery feedback loops. The only notable inefficiency is the sevenfold repetition of the compaction-reminder clause.

DimensionReasoningScore

Conciseness

The body is an efficient orchestrator with no explanations of concepts Claude already knows, but the clause "Read it again if the conversation was compacted or resumed during this phase" is repeated verbatim once per phase (seven times) and the Error Recovery preamble is wordy — minor trims keep it at the 4 anchor rather than the every-token-earns-its-place 5.

4 / 5

Actionability

Guidance is fully concrete: exact section slices per sub-agent ("Phase 2 needs Dependencies, Detailed Design/Rules, Formulas, Tuning Knobs and Acceptance Criteria"), exact paths (design/registry/entities.yaml, docs/engine-reference/[engine]/VERSION.md), subagent_type: game-designer, explicit checklist assignments (2a–2f, 3a–3g), and enumerated argument modes with per-mode behavior.

5 / 5

Workflow Clarity

A clearly sequenced 7-phase workflow with explicit parallelization contracts, and strong validation checkpoints: the Error Recovery Protocol requires verifying the named artifact exists on disk before treating a phase as done ("a named artifact that is not on disk is a failed phase, however fluent the response reads"), with BLOCKED handling, retry scope, and a guaranteed partial report.

5 / 5

Progressive Disclosure

Verified against the actual bundle: all seven referenced files (references/1-load.md through 7-handoff.md) exist, each is clearly signaled per phase ("Read references/N.md now and follow it"), and spot-checks confirm they contain the promised phase steps with no deeper nesting — SKILL.md remains a true one-level-deep overview.

5 / 5

Total

19

/

20

Passed

Description

71%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 specific, domain-fluent description that clearly communicates what the skill reviews, with good natural trigger terminology. Its main weakness is the absence of any explicit "when to use" guidance, which both caps completeness and slightly raises conflict risk against neighboring review skills.

Suggestions

Add an explicit trigger clause, e.g., "Use when all MVP-tier GDDs are approved, before /create-architecture, or after significant mid-production GDD revisions" — this lifts completeness past the cap at 3.

Include a one-phrase distinction from sibling skills (e.g., "reviews all GDDs together, unlike /design-review which checks one GDD") to reduce trigger overlap with closely related review skills.

Add one or two natural synonyms users might say, such as "GDD consistency" or "game balance review", to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists five concrete review activities ("contradictions between systems, dominant strategies, economic imbalance, cognitive overload, pillar drift") covering both the consistency and design-holism passes, which is comprehensive coverage for a review skill rather than the minor gaps of the 4 anchor.

5 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines; the "when" is only weakly implied by the domain framing.

3 / 5

Trigger Term Quality

Natural domain phrases like "cross-GDD review", "dominant strategies", and "pillar drift" match what a game-design user would say, but common variations and synonyms (e.g., "GDD review", "game balance", "consistency check") are missing, so it falls short of the 5 anchor's synonym-level coverage.

4 / 5

Distinctiveness Conflict Risk

"Holistic cross-GDD review" and "contradictions between systems" carve a clear niche distinct from a per-GDD review, but "review" alone risks overlap with closely related sibling skills (e.g., /design-review, /consistency-check) without an explicit all-GDDs-vs-one distinction, matching the 4 anchor rather than the minimal-conflict 5.

4 / 5

Total

16

/

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

Path

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