CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-comms

Turn a deployment runsheet and a GitHub milestone into a customer release note with real media, docs updates, and a Slack announcement draft

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/release-comms/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

55%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 maximally token-efficient but is a pure pointer skill: it delegates all real content to files that are not shipped in the bundle, leaving no executable guidance, no defined workflow, and unresolved references. It reads as an environment-specific shim rather than a self-contained skill.

Suggestions

Ship the referenced playbook and rules as files under references/ (or inline the essential steps) so the skill is self-contained and the references resolve to real bundle files.

Replace the pointer-only body with a concrete sequence — gather milestone items from the runsheet, draft the release note, update docs, draft the Slack message — with explicit checkpoints before each deliverable.

State the Antigravity substitution as a short conditional note attached to the relevant step rather than as the body's second paragraph, so the primary path is defined in this file.

DimensionReasoningScore

Conciseness

The body is four lean sentences with zero padding and no explanation of concepts Claude already knows — every token is doing work. This matches the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

It gives concrete file paths and one precise, executable rule ("invoke `.agents/agents/<name>.md` via `invoke_subagent` instead"), but the actual executable guidance for the task lives in files not present in the skill bundle (`.claude/skills/release-comms/SKILL.md`, `.agents/rules/cog.md`), leaving key details missing. It is not 4 because a reader of this skill alone cannot execute the task; it is not 2 because the pointers and substitution rule are specific rather than high-level hints.

3 / 5

Workflow Clarity

Only a rough two-step sequence is present ("Read ... and execute it exactly as written ... Then follow `.agents/rules/cog.md`") and the real workflow is delegated to an absent file, so steps are poorly defined with no validation checkpoints. It is not 3 because even the listed steps describe pointer-following rather than any actual task sequence.

2 / 5

Progressive Disclosure

The entire body defers to files outside the skill bundle — no references/, scripts/, or assets/ directories exist, so the referenced paths (`.claude/skills/release-comms/SKILL.md`, `.agents/rules/cog.md`) resolve to nothing in the bundle — and the body itself has no organizing sections. This matches the 'references are buried / content that belongs in the bundle is absent' pattern; it is not 1 because the pointers are at least one level deep and explicitly signaled, not a nested chain.

2 / 5

Total

12

/

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, concrete description that clearly names its inputs and deliverables in a distinct niche, but it omits any 'when to use' trigger guidance, which caps completeness and limits natural discoverability. Adding an explicit trigger clause with a few synonyms would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. "Use when preparing a release note, changelog, or ship announcement after a deployment, or when the user mentions release comms or a milestone wrap-up."

Include common synonyms such as "changelog", "release announcement", or "post-deploy comms" to broaden natural trigger-term coverage.

Briefly state the when-condition in the same sentence (e.g. "...draft, when a deployment has just shipped") so both what and when are explicit.

DimensionReasoningScore

Specificity

The description names concrete inputs ("a deployment runsheet and a GitHub milestone") and several concrete deliverables ("a customer release note with real media, docs updates, and a Slack announcement draft"), which matches the 'lists several specific actions; minor gaps' anchor. It is not 5 because the work is framed as a single transformation pipeline and does not comprehensively enumerate the operations involved.

4 / 5

Completeness

The 'what' is clear (turn runsheet + milestone into release note, docs updates, Slack draft), but there is no 'Use when...' clause or any equivalent explicit trigger guidance — the 'when' is entirely missing, which caps this dimension at 3 per the judging guidelines. It is not 2 because the 'what' is specific and multi-part rather than vague.

3 / 5

Trigger Term Quality

Natural phrases a user would say are present — "release note", "GitHub milestone", "Slack announcement", "docs updates", "deployment" — giving good keyword coverage. It is not 5 because common synonyms and variations like "changelog", "release announcement", or "post-deploy comms" are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — release communications built from deployment runsheets and GitHub milestones — with distinctive artifacts that few skills would share. It is not 5 because terms like "docs updates" and "release note" have minor overlap risk with general documentation and writing skills.

4 / 5

Total

15

/

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

huytieu/COG-second-brain

Path

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