CtrlK
BlogDocsLog inGet started
Tessl Logo

game-design

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

64

Quality

52%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agent/skills/game-development/game-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description identifies a clear domain (game design) but fails to specify concrete actions Claude would perform and lacks any guidance on when to use the skill. It reads more like a topic list than an actionable skill description, making it difficult for Claude to know when to select it over other skills.

Suggestions

Add a 'Use when...' clause with explicit triggers like 'Use when the user asks about game design documents, gameplay balancing, player engagement mechanics, or progression systems'

Convert topic areas into concrete actions: 'Creates and structures game design documents, analyzes gameplay balance, designs progression systems and player engagement loops'

Expand trigger terms to include common variations: 'GDD', 'game design document', 'gameplay mechanics', 'level design', 'game balance', 'player retention'

DimensionReasoningScore

Specificity

Names the domain (game design) and lists some relevant concepts (GDD structure, balancing, player psychology, progression), but these are topic areas rather than concrete actions Claude would perform.

2 / 3

Completeness

Only partially addresses 'what' through topic listing, and completely lacks any 'when' guidance or 'Use when...' clause. No explicit triggers for when Claude should select this skill.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'GDD', 'balancing', 'progression' that users might mention, but missing common variations like 'game design document', 'gameplay mechanics', 'level design', or 'game balance'.

2 / 3

Distinctiveness Conflict Risk

'Game design' is a specific domain that reduces conflict with general skills, but the vague framing could overlap with other creative or documentation skills. 'GDD' provides some distinctiveness.

2 / 3

Total

7

/

12

Passed

Implementation

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill excels at concise, well-organized presentation of game design concepts using efficient tables and minimal prose. However, it functions more as a reference card than actionable guidance—it tells Claude what concepts exist but not how to apply them in practice. The content would benefit from concrete examples of applying these principles to actual game design tasks.

Suggestions

Add a concrete example showing how to write a GDD pitch and core loop section for a specific game concept

Include a workflow for balancing: specific steps like 'playtest → gather metrics → adjust values → retest' with validation criteria

Provide actionable guidance on how to identify which player motivation type a game targets and design accordingly

DimensionReasoningScore

Conciseness

Extremely lean and efficient use of tables and minimal prose. Every section delivers information without explaining concepts Claude already knows (like what a GDD is or basic psychology). No padding or unnecessary context.

3 / 3

Actionability

Provides conceptual frameworks and categorizations but lacks executable guidance. No code examples, specific tools, or copy-paste ready implementations. The content describes design principles rather than instructing how to apply them in practice.

2 / 3

Workflow Clarity

The core loop design shows a clear sequence, but there are no validation checkpoints or feedback loops for the design process itself. The GDD section lists components but doesn't sequence how to create one. Missing explicit steps for iterating on designs.

2 / 3

Progressive Disclosure

For a conceptual skill under 50 lines with no need for external references, the content is well-organized with clear section headers, consistent table formatting, and logical flow from core concepts to anti-patterns. Easy to navigate and scan.

3 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

10

/

11

Passed

Repository
lchenrique/politron-ide
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.