CtrlK
BlogDocsLog inGet started
Tessl Logo

build-game-changelog

Design, implement, backfill, audit, and release in-game changelogs with contiguous versioning, deployment provenance, menu-state navigation, accessible toggle, close, and Escape behavior, and responsive release-ledger UI. Use when Codex needs to add or revise a changelog or version screen in a game, reconstruct release history from deployments and Git, define version-bump rules, keep displayed versions synchronized with live builds, or test changelog mechanics across desktop and mobile.

75

Quality

92%

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.

A well-crafted instruction-style skill body: imperative, non-redundant in substance, with explicitly sequenced workflows, thorough validation checkpoints, and a clean split of doctrine (inline) from executable implementation detail (one clearly-signaled, one-level-deep reference). The only trim opportunity is the partial overlap between 'Avoid these failures' and earlier sections.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout — every bullet is a directive and it explains nothing Claude already knows (no 'what a changelog is' padding). It falls short of the lean score-5 anchor because the 'Avoid these failures' section partially restates earlier directives (e.g., "Do not create one version per commit" restates the bump rules; "Do not register duplicate Escape handlers" restates the single-close-route rule), which could be trimmed. It is well above score 3, which requires unnecessary explanation rather than minor redundancy.

4 / 5

Actionability

The guidance is concrete and specific throughout: a default version scheme with exact examples ("0.9.0", "0.9.1", "0.9.2"), an enumerated entry schema, exact ARIA attributes ("aria-expanded", "aria-controls"), named close affordances to unify, a contrasting note example ("'Restore vitality at checkpoints' over 'Various fixes'"), and a fully enumerated validation contract. As an instruction-only skill whose executable detail lives in the referenced reference-architecture.md (which contains complete TS examples), the absence of inline code is not penalized and the guidance matches the fully-executable anchor.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with strong validation checkpoints: "Start from truth" inspection steps, the backfill procedure ending with "Verify the ledger count, ordering, uniqueness, and version continuity", and the 10-step "Release safely" order with explicit verification ("Confirm the deployment succeeded", "Verify the live game shows the expected version", "Reconcile or stop if the deployment sequence differs from the ledger"). Error-recovery loops ("mark provenance unknown... or stop for clarification") satisfy the feedback-loop requirement.

5 / 5

Progressive Disclosure

The body is a well-organized overview of doctrine and rules, while implementation detail (schema, state machine, input priority, tests) is split into a single one-level-deep reference, clearly signaled with purpose-scoped navigation: "See [references/reference-architecture.md](references/reference-architecture.md) when implementing the schema, state machine, or tests." The referenced file exists, is self-contained with no nested references, and its content matches the body's directives — matching the clear-overview anchor with easy navigation.

5 / 5

Total

19

/

20

Passed

Description

92%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 strong description with comprehensive, concrete capability coverage and an explicit, multi-trigger 'Use when' clause in third-person voice. The only gap is synonym coverage: common user phrasings like 'patch notes' and 'release notes' would not match the current triggers.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions spanning the full lifecycle — "Design, implement, backfill, audit, and release in-game changelogs" — plus specific capabilities ("contiguous versioning, deployment provenance, menu-state navigation, accessible toggle, close, and Escape behavior, and responsive release-ledger UI"), matching the comprehensive-coverage anchor exactly. It exceeds the score-4 anchor, which allows minor coverage gaps; no capability area of the skill body is missing.

5 / 5

Completeness

It explicitly answers both questions: the first sentence gives a concrete "what" with enumerated capabilities, and "Use when Codex needs to add or revise a changelog or version screen in a game, reconstruct release history from deployments and Git, define version-bump rules, keep displayed versions synchronized with live builds, or test changelog mechanics" provides concrete, multiple trigger phrases. This matches the score-5 anchor and clearly exceeds score 4, whose 'when' clause is less explicit.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "changelog", "version screen", "release history", "deployments", "Git", "version-bump rules", "displayed versions", "game", "desktop and mobile" — but a few natural synonyms are missing. Notably "patch notes" and "release notes", the most common user phrasings for this domain, are absent, which fits the score-4 anchor (good coverage, a few natural terms missing) rather than the score-5 comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The domain is tightly scoped to in-game changelogs ("in-game changelogs", "version screen in a game", "menu-state navigation", "controller cancel", "live builds"), giving it a clear niche with distinct triggers and minimal conflict risk versus generic changelog or versioning skills. It is not the score-4 case because there is no meaningful overlap risk with closely related skills — the game-specific framing is carried through every trigger.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
MengTo/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.