CtrlK
BlogDocsLog inGet started
Tessl Logo

team-lifecycle-v4

Full lifecycle team skill with clean architecture. SKILL.md is a universal router — all roles read it. Beat model is coordinator-only. Structure is roles/ + specs/ + templates/. Triggers on "team lifecycle v4".

44

Quality

46%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./.codex/skills/team-lifecycle-v4/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

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 orchestration skill that serves effectively as a universal router for a multi-agent team lifecycle system. Its greatest strengths are actionability (concrete spawn templates, tool call patterns, and file paths) and workflow clarity (explicit wave execution steps with validation and error recovery). Minor conciseness improvements could be made by deduplicating some supervisor documentation and tightening the delegation lock explanation.

DimensionReasoningScore

Conciseness

The skill is fairly dense and information-rich, but includes some redundancy (e.g., the supervisor spawn/wake/shutdown pattern is explained twice across sections, and the delegation lock table restates what could be a simpler rule). The ASCII architecture diagram and model selection guide add bulk but are mostly justified for a complex orchestration skill. Some tightening is possible.

2 / 3

Actionability

Highly actionable with concrete spawn_agent/followup_task/close_agent call templates, exact JSON-like parameter structures, specific file paths, timeout values, and explicit tool call verdicts. The worker spawn template, supervisor lifecycle, and wave execution engine are all copy-paste ready with clear parameter placeholders.

3 / 3

Workflow Clarity

The Wave Execution Engine provides a clear 10-step sequence with explicit validation checkpoints (skip failed deps, handle block verdicts, agent health checks, checkpoint verdicts). Error handling table covers failure modes with specific resolutions. The supervisor lifecycle (spawn -> wake -> shutdown) is clearly sequenced with feedback loops for blocked checkpoints (Override/Revise/Abort).

3 / 3

Progressive Disclosure

SKILL.md serves as a clear router/overview pointing to one-level-deep references: role files in roles/<name>/role.md, specs in specs/*.md, and templates. The Role Registry table provides direct links. Content is appropriately split between the router (this file) and detailed role/spec files, with clear navigation signals.

3 / 3

Total

11

/

12

Passed

Description

7%

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 description reads like internal implementation notes rather than a functional skill description. It focuses on architecture details (roles/, specs/, templates/, router patterns) instead of explaining what the skill does or when it should be used. A user or Claude selecting from a list of skills would have no idea what concrete tasks this skill enables.

Suggestions

Replace architectural jargon with concrete actions the skill performs (e.g., 'Manages team coordination, assigns roles, tracks project milestones, generates status reports').

Add an explicit 'Use when...' clause with natural trigger terms a user would actually say (e.g., 'Use when the user asks about team management, project coordination, role assignment, or sprint planning').

Remove implementation details like 'SKILL.md is a universal router', 'roles/ + specs/ + templates/' — these belong in the skill body, not the description field used for skill selection.

DimensionReasoningScore

Specificity

The description uses abstract, jargon-heavy language like 'full lifecycle team skill with clean architecture', 'universal router', and 'coordinator-only' without describing any concrete actions the skill performs. No specific capabilities are listed.

1 / 3

Completeness

The 'what' is extremely vague — it never explains what the skill actually does. The 'when' is limited to the artificial trigger phrase 'team lifecycle v4' with no real-world usage context. Both dimensions are very weak.

1 / 3

Trigger Term Quality

The only explicit trigger is 'team lifecycle v4', which is not a natural phrase any user would say. Terms like 'universal router', 'beat model', and 'clean architecture' are internal jargon, not user-facing keywords.

1 / 3

Distinctiveness Conflict Risk

The highly specific but artificial trigger 'team lifecycle v4' would unlikely conflict with other skills, but the vague domain description ('full lifecycle team skill') could overlap with any team management or project coordination skill.

2 / 3

Total

5

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

10

/

11

Passed

Repository
catlog22/Claude-Code-Workflow
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.