CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-changelog-announcement

Use this skill to create and publish changelog announcements for new features, improvements, or bug fixes. This skill handles the complete workflow - creating detailed changelog documentation pages, regenerating the in-app What's New data, and ensuring everything follows project standards. Use when the user mentions adding changelog entries, documenting new features, creating release notes, or announcing product updates.

Quality

82%

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

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

The body is highly actionable with an exemplary validated 9-step workflow, exact commands, and complete templates. It is let down by token efficiency (significant repetition of the Summary/truncate rules and an oversized inline example) and by keeping reference-style material inline instead of splitting it into bundle files.

Suggestions

Explain the <Summary>/{/* truncate */} structure once (e.g., in Step 4) and reference it from the checklist and Output Format sections instead of restating it four times.

Move the full Example 1 entry, the media markup templates (YouTube iframe / Image snippets), and the writing-style rules into files under references/ (e.g., references/example-entry.mdx, references/media-markup.md) and link to them from SKILL.md, reducing the body to an overview plus the workflow steps.

Trim motivational padding such as "Remember: You're creating user-facing documentation..." and "Test your work: Read the entries out loud", which restate guidance already given in the Writing Style Guidelines section.

DimensionReasoningScore

Conciseness

Most content is genuinely project-specific and unknowable (paths, generator behavior, <Summary> semantics), but the Summary/truncate structure is re-explained in at least four places (section 1A, Step 3 template, Step 4, checklist, Output Format) and the full ~60-line Example 1 entry pads the file, fitting anchor 3's "could be tightened" rather than anchor 4's "minor instances".

3 / 5

Actionability

Fully executable throughout: exact commands ("pnpm --filter @agenta/navigation generate:releases", "cd docs && npm run build", "gh issue close <number>"), complete frontmatter and MDX templates, and a copy-paste-ready worked example covering the common new-feature case, matching anchor 5.

5 / 5

Workflow Clarity

The 9-step workflow has explicit validation checkpoints and feedback loops: Step 5 requires checking the generator's printed version list, and Step 9 mandates a build with immediate error-fixing guidance (including a named common error) plus a final checklist, matching anchor 5's "explicit validation steps; feedback loops for error recovery".

5 / 5

Progressive Disclosure

No bundle files exist, so all ~500 lines live in SKILL.md with reasonable headers, but content that belongs in separate reference files (media/iframe markup templates, the full worked example, writing-style rules) is inlined; the only external pointer is to another skill's SKILL.md, fitting anchor 3 rather than anchor 4's "most content is appropriately placed".

3 / 5

Total

16

/

20

Passed

Description

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

The description is strong: it clearly and explicitly states both the complete workflow it performs and concrete trigger phrases a user would naturally say. Its weaknesses are minor: a vague "follows project standards" clause, omission of the roadmap and social-announcement deliverables, and slight overlap risk with general documentation skills.

DimensionReasoningScore

Specificity

Lists several concrete actions ("creating detailed changelog documentation pages, regenerating the in-app What's New data"), but "ensuring everything follows project standards" is vague filler and core deliverables like roadmap updates and social announcements are absent, which keeps it below anchor 5's comprehensive coverage.

4 / 5

Completeness

Explicitly answers both what ("handles the complete workflow - creating detailed changelog documentation pages, regenerating the in-app What's New data") and when ("Use when the user mentions adding changelog entries, documenting new features, creating release notes, or announcing product updates") with concrete trigger phrases, matching anchor 5; anchor 4 would require the 'when' to be less explicit than it is here.

5 / 5

Trigger Term Quality

The trigger clause covers natural phrases users would say ("adding changelog entries", "creating release notes", "announcing product updates", "documenting new features"), but misses a few natural variants like "What's New", "shipping a feature", or "version release", fitting anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Changelog/release-notes announcement is a clear niche with distinct triggers, but "documenting new features" could also plausibly fire a general documentation-writing skill, so there is minor overlap risk with closely related skills per anchor 4 rather than minimal risk per anchor 5.

4 / 5

Total

17

/

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

skill_md_line_count

SKILL.md is long (501 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 5 suspicious

Warning

Total

13

/

16

Passed

Repository

Agenta-AI/agenta

Path

.agents/skills/create-changelog-announcement/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.