CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

assemble-changelog

Assemble the per-PR changeset entries in docs/content/changelog/upcoming/ into a release's changeset-0-XX.md and generate the detailed CHANGELOG.md sections. Use at release time when the user wants to build or finalize the changelog or changeset for a Rerun release, or merge the upcoming/ entries. Invoked via /assemble-changelog or "assemble the changelog for 0.x.y".

Quality

88%

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

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

An excellent instruction-only skill body: every step is executable with concrete commands, the workflow is sequenced with hard stops, re-validation loops, and a comprehensive done-checklist, and it teaches only what Claude could not infer about this repo. The only improvements are trimming minor repetition and potentially splitting step 4's marker-detection and media recipes into reference files.

DimensionReasoningScore

Conciseness

Nearly every line carries repo-specific, non-inferable knowledge (redirect rules, monorepo PR-number hazards, anchor-generation rules, static.rerun.io media policy), assuming Claude's competence throughout. Anchor 4 fits: minor over-explanation/trimmable spots exist — the monorepo warning is stated in the preamble and re-referenced in step 3, the static.rerun.io media rule appears three times, and a few rationale sentences ('a picture sells a new view or renderer feature far better than a bullet does') could be tightened. Not anchor 5 because of that slight redundancy; far above anchor 3, which expects genuinely unnecessary explanation.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: 'pixi run uvpy scripts/generate_changelog.py --version 0.x.y', "rg -n 'TODO\([^)]+\)' ...", the four git-diff experimental-marker probes, 'ffmpeg -ss <t> -i video.mp4 -frames:v 1 still.png', 'curl -L -H "Authorization: token $(gh auth token)" <url>', and the lint/check script invocations. Placeholders (0-XX, $PREV) are appropriately parameterized, and rules are concretely exemplified (e.g. 'rrd::optimize → rrdoptimize'). Matches anchor 5; anchor 4 would imply missing key details, and there are none of consequence.

5 / 5

Workflow Clarity

A clearly sequenced 5-step workflow with explicit validation gates and feedback loops: precondition checks with a hard stop ('If either precondition is not met, stop before running any release command'), 'Resolve every match before continuing' after the TODO scan, spot-check instructions for misfired PR lookups, and a 13-item 'Checklist before declaring done' ending in four executable verification commands. Matches anchor 5 (explicit validation steps, error-recovery guidance, checklist); anchor 4 would require missing checkpoints, which are not missing.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so all guidance lives in a single SKILL.md. Structure is good: numbered workflow steps, bolded sub-rules in step 4, a checklist, and Notes, with the one external pointer ([RELEASES.md](../../RELEASES.md)) clearly signaled and one level deep. Anchor 4 fits (good structure, minor organization gaps): the ~190-line body inlines detailed material — experimental-marker git probes and media-handling recipes — that could plausibly live in reference files. Not anchor 5, which expects a lean overview with well-signaled one-level-deep references; not anchor 3, since what is inline is workflow-critical and well-sectioned rather than clearly misplaced.

4 / 5

Total

18

/

20

Passed

Description

87%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: concrete, artifact-named actions plus an explicit 'Use when' clause with concrete trigger phrases and the slash-command invocation. The only gaps are unmentioned sub-steps (polish, validation) and the missing 'release notes' synonym.

DimensionReasoningScore

Specificity

Lists several concrete actions with explicit artifacts and paths — 'Assemble the per-PR changeset entries in docs/content/changelog/upcoming/ into a release's changeset-0-XX.md and generate the detailed CHANGELOG.md sections' — plus 'merge the upcoming/ entries'. Fits anchor 4 (several specific actions, minor gaps): polishing, validation, and emptying upcoming/ are not mentioned, keeping it below anchor 5's comprehensive coverage; it is clearly above anchor 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

Explicitly answers both what ('Assemble the per-PR changeset entries... into a release's changeset-0-XX.md and generate the detailed CHANGELOG.md sections') and when ('Use at release time when the user wants to build or finalize the changelog or changeset for a Rerun release, or merge the upcoming/ entries'), with concrete invocation phrases. Matches anchor 5 exactly and is clearly above anchor 4, whose 'when' is less explicit or specific.

5 / 5

Trigger Term Quality

Includes natural trigger phrases users would say: 'build or finalize the changelog or changeset', 'merge the upcoming/ entries', 'assemble the changelog for 0.x.y', and '/assemble-changelog'. Anchor 4 (good coverage, a few natural terms missing) fits: the synonym 'release notes' is absent, which anchor 5's comprehensive synonym coverage would require; well above anchor 3's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: 'a Rerun release', 'changeset-0-XX.md', 'docs/content/changelog/upcoming/', '/assemble-changelog'. These are unique to this skill, matching anchor 5's minimal conflict risk; no neighboring anchor fits better since anchor 4 still implies overlap with closely related skills (e.g., generic changelog/commit-message skills), which the Rerun-specific scoping avoids.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 5 missing, 3 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository

rerun-io/rerun

Path

skills/assemble-changelog/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.