CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

game-design

Game design principles. GDD structure, balancing, player psychology, progression.

Quality

60%

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

Quality

Content

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

A tidy, table-driven reference that is pleasant to read but functions as a condensed textbook summary of game-design knowledge Claude already has, rather than skill-specific guidance. It lacks worked examples, templates, and any sequenced application workflow, which caps its practical value.

Suggestions

Cut or compress sections that restate common knowledge (Bartle player types, flow-state curve) and replace them with material Claude would not generate on its own, such as a filled-in example GDD or a concrete playtest question checklist.

Add a short sequenced workflow for the skill's real use cases (e.g., '1. Extract the core loop, 2. Check it against the 30-second test, 3. Map progression/pacing, 4. List anti-pattern risks') with explicit checkpoints.

Move any expanded material (full GDD template, per-genre loop breakdowns) into reference files linked from SKILL.md, and delete the vacuous 'When to Use' filler line at the end.

DimensionReasoningScore

Conciseness

Phrases like 'Every game needs a fun 30-second loop' and the Bartle-type 'Achiever / Explorer / Socializer / Killer' table are compact in style, but the body largely restates game-design concepts (core loops, flow state, reward schedules) Claude already knows, so much of the token spend adds little new information. It sits above 'noticeably verbose/padded' (2) but below 'efficient, only minor trimming needed' (4).

3 / 5

Actionability

The GDD 'Essential Sections' table and the 'Anti-Patterns' Don't/Do table give usable concrete frameworks, but there are no worked examples, filled templates, or specific procedures — e.g. 'Keep it living (update regularly)' and 'Early wins (hook quickly)' are high-level hints rather than executable guidance. This matches 'some concrete guidance but incomplete' and falls short of 'mostly executable guidance with minor gaps' (4).

3 / 5

Workflow Clarity

The body is organized as six topical sections with the 4-step core loop ('ACTION → FEEDBACK → REWARD → REPEAT'), but no multi-step process for applying the material (e.g., how to run a design review or build a GDD) is sequenced, and no checkpoints exist. It is above 'rough sequence with many gaps' (2) because sections are coherent and numbered, but below 'clear sequence with most checkpoints' (4).

3 / 5

Progressive Disclosure

Six clearly headed sections with consistently formatted tables make the ~127-line body easy to navigate, and the single-file size is appropriate with no buried references (none exist). It misses 5 because the trailing 'When to Use' section is generic filler ('applicable to execute the workflow or actions described in the overview') and a domain this broad could signal deeper material (GDD template, playtest scripts) in reference files.

4 / 5

Total

13

/

20

Passed

Description

48%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 identifies a distinct, well-scoped domain but reads as a topic index rather than a capability statement: no verb-led actions and no 'use when' trigger clause. It would surface for game-design requests but would not reliably communicate what Claude actually does with this skill.

Suggestions

Rewrite with third-person concrete actions, e.g., 'Structures game design documents, designs core gameplay loops, and balances difficulty and progression curves.'

Add an explicit trigger clause: 'Use when the user asks about game design, writing or reviewing a GDD (game design document), balancing difficulty, or designing player progression.'

Include natural synonyms users would say — 'game design document', 'difficulty tuning', 'playtesting' — alongside the existing keywords.

DimensionReasoningScore

Specificity

'Game design principles. GDD structure, balancing, player psychology, progression.' names the domain and topics but contains no actions at all — it is a list of noun phrases, not 'Designs X' or 'Writes Y'. This matches 'Names the domain but actions are minimal or generic' rather than 3, which requires 1-2 concrete actions.

2 / 5

Completeness

The 'what' is reasonably clear (game design guidance covering GDD, balancing, psychology, progression), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is above 2 because the 'what' is not vague, and below 4 because 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Terms like 'game design', 'GDD', 'balancing', and 'progression' are ones a user might naturally say, but coverage is thin: it misses common variations such as 'game design document' (spelled out), 'difficulty tuning', 'level design', and 'playtesting'. This fits 'some relevant keywords but missing common variations or synonyms' rather than 4's 'good coverage with only a few missing'.

3 / 5

Distinctiveness Conflict Risk

Game design is a clear niche with domain-specific terms (GDD, core loop, balancing), so overlap risk with unrelated skills is minor — matching 'mostly distinct; minor overlap risk'. It falls short of 5 because the anchor example pairs the niche with explicit trigger phrases, which this description lacks, leaving mild overlap risk with adjacent skills (e.g., general design or UX psychology skills).

4 / 5

Total

12

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/game-development/game-design/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.