CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skillshare-release

Prepare and review skillshare releases using the Release Please PR, verify the proposed version and changelog, inspect draft assets, and publish through the manual Publish Release workflow when explicitly authorized. Use when the user says "release", "prepare release", "cut a release", or asks to publish a new version. For changelog-only tasks, use /changelog instead.

Quality

87%

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

88%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 skill body: every step is sequenced, validated, and grounded in concrete commands, with explicit authorization boundaries and failure-recovery paths. Its only weaknesses are mild redundancy around the authorization theme and a monolithic single-file layout where a reference file could absorb some detail.

DimensionReasoningScore

Conciseness

The body is dense with repo-specific policy and commands, explaining only what Claude could not already know (Release Please behavior, version policy, squash-merge footer mechanics). A few sentences restate the authorization boundary and could be tightened slightly, which keeps it just short of the lean 'every token earns its place' anchor.

4 / 5

Actionability

Guidance is fully executable throughout: concrete commands such as 'python3 scripts/ai-context.py release testing', 'python3 scripts/release/release.py sync', 'make check', 'gh release edit vX.Y.Z --notes-file specs/RELEASE_NOTES_X.Y.Z.md', and a complete, copy-paste-ready commit footer example. Placeholders like <latest published tag>..origin/main are appropriately specific.

5 / 5

Workflow Clarity

Six numbered, clearly sequenced steps with explicit validation checkpoints ('release.py check --tag vX.Y.Z', 'make check', unittest discovery, 'verify every claim against source', presenting draft and verification results before publishing) and explicit error-recovery feedback loops ('Rerun the failed packaging job', 'apply the notes again after any rebuild', 'inspect the pending range for conflicting requests before proceeding'). This is a destructive/batch-adjacent workflow, but validation is pervasive, so no cap applies.

5 / 5

Progressive Disclosure

The single file is well sectioned and easy to navigate, but the body is roughly 92 lines with no reference files, and detail like the contributor-harvesting bash block and squash-merge footer mechanics is inlined where a separate reference would fit. The under-50-line single-file exception does not apply, so this sits at 'good structure with minor organization gaps' rather than the ideal split.

4 / 5

Total

18

/

20

Passed

Description

87%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 well-crafted description with explicit what/when coverage, natural quoted trigger phrases, and a clear boundary against a neighboring skill. Its only gap is slightly non-exhaustive action coverage and trigger-term synonyms, which keeps two dimensions at 4 rather than 5.

DimensionReasoningScore

Specificity

The description lists several concrete actions tied to named mechanisms — 'Prepare and review skillshare releases using the Release Please PR, verify the proposed version and changelog, inspect draft assets, and publish through the manual Publish Release workflow'. It stays at 4 rather than 5 because it omits sub-tasks the body covers (documentation sync, release notes, announcements).

4 / 5

Completeness

It explicitly answers both what ('Prepare and review skillshare releases... verify... inspect draft assets, and publish... when explicitly authorized') and when ('Use when the user says...'), with concrete trigger phrases plus a routing boundary for changelog-only tasks. Third-person voice is used throughout, so no voice penalty applies.

5 / 5

Trigger Term Quality

The trigger clause quotes natural user phrasings — "release", "prepare release", "cut a release", "asks to publish a new version" — including a genuine synonym. It falls short of comprehensive coverage, missing common variants like 'ship a release', 'roll out', or 'bump the version'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (skillshare releases via the Release Please PR and Publish Release workflow) with distinct triggers and explicit de-confliction — 'For changelog-only tasks, use /changelog instead' — minimizing the risk of triggering for the wrong skill.

5 / 5

Total

18

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 4 missing, 2 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

runkids/skillshare

Path

.skillshare/skills/skillshare-release/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.