CtrlK
BlogDocsLog inGet started
Tessl Logo

pre-changelog

Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese. Reads the changelog that changesets pre-generated in the release PR, then reuses sync-changelog's strip / classify / translate logic to render a Chinese preview. Writes no files.

72

Quality

90%

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

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.

A highly actionable, well-sequenced read-only workflow with exact commands, verbatim output strings, and thorough edge-case handling. The main weakness is density: the folding/collapse rules are packed into one hard-to-parse sentence that would benefit from being broken out or moved into a reference file.

DimensionReasoningScore

Conciseness

The body is dense with project-specific policy and contains no padding or explanations of concepts Claude already knows — every rule is non-obvious editorial criteria. It falls short of 5 because the 'Collapse low-signal entries' bullet is a single enormous sentence with nested parenthetical caveats that could be structured and tightened; it is above 3 because nothing is generic filler and nearly every token carries unique instruction.

4 / 5

Actionability

Fully executable end to end: exact `gh pr list` and `gh api ... --jq` commands, a precise diff-slicing rule for the version block, exact output templates, verbatim Chinese catch-all strings, and a concrete URL-rewrite example (`../configuration/config-files.md#loop-control` → published URL). Commands are copy-paste ready and edge outputs are specified literally.

5 / 5

Workflow Clarity

A clearly numbered 4-step sequence with explicit checkpoints and stop conditions at each stage: "If none is open... stop", "If the CLI changelog is not in the diff... stop and tell the user", "flag it and stop" for non-English entries, plus handling for empty sections (`无`). The operation is read-only, so no destructive/batch validation loop is required, and the failure paths are all covered. Not a 4 because no checkpoint is missing or merely implicit.

5 / 5

Progressive Disclosure

No bundle files exist, and the body is well organized (Workflow subsections, Rules) while correctly delegating the bulk of the editorial policy to the external `sync-changelog` skill instead of duplicating it — a clearly signaled, one-level-deep reference. It is a 4 rather than 5 because the very long inline 'Collapse low-signal entries' rule set is content that could plausibly live in its own reference section or file, and the dependency on another skill's steps (3/4/6) makes navigation depend on material outside this bundle.

4 / 5

Total

18

/

20

Passed

Description

88%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: it states concrete capabilities, an explicit 'Use before merging' trigger, and clear read-only boundary, all in third person without padding. The only room for improvement is adding a few natural synonyms (e.g., 'release notes') and sharpening the boundary against the sibling sync-changelog skill.

DimensionReasoningScore

Specificity

The description names multiple concrete actions — "preview the user-facing CLI changelog in Chinese", "Reads the changelog that changesets pre-generated in the release PR", "reuses sync-changelog's strip / classify / translate logic", "Writes no files" — fully covering this skill's scope. It is not a 4 because coverage within the stated niche is comprehensive, with no visible gaps.

5 / 5

Completeness

It explicitly answers both questions: what ("preview the user-facing CLI changelog in Chinese... reuses sync-changelog's strip / classify / translate logic... Writes no files") and when ("Use before merging a kimi-code release PR") with a concrete trigger phrase. The 'when' clause is explicit and specific, matching the 5 anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases a user would say are present: "before merging", "release PR", "changelog", "Chinese", "preview". It is a 4 rather than 5 because common synonyms like "release notes" or "发版" are absent, though the core vocabulary is strong.

4 / 5

Distinctiveness Conflict Risk

The pre-merge, read-only preview framing creates a clear niche distinct from generic changelog work, but it explicitly overlaps with the closely related `sync-changelog` skill whose logic it reuses, leaving minor risk of triggering on the post-merge sync task itself. Not a 5 for that residual overlap with one closely related skill; not a 3 because the trigger conditions ("before merging") would rarely fire for the wrong skill.

4 / 5

Total

18

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository
MoonshotAI/kimi-code
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.