CtrlK
BlogDocsLog inGet started
Tessl Logo

changelog-update

Update CHANGELOG.md following TalkPipe conventions. Use after implementing a feature, fixing a bug, or making any user-facing change. Ensures correct "update vs add" logic and entry format.

86

0.93x
Quality

87%

Does it follow best practices?

Impact

70%

0.93x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is an excellent, well-crafted skill that efficiently communicates the changelog update process. The decision flow for 'update vs add' is the key insight that makes this skill valuable, and it's presented clearly with concrete before/after examples. The content is appropriately scoped, actionable, and well-structured for its purpose.

DimensionReasoningScore

Conciseness

The content is lean and efficient. Every section serves a purpose—decision flow, format rules, examples, and checklist. No unnecessary explanations of what a changelog is or how markdown works. Claude's intelligence is respected throughout.

3 / 3

Actionability

Provides concrete, copy-paste-ready markdown examples for multiple scenarios (new feature, update existing, bug fix, multiple related changes). The decision flow gives specific yes/no criteria for action. The format rules are precise and unambiguous.

3 / 3

Workflow Clarity

The decision flow clearly sequences the two key decisions (update vs add, internal vs user-facing). The checklist at the end provides explicit validation steps. For this non-destructive, single-file editing task, the workflow is appropriately scoped and clear.

3 / 3

Progressive Disclosure

For a simple, single-purpose skill under 50 lines, the content is well-organized with clear sections (When to Use, Decision Flow, Format Rules, Examples, Checklist). It references CHANGELOG.md directly. No need for external files, and no monolithic walls of text.

3 / 3

Total

12

/

12

Passed

Description

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid description that clearly communicates both what the skill does and when to use it, with good specificity to the TalkPipe project's CHANGELOG.md. Its main weaknesses are slightly limited concrete action details and missing some natural trigger term variations that users might employ when needing changelog updates.

Suggestions

Add more specific concrete actions, e.g., 'Adds entries under correct section headers (Added, Changed, Fixed), determines whether to update existing entries or add new ones, formats entries per TalkPipe conventions'

Include additional trigger terms users might naturally say, such as 'changelog entry', 'release notes', 'log changes', or 'document changes'

DimensionReasoningScore

Specificity

Names the domain (CHANGELOG.md updates) and mentions some actions ('update vs add logic', 'entry format'), but doesn't list multiple concrete actions like specific formatting rules, section management, or version handling.

2 / 3

Completeness

Clearly answers both what ('Update CHANGELOG.md following TalkPipe conventions, ensures correct update vs add logic and entry format') and when ('after implementing a feature, fixing a bug, or making any user-facing change') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes relevant terms like 'CHANGELOG.md', 'feature', 'bug', 'user-facing change', but misses common variations users might say such as 'changelog entry', 'release notes', 'version bump', or 'what changed'.

2 / 3

Distinctiveness Conflict Risk

Highly specific to CHANGELOG.md with TalkPipe conventions, making it very unlikely to conflict with other skills. The combination of the specific file and project conventions creates a clear niche.

3 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
sandialabs/talkpipe
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.