CtrlK
BlogDocsLog inGet started
Tessl Logo

release-announcement

Write a release announcement — changelog, blog post, in-app note, or social post — that leads with user impact, names the audience, and includes upgrade/migration steps without filler.

62

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./packages/skills-catalog/catalog/optional/content/release-announcement/SKILL.md
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 strong, highly actionable body: channel-specific templates, an audience-first decision table, concrete writing rules, and a verification checklist, all written tersely with no filler. Its main structural weakness is the large inline Paperclip cases section, which both adds bulk and is the natural candidate for a separate reference file.

Suggestions

Move the three Paperclip case upsert JSON payloads (release, blog_post, tweet_storm) into a reference file (e.g. references/cases-templates.md), keeping only the API contract summary and link inline — this would improve both conciseness and progressive disclosure.

Add an explicit pre-publish verification step (beyond the post-publish checklist), e.g. confirming the breaking-change entry appears in every chosen channel before publishing.

DimensionReasoningScore

Conciseness

The body is lean — a channel/tone table, terse bullets, and before/after phrasing examples with no explanation of concepts Claude already knows. The ~90-line "Paperclip Cases output" section of JSON payloads is bulk that could be trimmed or externalized, keeping it below anchor 5, but there is no padded over-explanation that would drop it to 3.

4 / 5

Actionability

Fully actionable for an instruction-only skill: a fill-in changelog template, a structured blog-post format with word counts ("300–800 words", "Hook (1 paragraph)"), an audience/channel/tone table, concrete writing rules with examples ("`You can now export to CSV` beats `We've added CSV export`"), and a post-publish checklist — copy-paste-ready guidance covering the common cases.

5 / 5

Workflow Clarity

Sequence is explicit ("Determine the audience and channel first", then universal structure, channel templates, writing rules) and the post-publish checklist acts as a verification checkpoint ("All links work", "Blog post date matches actual ship date"). It is short of anchor 5, which expects explicit validation with error-recovery feedback loops; the writing task is neither destructive nor batch, so no cap applies.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the body is cleanly sectioned with clear headers; the Paperclip API contract is correctly delegated one level deep to "skills/paperclip/references/cases.md". The minor gap keeping it from 5 is that roughly 45% of the body is inline platform-case JSON payloads that could live in a reference file.

4 / 5

Total

17

/

20

Passed

Description

66%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 specific, distinct description that names concrete output surfaces and quality bar, but it lacks any explicit "Use when..." trigger clause, which both caps completeness and slightly weakens trigger-term coverage. Adding a when-clause with natural trigger phrases would lift it to the top band.

Suggestions

Add an explicit trigger clause, e.g. "Use when a version or feature ships and needs a changelog entry, release notes, or announcement post, or when the user mentions a release, changelog, or what's new."

Include "release notes" and "what's new" as trigger terms — these are common user phrasings for this task that are currently absent.

Consider naming release notes as a deliverable surface alongside changelog, blog post, in-app note, and social post for fuller coverage.

DimensionReasoningScore

Specificity

"Write a release announcement — changelog, blog post, in-app note, or social post" lists several concrete deliverable types plus concrete quality constraints ("leads with user impact, names the audience, and includes upgrade/migration steps"), but coverage has minor gaps (no release notes or email newsletter). Fits anchor 4 rather than 5 because the enumerated surfaces are not comprehensive, and clearly above anchor 3 which expects only 1-2 concrete actions.

4 / 5

Completeness

The "what" is clear and specific, but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by the topic. Per the judging guideline, a missing explicit trigger clause caps completeness at 3 — it is above anchor 2 (which requires a vague what) but cannot reach 4 without an explicit when.

3 / 5

Trigger Term Quality

Natural phrases a user would say are present ("release announcement", "changelog", "blog post", "social post"), but "release notes" — a very common phrasing for this task — is absent, so it matches anchor 4 (good coverage, a few natural terms missing) rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The release-communications niche (changelog, announcement copy, migration messaging) is clearly distinct with specific artifact types, risking only minor overlap with general writing/blogging skills — matching anchor 4 rather than 5, which would require fully distinct trigger phrasing (e.g., explicit "Use when" triggers).

4 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

14

/

16

Passed

Repository
paperclipai/paperclip
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.