CtrlK
BlogDocsLog inGet started
Tessl Logo

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".

68

Quality

83%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured release management skill with strong actionability and workflow clarity. The SemVer decision table, changelog vs release notes distinction with concrete examples, and the pre-release/rollback runbook are all excellent. The main weaknesses are moderate verbosity in framing sections and references to many bundle files that aren't provided, making progressive disclosure hard to fully validate.

Suggestions

Trim the 'Governanca Global' section to a single line referencing GLOBAL.md rather than listing every policy file individually, saving tokens.

Consider moving the 'Quando Usar / Quando Nao Usar' sections into the YAML description since they largely duplicate the trigger/description metadata.

DimensionReasoningScore

Conciseness

The skill is mostly efficient with good use of tables and checklists, but includes some unnecessary framing (e.g., the opening paragraph explaining what the skill decides, the 'Quando Usar/Nao Usar' sections that partially repeat the description). The governance section listing many policy files adds token cost. However, the core content (SemVer table, changelog vs release notes, runbook, anti-patterns) is well-condensed.

2 / 3

Actionability

Provides concrete, executable guidance throughout: specific git tag commands, explicit rollback trigger criteria ('error rate > X% or p95 > Y ms for Z min'), complete changelog and release notes examples with real formatting, actionable checklists with checkboxes, and specific anti-patterns with clear corrections. The SemVer decision table gives concrete examples for each bump level.

3 / 3

Workflow Clarity

The multi-step release process is clearly sequenced with explicit validation checkpoints: pre-release checklist with gates, rollback criteria defined BEFORE release, staging validation required before production, and clear escalation paths (handoff to canary skill 43 for gradual rollout). The feedback loop of 'rollback testado em staging — saber que funciona ANTES de precisar' is an excellent validation checkpoint.

3 / 3

Progressive Disclosure

References multiple policy files and templates (GLOBAL.md, policies/execution.md, templates/release-plan.md, etc.) which suggests good structure, but none of these bundle files are provided, making it impossible to verify they exist or are useful. The skill itself is moderately long (~150 lines) but the content is appropriately inline since it's all directly relevant. The external references are one-level deep and clearly signaled, but the governance section's long list of policy references feels like boilerplate.

2 / 3

Total

10

/

12

Passed

Description

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid skill description that clearly defines its domain (release management) and provides explicit 'when to use' guidance along with a comprehensive list of trigger terms. Its main weakness is that the capabilities are described at a topic level rather than as concrete actions—it says it handles 'changelog' but not specifically what it does with changelogs. The trigger term coverage is excellent and the skill is clearly distinguishable from other potential skills.

Suggestions

Replace topic-level nouns with concrete action phrases, e.g., 'Gera changelogs a partir do historico de commits, cria tags semanticas de versao, redige release notes, coordena rollout e rollback' instead of just listing areas.

DimensionReasoningScore

Specificity

The description names the domain (release management) and lists several related areas (versionamento, changelog, release notes, rollout, rollback, comunicacao interna), but these read more like topic areas than concrete actions. It doesn't specify what concrete operations are performed (e.g., 'generates changelogs from commit history', 'creates semantic version tags').

2 / 3

Completeness

The description clearly answers both 'what' (coordenar release, versionamento, changelog, release notes, rollout, rollback, comunicacao interna) and 'when' ('Use quando a mudanca estiver pronta para empacotamento e liberacao controlada') with explicit trigger terms listed separately.

3 / 3

Trigger Term Quality

The description includes an explicit trigger list with good coverage of natural terms users would say: 'release manager', 'coordenar release', 'versionamento semver', 'changelog', 'release notes', 'rollout controlado', 'tag de versao', 'bump de versao', 'release candidate'. These are natural, varied, and cover common user phrasings.

3 / 3

Distinctiveness Conflict Risk

The skill occupies a clear niche around release coordination and versioning. The specific trigger terms like 'release candidate', 'semver', 'rollout controlado', and 'bump de versao' are distinct enough to avoid conflicts with general CI/CD, deployment, or documentation skills.

3 / 3

Total

11

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
felvieira/claude-skills-fv
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.