CtrlK
BlogDocsLog inGet started
Tessl Logo

changelog

How to keep each app's user-facing changelog. Use when you ship a change a user would notice (a new feature, a visible improvement, a bug fix), when wiring the in-app "What's new" surface into a template, or when releasing pending changelog entries. Apps opt in with `changelog.enabled: true` in `agent-native.config.ts`.

68

Quality

86%

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

82%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 well-crafted skill body: concrete commands, complete entry and wiring examples, an explicit do/don't boundary for entries, and a closing checklist. The main improvement space is adding a lightweight verification step after release/wiring and tightening the Releasing paragraph.

Suggestions

Conciseness: consolidate the Releasing section's two overlapping explanations of when the 100-entry window refreshes into one sentence.

Workflow clarity: add an explicit verification checkpoint (e.g. run `agent-native changelog list` or check the What's-new dialog renders the new entry) after releasing or wiring the surface.

DimensionReasoningScore

Conciseness

Efficient and almost entirely repo-specific (CLI commands, file layout, wiring snippets) with no explanation of concepts Claude already knows. Minor trimming possible — e.g. the dense 'Releasing' paragraph's double explanation of when the 100-entry window refreshes. Not 5 because a few sentences restate the same mechanism twice; clearly not 3 since padding is minimal.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: `agent-native changelog add \"...\" --type added` commands, a complete hand-written entry frontmatter block, and ready-to-use `CommandMenu` / `ChangelogSettingsCard` wiring snippets covering the common cases. Matches anchor 5; nothing is pseudocode or left abstract.

5 / 5

Workflow Clarity

Clear sequence — when to add, how to add, entry-writing rules, releasing (with an idempotence note and a `changelog list` preview), wiring, then a checklist. The preview command and checklist are checkpoints, but there is no explicit verify-the-output step after release/wiring, so it sits at anchor 4 rather than 5's feedback-loop/checkpoint completeness; well above anchor 3's implicit-only checkpoints.

4 / 5

Progressive Disclosure

No bundle files exist and the body is well-organized into six clearly-signaled sections with no nested or buried references; the ~130-line body is slightly above the under-50-line simple-skill case, and the wiring section's code examples are the only content arguably splittable into a reference file. Fits anchor 4's 'good structure, minor organization gaps'; not 5 given the simple-skill exception applies to shorter skills, not 3 since structure is consistently clear.

4 / 5

Total

17

/

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, third-person, with an explicit 'Use when' clause covering three distinct trigger scenarios and a config gate that scopes the skill. The only improvement space is naming the core 'add an entry' action and a couple of natural synonyms like 'release notes'.

DimensionReasoningScore

Specificity

Names the domain ("keep each app's user-facing changelog") and several concrete actions — "wiring the in-app \"What's new\" surface into a template", "releasing pending changelog entries" — with minor gaps since the core add-an-entry action is only implied by the trigger phrasing. Not 5 because the what-side action list is thinner than the comprehensive multi-action example; not 3 because multiple specific actions are explicitly listed.

4 / 5

Completeness

Explicitly answers both: what ("How to keep each app's user-facing changelog") and when ("Use when you ship a change a user would notice... when wiring the in-app \"What's new\" surface... or when releasing pending changelog entries"), with concrete trigger phrases plus the opt-in gate (`changelog.enabled: true`). Matches anchor 5; not below since neither what nor when is vague or merely implied.

5 / 5

Trigger Term Quality

Good natural-term coverage: "ship a change a user would notice", "a new feature", "a visible improvement", "a bug fix", "What's new", "releasing". A few common synonyms users might say are missing (e.g. "release notes"), which keeps it below the comprehensive anchor 5; clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (user-facing changelog maintenance for this repo's apps) with distinct triggers and a config-file gate that further scopes it; minimal overlap with generic commit-log or release-process skills. Fits anchor 5; anchor 4's \"minor overlap risk\" would understate the scoping provided by the `changelog.enabled: true` gate.

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
BuilderIO/agent-native
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.