CtrlK
BlogDocsLog inGet started
Tessl Logo

team-release

Orchestrate the release team: coordinates release-manager, qa-lead, devops-engineer, and producer to execute a release from candidate to deployment.

60

Quality

72%

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 ./.claude/skills/team-release/SKILL.md
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.

The body is a well-sequenced, highly actionable orchestration pipeline with strong validation checkpoints and error-recovery feedback loops. Its main weaknesses are a duplicated team roster that inflates length and a monolithic structure with no progressive disclosure via reference files.

Suggestions

Merge "Team Composition" and "How to Delegate" into a single table mapping each role to its subagent_type and one-line responsibility, eliminating the duplicated role descriptions.

Extract the per-phase detail (or the Error Recovery Protocol / team roster) into a reference file under references/ and link to it from SKILL.md to add one-level-deep progressive disclosure.

Tighten verbose decision-point prose (e.g., the NO-GO override block) into compact steps so every token earns its place.

DimensionReasoningScore

Conciseness

Mostly efficient and domain-specific, but the role roster is duplicated: "Team Composition" lists each role and "How to Delegate" repeats the same roles with near-identical descriptions plus the subagent_type mapping, adding avoidable tokens. Not a 1 because it does not explain concepts Claude already knows; not a 3 because the duplicated team listing and repeated per-role descriptions could be merged into one table.

2 / 3

Actionability

Gives concrete, executable guidance throughout — explicit subagent_type values, specific file paths (production/session-state/active.md, production/milestones/, production/review-mode.txt), defined AskUserQuestion options, and per-phase outputs. As an instruction-only skill the absence of code is not penalized because the guidance is directly actionable. Not a 2 because details are complete and specific rather than abstract or pseudocode-like.

3 / 3

Workflow Clarity

A clearly sequenced Phase 0–7 pipeline with explicit validation checkpoints (Phase 3 quality-gate sign-offs, Phase 5 go/no-go, staging smoke test before production) and a feedback-loop Error Recovery Protocol (surface, assess dependencies, offer options, partial report). Not a 2 because validation and feedback loops are explicit rather than implicit for the deployment operations.

3 / 3

Progressive Disclosure

Well organized into labeled sections but monolithic — all content is inline in SKILL.md (~160 lines) with no bundle/reference files (references/, scripts/, assets/ are absent), and phase detail, team roster, and error-recovery material that could live in separate files is inline. Not a 1 because sectioning is clear rather than a wall of text; not a 3 because, being over 50 lines with no external file references, it does not split content one level deep with signaled navigation.

2 / 3

Total

10

/

12

Passed

Description

67%

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 description is specific and distinctive, clearly conveying what the skill does and the roles it coordinates, but it omits any explicit "when to use it" trigger guidance. Adding a Use-when clause and a few natural trigger phrasings would round it out.

Suggestions

Append an explicit trigger clause, e.g. ". Use when the user asks to ship, cut, or deploy a release version."

Add natural user phrasings alongside the role jargon — terms like "ship a release", "deploy this version", or "cut a release" — to broaden trigger coverage.

Mention the version-argument invocation hint is already in argument-hint; surface one concrete trigger ("release this version") in the description itself.

DimensionReasoningScore

Specificity

Quotes multiple concrete actions — "Orchestrate the release team", "coordinates release-manager, qa-lead, devops-engineer, and producer", "execute a release from candidate to deployment" — naming both specific roles and a concrete end-to-end action, matching the score-3 anchor for listing multiple specific actions. Not a 2 because it goes beyond naming a domain plus partial actions to enumerating distinct coordinated actions.

3 / 3

Completeness

Clearly answers "what" (orchestrate and coordinate a named team to run a release) but offers no "Use when..." or equivalent trigger guidance for when to invoke it; per the rubric a missing explicit trigger clause caps completeness at 2. Not a 3 because the "when" is entirely absent; not a 1 because the "what" is strong and specific.

2 / 3

Trigger Term Quality

Contains relevant natural terms ("release", "deployment", "release team") but leans on role jargon ("release-manager", "qa-lead", "devops-engineer") and omits common user phrasings like "ship", "deploy this version", or "cut a release". Not a 3 because coverage of natural trigger phrasings is incomplete; not a 1 because several genuinely natural terms are present.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear niche — orchestrating a multi-role release pipeline from candidate to deployment — that is unlikely to be confused with the narrower sub-skills it calls (/release-checklist, /changelog, /patch-notes). Not a 2 because the team-orchestration framing is specific enough to avoid overlap with those single-purpose skills.

3 / 3

Total

10

/

12

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
Donchitos/Claude-Code-Game-Studios
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.