CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-release-manager

Agent skill for release-manager - invoke with $agent-release-manager

56

2.51x
Quality

39%

Does it follow best practices?

Impact

78%

2.51x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-release-manager/SKILL.md

The canonical home for this skill is agent-release-manager in ruvnet/claude-flow

SKILL.md
Quality
Evals
Security

Quality

Content

50%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 information-rich and structured with clear sections, but it is verbose, contains non-executable code due to "$"-corrupted path separators and placeholder bodies, lacks gated validation feedback loops for a batch release operation, and keeps all detail inlined with no progressive disclosure to separate files.

Suggestions

Move the large PR-body template, CI/CD YAML, and release-strategy definitions into separate reference files and link to them from SKILL.md to reduce inline bulk and improve progressive disclosure.

Add explicit gated validation checkpoints with feedback loops, e.g. "Run npm test; if it fails, fix and re-run before creating the release PR" — currently validation runs but is not gated against proceeding.

Fix the "$" path separators (e.g., release/v1.0.72, $workspaces replaced with real paths, refs/heads/main), replace placeholder bodies, and parameterize hardcoded version numbers so the examples are copy-paste executable.

DimensionReasoningScore

Conciseness

The body is mostly concrete code and structured examples rather than explanations of concepts Claude already knows, but it is padded with a ~50-line decorative PR-body template, a full inlined changelog, repeated agent-spawn lists, and hardcoded version numbers (1.0.72, 1.0.11→1.0.12) woven throughout as if current, so it could be tightened; this fits the "mostly efficient but includes some unnecessary/padded content" anchor and is not a 2 because it avoids explaining known concepts.

3 / 5

Actionability

The body provides concrete MCP calls and npm/gh commands with real parameters, but path and ref separators are corrupted to "$" throughout (e.g., "release$v1.0.72", "$workspaces$ruv-FANN$...", "refs$heads$main", "actions$checkout@v3") and several bodies are placeholders ("[updated package.json]", "[comprehensive release description]"), so the code is not copy-paste executable as written; this matches the "some concrete guidance but incomplete / missing key details" anchor rather than a 4 where guidance is mostly executable.

3 / 5

Workflow Clarity

The Batch Release Workflow lists a real sequence (init swarm → branch → clone → write files → commit/push → npm test/lint/build → create PR → track todos → store state), and validation commands are present, but there are no explicit gated checkpoints or feedback loops (e.g., "if tests fail, fix and re-run before creating the PR"), and this is a batch/destructive release operation, so per the destructive/batch cap workflow_clarity cannot exceed 3.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the ~370-line body references no separate files, so the doc is effectively monolithic; it is above a 2 because it has clear section headers (Purpose, Usage Patterns, Release Strategies, Best Practices, CI/CD, Monitoring), but it is not a 4 because content that belongs in separate files (the giant PR template, CI/CD YAML, strategy definitions) is fully inlined with no one-level-deep references.

3 / 5

Total

12

/

20

Passed

Description

28%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.

The frontmatter description is too terse to be useful: it names the release-management domain but states no concrete actions, includes no natural trigger phrases, and provides no explicit "Use when..." guidance. It is distinguishable only by its niche name, not by its content.

Suggestions

State the concrete actions the skill performs, e.g. "Coordinates multi-package version bumps, runs test/lint/build validation, creates release PRs, and generates changelogs and release notes."

Add an explicit "Use when..." trigger clause with natural user phrasing, e.g. "Use when cutting a release, coordinating version bumps across packages, or preparing a release pull request."

Replace the literal invocation string with natural trigger terms (release, version bump, deploy, changelog) so users' actual requests match the description.

DimensionReasoningScore

Specificity

The description only names the domain ("release-manager") with the phrase "Agent skill for release-manager" and states no concrete actions the skill performs, fitting the anchor that names the domain but has minimal or generic actions; it is above a 1 because it does pin a specific domain rather than being fully abstract.

2 / 5

Completeness

It offers only a vague "what" ("Agent skill for release-manager") and no "when" trigger guidance — the "invoke with..." clause is an invocation instruction, not a use-condition — so per the missing "Use when..." cap and the vague-what-plus-no-when anchor it sits at 2 rather than 3.

2 / 5

Trigger Term Quality

The only keyword is the compound "release-manager" plus the literal invocation string "$agent-release-manager", which is technical jargon rather than the natural phrases a user would say (e.g., "cut a release", "coordinate version bumps"), matching the anchor for one or two generic keywords missing natural user phrasing.

2 / 5

Distinctiveness Conflict Risk

"release-manager" names a specific niche that is somewhat distinct, but the bare description gives no differentiating triggers and could still overlap with general deploy/versioning skills, matching the "somewhat specific but could still overlap" anchor; it is not a 4 because nothing explicit minimizes overlap with related dev/deploy skills.

3 / 5

Total

9

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ruvnet/ruflo
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.