CtrlK
BlogDocsLog inGet started
Tessl Logo

game-design

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

43

Quality

44%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/game-development/game-design/SKILL.md

The canonical home for this skill is game-design in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

40%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 well-organized but conceptual knowledge reference: it tabulates game-design frameworks without executable procedures or a multi-step workflow. It is concise enough but reads as reference material rather than actionable guidance.

Suggestions

Convert the frameworks into actionable procedures, e.g. a step-by-step method to draft a GDD or to balance a difficulty curve with concrete checkpoints.

Trim the re-explanation of well-known concepts (Bartle types, flow state, reward schedules) and keep only the skill-specific application guidance.

Add a worked example that walks through applying the 30-second core loop to a sample game so the guidance is executable rather than descriptive.

DimensionReasoningScore

Conciseness

The body is compact and tabular, but it re-explains concepts Claude likely already knows (Bartle motivation types, flow state, reward schedules), placing it at 'mostly efficient but includes some unnecessary explanation.'

3 / 5

Actionability

It is largely a descriptive reference of principles; frameworks like the 30-second loop and GDD section list are high-level hints rather than concrete executable steps, matching 'minimal concrete guidance; high-level hints but missing the specific steps to execute.'

2 / 5

Workflow Clarity

There is no multi-step process or sequenced workflow in the body; it is organized into conceptual sections with no checkpoints or validation, fitting 'rough sequence present but many gaps; validation absent.'

2 / 5

Progressive Disclosure

Content is well-organized into six numbered sections with clear headers and tables, and no external references are needed, but it is a monolithic single-file dump over 50 lines with minor organization gaps.

4 / 5

Total

11

/

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 clearly identifies a niche domain and lists relevant sub-topics but is written as noun phrases with no concrete actions and no 'Use when' trigger guidance. It is distinct but lacks the trigger phrasing needed for strong completeness and trigger quality.

Suggestions

Add concrete verbs describing what the skill does, e.g. 'Structures GDDs, balances difficulty curves, and designs progression systems.'

Append an explicit trigger clause such as 'Use when designing or reviewing games, writing a GDD, or balancing gameplay and progression.'

Include common synonyms users might say (e.g. 'game balance', 'level design', 'game mechanics') to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("Game design principles") and several sub-topics ("GDD structure, balancing, player psychology, progression") but uses no concrete verbs or actions, matching the 'names the domain but actions are minimal or generic' anchor.

2 / 5

Completeness

There is a clear 'what' (game design principles and listed sub-areas) but no 'when' guidance, and the missing 'Use when...' clause caps completeness at 3 per the rubric guidelines.

3 / 5

Trigger Term Quality

Terms like 'game design', 'balancing', 'progression', and 'player psychology' are reasonably natural, but coverage lacks synonyms/common variations and includes no explicit use-trigger phrase, fitting 'some relevant keywords but missing common variations.'

3 / 5

Distinctiveness Conflict Risk

Game design is a clear niche and the listed triggers (balancing, progression, player psychology) are game-specific, leaving only minor overlap risk with adjacent design 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.

Validation15 / 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
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.