CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-manager

Skill para coordenar release, versionamento, changelog, release notes, rollout, rollback e comunicacao interna. Use quando a mudanca estiver pronta para empacotamento e liberacao controlada. Trigger em: "release manager", "coordenar release", "versionamento semver", "changelog", "release notes", "rollout controlado", "comunicacao de release", "tag de versao", "bump de versao", "release candidate".

Quality

87%

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

81%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 well-structured, action-oriented skill body: concrete semver decision rules, a real changelog template, an executable rollout/rollback runbook with validation gates and a genuine rollback feedback loop. Weaknesses are limited to minor editorial padding, placeholder rollback thresholds, and references to template/policy files that are not part of the skill bundle.

Suggestions

Replace the placeholder rollback trigger ('error rate > X% ou p95 > Y ms por Z min') with a concrete default (e.g., 'error rate > 1% ou p95 +50% por 10 min') that users can override, making the runbook immediately executable.

Trim editorial asides in the Comunicacao and Anti-padroes sections ('pior pesadelo', 'classico') to pure guidance to improve token efficiency.

Either bundle 'templates/release-plan.md' or remove/inline its mention, since the file is referenced in Handoff but does not exist in the skill directory.

DimensionReasoningScore

Conciseness

The body is dense and efficient — decision tables for semver bumps, changelog-vs-release-notes, and communication channels, with no explanation of concepts Claude already knows. It is not a 5 because a few editorial asides ('Breaking change sem aviso previo e o pior pesadelo de quem consome', 'release na sexta 18h sem on-call (classico)') are padding that could be trimmed.

4 / 5

Actionability

Mostly concrete and executable for an instruction-only skill: a semver bump table with examples, a Keep a Changelog template, a ready-to-use release-notes example, 'git tag -a v2.4.0 -m "..."', and a per-channel communication table. It falls short of 5 because the rollback trigger is left as placeholders ('error rate > X% ou p95 > Y ms por Z min') and the referenced 'templates/release-plan.md' does not exist in the skill bundle.

4 / 5

Workflow Clarity

The release workflow has an explicit pre-release checklist with validation gates (QA/Security/Reviewer green, constitution gates, migrations reversibles, 'rollback testado em staging'), and a clear feedback loop: monitor error rate/p95 against the pre-defined trigger for the full Z-minute window, execute the already-decided rollback mechanism if it fires, then restart from the full pre-release checklist rather than re-applying the same release. This matches the level-5 anchor (checklists, explicit validation, error-recovery feedback loop) for a risky batch operation.

5 / 5

Progressive Disclosure

Sections are well-organized (Quando Usar / Quando Nao Usar / Entradas / Saidas / decisao / runbook / comunicacao) and all content is appropriately inline for a ~130-line overview. It is not 5 because the skill exceeds the simple-skill threshold and its external file references ('templates/release-plan.md', 'policies/handoffs.md') are only lightly signaled in a Handoff section and do not exist as bundle files, leaving minor organization gaps.

4 / 5

Total

17

/

20

Passed

Description

88%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: it states what the skill does with seven concrete capabilities, gives an explicit use-when clause, and lists ten natural trigger phrases. The only gaps are a few missing trigger synonyms and minor overlap risk with documentation-oriented skills via the 'changelog'/'release notes' triggers.

DimensionReasoningScore

Specificity

The description lists seven concrete actions — 'coordenar release, versionamento, changelog, release notes, rollout, rollback e comunicacao interna' — giving comprehensive coverage of the release-coordination domain. It exceeds the level-4 anchor ('several specific actions; minor gaps') because no core responsibility of the skill is omitted.

5 / 5

Completeness

It explicitly answers both questions: 'what' via the seven concrete capabilities in the first sentence, and 'when' via 'Use quando a mudanca estiver pronta para empacotamento e liberacao controlada' plus a concrete trigger list. This matches the level-5 anchor of both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Ten explicit trigger phrases ('release manager', 'coordenar release', 'bump de versao', 'release candidate', 'tag de versao') are natural things a user would say. It falls short of level 5 because common variations and synonyms are missing (e.g., 'publicar release', 'preparar release', 'versionar'), though coverage is clearly good rather than partial.

4 / 5

Distinctiveness Conflict Risk

The niche (release packaging/versioning/communication) is clear and mostly distinct, with dedicated triggers like 'release manager' and 'release candidate'. However, 'changelog' and 'release notes' are triggers that would also naturally activate a documentation or changelog-writing skill in the same ecosystem, so minor overlap risk with closely related skills remains.

4 / 5

Total

18

/

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

felvieira/claude-skills-fv

Path

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