CtrlK
BlogDocsLog inGet started
Tessl Logo

release-changelog-discord-message

Write the Discord announcement for a stable Paperclip release from the release changelog. Use when a release issue needs a copy-pasteable dotta-voice Discord post or refreshed discord_announcement document.

66

Quality

80%

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

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.

This is a highly actionable, voice-faithful skill: complete API schemas, a full template, three verbatim ground-truth examples, and a validation checklist before handoff. Its two weaknesses are redundancy (the same invariants are restated in the template notes, language tips, and review checklist) and the absence of any bundle split — the 190 lines of verbatim examples should live in references/.

Suggestions

Move the three verbatim example announcements (~190 lines) into references/previous-announcements.md and keep a one-line pointer plus a short 'canonical voice' excerpt in SKILL.md — this also lets the workflow's step 4 ('Re-read the three verbatim examples') reference a stable path.

Consolidate the repeated invariants into the Review checklist only: the contributor-exclusion rules, the 'ITS TIME TO CLIP' closing tagline, and the 'WHATS NEXT pulled from real issues' rule are each currently stated in 3–4 sections.

Move the tweet_storm case schema and its body-document HTTP calls into references/ (e.g. tweet-storm-case.md), keeping only the key ('paperclip-release:vYYYY.MDD.P:tweet-storm') and parent linkage inline.

DimensionReasoningScore

Conciseness

The bulk of the file (template, language tips, verbatim examples) is non-derivable voice data that earns its tokens, but guidance rules repeat across sections 3–4 times: contributor-exclusion rules appear in the template notes, language tips, and review checklist; the closing-tagline invariance is stated three times; and "pull WHATS NEXT from real issues" four times. Consolidating these would land at anchor 4; it is not anchor 2 territory since there is no padding of concepts Claude already knows.

3 / 5

Actionability

Fully executable throughout: exact HTTP calls with complete JSON bodies (PUT /api/issues/{releaseIssueId}/documents/discord_announcement, the tweet_storm case schema with concrete field values), a complete copy-paste-ready post template, and three verbatim ground-truth outputs covering the realistic cases. Not below 5 — nothing is pseudocode or hand-waved.

5 / 5

Workflow Clarity

An 8-step numbered workflow with explicit conditional handling ("If the document already exists, fetch it first and pass the current baseRevisionId. Never overwrite silently") and a 7-item review checklist that verifies version/contributor/highlight fidelity against the changelog before handoff. The operation is artifact preparation (no publishing, no destructive/batch writes), so the validation cap does not apply, and validation is in fact explicit — matching the checklist-plus-feedback-loop pattern of anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and the SKILL.md is 478 lines, with the three verbatim examples (~190 lines, ~40% of the file) and the tweet-storm case schema being content that clearly belongs in separate reference files. Internal section structure is good — keeping it above anchor 2 — but the split is absent and the cross-skill pointer to .agents/skills/release-changelog/SKILL.md is described but not navigable from here, fitting anchor 3.

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.

A strong description: third-person, concrete about what it produces, and with an explicit "Use when" clause tied to the release issue's discord_announcement document. Its only weakness is that it describes the primary artifact well but omits the skill's secondary outputs, leaving slight coverage and synonym gaps.

DimensionReasoningScore

Specificity

Names the concrete artifact and source ("Write the Discord announcement for a stable Paperclip release from the release changelog") plus format and refresh actions ("copy-pasteable dotta-voice Discord post or refreshed discord_announcement document"), but coverage stops short of the skill's secondary outputs (issue-comment posting, tweet_storm child case), so it sits between anchors 4 and 5 rather than at 5.

4 / 5

Completeness

Explicitly answers both questions: the "what" is writing the stable-release Discord announcement from the changelog, and an explicit "Use when a release issue needs a copy-pasteable dotta-voice Discord post or refreshed discord_announcement document" clause supplies two concrete triggers.

5 / 5

Trigger Term Quality

Good natural trigger phrases a user would actually say — "Discord announcement", "Discord post", "release changelog", "release issue", "discord_announcement document" — but a few natural synonyms ("Discord message", "social post") are missing, matching anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Paperclip release Discord announcements) with distinct triggers; the only adjacency is the companion release-changelog skill that produces its input, which is minor overlap risk rather than the clean separation of anchor 5.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

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.