CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

update-change-log

To synchronize CHANGELOG.md with changes made last week (mon - sun)

Quality

69%

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/update-change-log/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

Operationally this is a strong skill: the git windowing, dedup checks, HITL gate, and review checklist make the workflow genuinely hard to get wrong. Its weaknesses are structural and editorial: a ~213-line monolithic body with overlapping philosophy sections and an ever-growing lessons log that inflate token cost, and the absence of any reference files to absorb that material.

Suggestions

Move the 'Lessons learned' log and the 'Voice & Tone' / 'Writing Constraints' style rules into a references/ file (e.g. references/style.md, references/lessons.md) and keep SKILL.md as a concise operational core with clearly signaled one-level-deep links.

Merge the overlapping 'Goal', 'Core principle', and 'Audience and standing' sections into one short section; cut humor/provocation guidance that does not change the agent's output behavior.

Provide the exact command for the author-date vs committer-date window verification instead of describing the check in prose.

DimensionReasoningScore

Conciseness

The body is dense and avoids teaching Claude things it already knows (it even bans 'generic Git tutorials'), but at ~213 lines it includes material that could be tightened or cut: overlapping editorial-philosophy sections ('Goal', 'Core principle', 'Audience and standing' restate each other), tone rules like 'One good joke per few documents, max', and a 13-entry Lessons learned log. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trimming level of 4.

3 / 5

Actionability

Mostly executable guidance: a copy-paste whole-week git diff command with the plugins/ pathspec exclusion, a concrete weekly-entry template, the GitHub slug en-dash rule with a worked URL example, and 'gh pr view <n> --json author'. It falls short of 5 because some checks are described without commands (e.g. 'Verify window: author-date count == committer-date count' gives no command, and 'Grep md headers' is not fully specified).

4 / 5

Workflow Clarity

A clear numbered sequence (0. Prerequisites through 5. Slack message) with explicit validation checkpoints: window verification before diffing, duplicate-week grep before writing, re-read as a cold reader before presenting, EXPLICIT-approval HITL gate before applying, and a 4-item 'Review tests' checklist applied after every doc. This matches the anchor with explicit validation steps, feedback loops, and a checklist; nothing significant is missing.

5 / 5

Progressive Disclosure

The body has clear section headers but is a single ~213-line monolith with no bundle files (no references/, scripts/, or assets/ exist). Content that could live in separate files is inlined, notably the growing Lessons learned log and the extensive style/voice rules; the repo-file references (DOC-STRUCTURE-PLAN.md, pa-rosetta-intro-for-AI.md) are not bundle references. This matches 'some structure but could be better organized' rather than level 4, since a skill this long clearly warrants splitting.

3 / 5

Total

15

/

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, concrete single purpose around CHANGELOG.md synchronization, but it reads as a half-finished trigger: it answers 'what' and stops. Adding an explicit 'Use when...' clause with the natural phrases a user would say (e.g. updating the changelog, weekly changes, release notes) would lift completeness, trigger term quality, and distinctiveness simultaneously.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when the user asks to update or sync the changelog, summarize the week's changes, or prepare the weekly changelog entry.'

Include natural trigger synonyms such as 'update CHANGELOG', 'weekly changes summary', and 'release notes' so users' phrasing matches without exact wording.

Mention the secondary deliverable (suggesting a Slack message for the week's changes) so the description covers the skill's actual scope.

DimensionReasoningScore

Specificity

"To synchronize CHANGELOG.md with changes made last week (mon - sun)" names the domain (CHANGELOG.md) and one concrete action (synchronize with last week's changes), matching the 'names domain and 1-2 concrete actions' anchor. It is not score 4 because several specific actions the skill actually performs (writing weekly entries from a template, contributor attribution, suggesting a Slack message) are absent, and not score 2 because the action named is concrete rather than generic.

3 / 5

Completeness

The 'what' is clear (synchronize CHANGELOG.md with the previous Monday-Sunday window of git changes), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not score 4 because the 'when' is entirely absent rather than merely weakly explicit.

3 / 5

Trigger Term Quality

Relevant keywords are present ("CHANGELOG.md", "changes", "last week (mon - sun)"), but common natural phrasings users would say are missing, such as "update the changelog", "weekly summary", or "release notes". It sits above the single-generic-keyword level of 2 and below the good-coverage level of 4.

3 / 5

Distinctiveness Conflict Risk

"CHANGELOG.md" plus the fixed weekly Monday-Sunday window carves a fairly distinct niche with low conflict risk against generic documentation skills. It is not score 5 because the description lacks 'when' trigger phrases that would fully separate it from neighboring skills like commit-message generation or general changelog editing.

4 / 5

Total

13

/

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

griddynamics/rosetta

Path

.claude/skills/update-change-log/SKILL.md

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.