CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openmeld-changelog

Maintain the official OpenMeld Changelog from repository evidence. Use when deciding whether a change needs a Changelog entry, writing or publishing an entry, preparing release notes, validating generated Changelog files, or historically backfilling missing changes.

Quality

91%

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

86%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 tight, well-structured instruction skill: concise, decision-oriented, with concrete examples and real validation commands. The two soft spots are undefined field vocabularies (`kind`, `areas`, `audiences`) shown only by example, and no explicit error-recovery loop after `pnpm changelog:check` fails.

Suggestions

Define the allowed values for `kind` (and the conventions for `areas`/`audiences`) inline or point to where they are enumerated, since the single example leaves the vocabulary ambiguous.

Add a short feedback loop after the verify step: if `pnpm changelog:check` fails, fix the invalid entry or unsupported publication claim and re-run before proceeding.

Show one contrasting example (e.g., a `kind: fix` or deprecation entry) so the entry format covers more than the 'new capability' case.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: no explanation of what a changelog or git is, and every line is decision guidance, a concrete example, or a command (e.g., "Merge, tag, deployment, and smoke are different claims. Keep an entry draft when the evidence proves only an earlier claim."). Nothing is padded and every token earns its place, matching the 5 anchor.

5 / 5

Actionability

Executable commands (`pnpm changelog:build`, `pnpm changelog:check`), a copy-paste-ready entry example with frontmatter, and a publication YAML snippet provide mostly executable guidance. Minor gaps: the vocabularies for `kind`, `areas`, and `audiences` are demonstrated only by a single example (what other `kind` values exist?), and only the 'new capability' entry style is exemplified — the 4 anchor's 'concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

A clear sequence (choose the job → gather evidence → decide → write → rebuild/verify) with an explicit validation step ("Run: pnpm changelog:build / pnpm changelog:check", "Review the resulting diff", and the backfill ordering confirmation) and a publication gate ("Publish it only after delivery is proven"). It falls short of the 5 anchor only because there is no explicit fix-and-retry feedback loop when `changelog:check` fails; validation is present, so the batch-operation cap of 3 does not apply.

4 / 5

Progressive Disclosure

No bundle files exist and the skill is appropriately self-contained at ~100 well-organized lines with clear section navigation. The one pointer to deeper material — "Read `developing/engineering/changelog.md` before editing either source or projections" — is clearly signaled and exactly one level deep, so format details live in the repo doc rather than being inlined. Structure fits the 5 anchor.

5 / 5

Total

18

/

20

Passed

Description

92%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 action statement, explicit 'Use when' triggers covering all five workflows, and a clearly namespaced niche. The only weakness is slightly thin synonym coverage (no 'change log', 'version history', or 'CHANGELOG.md' variants).

Suggestions

Add common user phrasings like "change log" or "CHANGELOG.md" to the trigger clause to catch users who type the spaced or filename variants.

DimensionReasoningScore

Specificity

"Maintain the official OpenMeld Changelog from repository evidence" states the core action, and the sentence enumerates multiple concrete jobs — deciding whether a change needs an entry, writing/publishing an entry, preparing release notes, validating generated files, and backfilling. Coverage is comprehensive across the skill's operations, matching the top anchor rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

It explicitly answers 'what' ("Maintain the official OpenMeld Changelog from repository evidence") and 'when' via a concrete "Use when..." clause listing five distinct triggering situations. This mirrors the 5 anchor example's structure of a clear capability statement followed by explicit trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ("Changelog entry", "release notes", "publishing an entry", "backfilling"), but common synonyms such as "change log" (spelled as two words), "version history", or "CHANGELOG.md" are absent. Good keyword coverage with a few natural terms missing fits the 4 anchor; it is not comprehensive enough for 5.

4 / 5

Distinctiveness Conflict Risk

The description is namespaced to "the official OpenMeld Changelog" — a clear niche — with triggers (changelog entries, release notes, backfill) that are unlikely to fire for unrelated skills. Only negligible overlap risk with a hypothetical generic release-notes skill keeps it from being ambiguous; it fits the 5 anchor.

5 / 5

Total

19

/

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

amplifthq/opentag

Path

.agents/skills/openmeld-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.