CtrlK
BlogDocsLog inGet started
Tessl Logo

docs-changelog

Generates and formats changelog files for a new release based on provided version and raw changelog data.

56

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/docs-changelog/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is a well-structured, actionable multi-step procedure that offloads templates to real reference files and includes a formatting feedback loop. Its main gaps are minor redundancy across patch paths, no pre-replace validation for destructive overwrites, and the absence of an explicit navigation overview.

DimensionReasoningScore

Conciseness

The body is a lean procedure with no padding about concepts Claude already knows; minor redundancy between Path A and Path B subsections keeps it just below fully lean.

4 / 5

Actionability

Concrete guidance throughout — exact header lines ("# Latest stable release: {{version}}"), specific URL transformation examples, and real template file paths — with only minor reliance on Claude generating summary text without an exact spec.

4 / 5

Workflow Clarity

A clear decision-tree sequence (Path A/B, A.1/A.2, B.1/B.2) with a Finalize feedback loop (npm run format with retry on failure); the destructive "completely replace" steps lack a pre-replace validation checkpoint, a minor gap that holds it at 4 rather than 5.

4 / 5

Progressive Disclosure

Templates and examples are appropriately split into real one-level-deep reference files (highlights_examples.md, index_template.md, latest_template.md, preview_template.md), all clearly signaled inline; lacks a single overview/navigation summary, so it is just shy of 5.

4 / 5

Total

16

/

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 states a clear purpose and domain but lacks an explicit "Use when..." trigger clause and broader synonym coverage. It is specific enough to be distinct yet not comprehensive enough to score above mid-range.

Suggestions

Add an explicit "Use when..." clause naming concrete trigger phrases, e.g. "Use when generating or updating changelog files for a new release, release notes, or version bumps."

Expand the action list with specific operations (e.g., prepending "What's Changed" entries, updating version headers, rewriting Full Changelog URLs) to raise specificity.

Include natural synonyms like "release notes" and reference the concrete target files (latest.md, preview.md, index.md) to improve trigger-term coverage.

DimensionReasoningScore

Specificity

"Generates and formats changelog files for a new release based on provided version and raw changelog data" names the domain (changelog files) and two concrete actions (generates, formats), but stops short of the fuller action list needed for a 4.

3 / 5

Completeness

The "what" is clearly stated, but there is no "Use when..." or equivalent explicit trigger clause, so per the judging guideline completeness is capped at 3.

3 / 5

Trigger Term Quality

Terms like "changelog files", "new release", and "raw changelog data" are relevant, but common synonyms such as "release notes" and file extensions are absent, matching the "some relevant keywords but missing common variations" anchor.

3 / 5

Distinctiveness Conflict Risk

Release/changelog generation is a clear niche with distinct triggers and only minor overlap risk with general documentation skills, fitting the "mostly distinct; minor overlap" anchor above the 3.

4 / 5

Total

13

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
google-gemini/gemini-cli
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.