CtrlK
BlogDocsLog inGet started
Tessl Logo

patch-notes

Player-facing patch notes from git history and changelogs. Translates developer language into player communication.

57

Quality

72%

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 ./.claude/skills/patch-notes/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 an exceptionally actionable, well-gated workflow: every phase has concrete commands, exact stop/ask messages, and validation checkpoints, including strong feedback loops around the risky provenance and file-write steps. Its weaknesses are verbosity in the provenance rationale (the revision-history justification and failure war story) and a monolithic single-file layout where the style templates could be split out.

Suggestions

Cut the "earlier version of this check" blockquote and the "Why this is a hard stop" war story down to one or two operative sentences (e.g. "Framework commits rendered as player copy has produced false player-facing fixes; exclude, don't stop") — the rules themselves already fully specify behavior.

Move the three full style templates (Brief/Detailed/Full) into a references/ file (e.g. references/templates.md) and keep a one-line pointer per style in Phase 4, which would also let the body serve as a leaner overview.

Tighten the provenance classification list and the corroborate paragraph — the Game/Framework/Unclear definitions can be stated in half the lines without losing the decision rules.

DimensionReasoningScore

Conciseness

The body is mostly dense, operative instruction (paths, commands, templates) and assumes Claude's competence about git and markdown, but the Provenance section carries noticeable padding: the blockquote relitigating "An earlier version of this check listed... The danger was never that such commits exist" and the "Why this is a hard stop, not a warning" war story (~25 lines of rationale/history) could be cut to the operative rule. That fits anchor 3 ("Mostly efficient but includes some unnecessary explanation or could be tightened") rather than anchor 4, where such trimmable passages would be only minor.

3 / 5

Actionability

Guidance is fully executable: exact commands (`git log --oneline -20`), specific source paths (`production/releases/[version]/changelog.md`, `docs/CHANGELOG.md`, `design/balance/`), verbatim blocked/stop messages to deliver, concrete dev→player translation examples with before→after values, and three copy-paste-ready output templates covering the common cases. This matches the anchor-5 example of copy-paste-ready output covering common cases; anchor 4 would imply minor gaps in the concrete guidance, and there are none of substance.

5 / 5

Workflow Clarity

Phases 1–7 are clearly sequenced with explicit validation checkpoints: a provenance gate before Phase 2 (with a per-commit classification rubric and stop message), a no-changelog-data branch with a recovery path ("Run /changelog [version] first"), a Phase 5 output review checklist, and an ask-before-write gate before the file-writing batch operation with both outcomes specified. Feedback loops and error-recovery guidance match anchor 5; anchor 4 would require a missing checkpoint, and the risky operations (provenance, writes) are all gated.

5 / 5

Progressive Disclosure

The skill is a single file with no bundle files (no references/, scripts/, or assets/ exist) and no external skill references, so there is no nesting or buried-reference problem; sections are well-labeled and each phase is self-contained. It does not meet anchor 5's "well-signaled one-level-deep references" structure — the three full style templates and the categorization/translation tables are inlined where a reference file could carry the bulk — placing it at anchor 4 ("Good structure; most content is appropriately placed; minor organization gaps"). The under-50-line simple-skill exception does not apply to this ~245-line body.

4 / 5

Total

17

/

20

Passed

Description

53%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 is concise, third-person, and clearly communicates what the skill produces, but it omits any explicit "when to use" trigger guidance and misses the natural synonym "release notes". It sits at a solid midpoint: specific enough to distinguish, not complete enough to trigger reliably.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks for patch notes or release notes for a game version, or when preparing player-facing release communication."

Include the common synonym "release notes" and related phrasings (e.g. "community update") so the description matches what users actually say.

Optionally mention the concrete deliverable (a saved patch-notes markdown file in three styles) to round out the 'what' without adding fluff.

DimensionReasoningScore

Specificity

The description names the domain ("patch notes") and two concrete actions — "from git history and changelogs" (sourcing) and "Translates developer language into player communication" — but coverage is not comprehensive (no mention of writing/saving output, styles, or categorization). This matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") rather than anchor 4, which expects several listed specific actions.

3 / 5

Completeness

The "what" is clear (generate player-facing patch notes from git history/changelogs, translating developer language), but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied by the topic itself. Per the judging guidelines, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

"patch notes", "git history", and "changelogs" are natural, relevant keywords, but the most common synonym a user would say — "release notes" — is absent, as are variations like "player communication" vs. "community post". This fits anchor 3 ("Some relevant keywords but missing common variations or synonyms") better than anchor 4, which requires near-complete keyword coverage.

3 / 5

Distinctiveness Conflict Risk

"Player-facing patch notes" carves out a clear niche (player communication vs. internal changelogs) that is unlikely to fire for unrelated skills. There is minor overlap risk with a closely related changelog/release skill (the body itself references a sibling /changelog skill), so this matches anchor 4 rather than anchor 5's "minimal conflict risk" with fully distinct triggers.

4 / 5

Total

13

/

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