CtrlK
BlogDocsLog inGet started
Tessl Logo

changelog

Create changelog files for important commits in a PR

63

Quality

73%

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/changelog/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 strong, highly actionable instruction set: concrete commands, exact file-naming conventions, good and bad entry examples, and a built-in verification step. Its only weaknesses are mild redundancy in the filename-type listing and slightly heavy example prose in rule 7.

DimensionReasoningScore

Conciseness

The body is efficient overall — a copy-paste git command, terse format rules, and a compact example — but the per-type filename bullet list is largely redundant with the "Allowed types" line, and rule 7's Good/Bad example block is heavier than needed. These are minor instances of over-explanation that could be trimmed, matching anchor 4 rather than the lean anchor 5.

4 / 5

Actionability

Guidance is fully executable: a copy-paste-ready `git log main..HEAD --oneline` command, an exact `{PR_NUMBER}.{type}.md` naming scheme with the multi-entry suffix convention, explicit entry-format rules (single leading `- ` line, indented detail lines, ⚠️ prefix), and concrete example files. Not anchor 4's "minor gaps" — the common cases are completely specified.

5 / 5

Workflow Clarity

Steps 1–8 form a clear numbered sequence (skip criteria → inspect commits → write entries → review) with an explicit validate-and-fix loop in step 8 ("run /prose-review changelog/ and fix anything it flags"), satisfying the batch-operation validation requirement. Minor gaps — no handling for a missing changelog/ directory and no description of re-checking after fixes — keep it below anchor 5.

4 / 5

Progressive Disclosure

This is a simple, single-purpose skill with no bundle files, and everything is appropriately inlined in one well-organized file with clear ## Instructions and ## Example sections. There is no content that belongs in a separate reference and no nested referencing, fitting the simple-skill case of a clear, well-organized single file.

5 / 5

Total

18

/

20

Passed

Description

61%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 and clearly states a single concrete capability in third person, but it lacks any "when to use this" trigger guidance and misses common synonyms like "release notes". Adding an explicit trigger clause would substantially raise both completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. "Use when a PR includes user-facing changes and the project uses a changelog/ folder, or when the user mentions changelogs or release notes."

Include natural synonyms such as "release notes" or "CHANGELOG" alongside "changelog" to broaden keyword coverage for trigger matching.

Mention one or two additional concrete actions (e.g., the entry types followed, or running a prose review on the entries) to move specificity beyond a single action.

DimensionReasoningScore

Specificity

"Create changelog files" names the domain and one concrete action, but no other actions or format detail are stated. It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' rather than anchor 4, which expects several specific actions listed.

3 / 5

Completeness

The description has a clear "what" ("Create changelog files for important commits in a PR") but no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not score 2 because the "what" is specific, not vague.

3 / 5

Trigger Term Quality

"changelog", "commits", and "PR" are natural terms users would say when needing this skill, giving good keyword coverage. It falls short of anchor 5 because common synonyms and variations such as "release notes" or "CHANGELOG.md" are missing.

4 / 5

Distinctiveness Conflict Risk

The changelog-for-PRs framing carves out a fairly distinct niche with a clear artifact, so it is mostly distinguishable from other skills. Minor overlap risk remains with closely related skills like commit-message generation or general release-notes writing, keeping it below anchor 5.

4 / 5

Total

14

/

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
pipecat-ai/pipecat
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.