CtrlK
BlogDocsLog inGet started
Tessl Logo

team-roadmap-dev

Unified team skill for roadmap-driven development workflow. Coordinator discusses roadmap with user, then dispatches phased execution pipeline (plan -> execute -> verify). All roles invoke this skill with --role arg. Triggers on "team roadmap-dev".

67

Quality

60%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.codex/skills/team-roadmap-dev/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

35%

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 relies on an artificial trigger phrase ('team roadmap-dev') rather than natural language cues, making it poorly suited for selection from a pool of skills based on user intent. It describes a process architecture (coordinator, roles, pipeline phases) more than concrete capabilities, and uses internal jargon like '--role arg' that users wouldn't naturally use. The description would benefit significantly from natural trigger terms and specific action descriptions.

Suggestions

Replace the artificial trigger 'team roadmap-dev' with natural language triggers like 'Use when the user wants to plan and execute a multi-phase development project, break down a roadmap into tasks, or coordinate planning and implementation steps.'

Add specific concrete actions such as 'Breaks down product roadmaps into implementation phases, generates task plans, executes code changes per phase, and verifies deliverables against requirements.'

Remove internal implementation details like '--role arg' and 'All roles invoke this skill' which are irrelevant to skill selection and replace with user-facing capability descriptions.

DimensionReasoningScore

Specificity

Names the domain (roadmap-driven development) and describes a pipeline (plan -> execute -> verify), but the actual concrete actions are vague — 'discusses roadmap', 'dispatches phased execution pipeline' are abstract process descriptions rather than specific capabilities like 'creates task breakdowns' or 'generates implementation plans'.

2 / 3

Completeness

It partially answers 'what' (coordinator discusses roadmap, dispatches phased execution) and has a trigger clause ('Triggers on "team roadmap-dev"'), but the trigger is an artificial command rather than a natural use-case description. The 'when' is technically present but not useful for natural language matching.

2 / 3

Trigger Term Quality

The only explicit trigger is the artificial phrase 'team roadmap-dev', which is not something a user would naturally say. Terms like 'roadmap', 'phased execution pipeline', and '--role arg' are technical jargon unlikely to match natural user requests. Missing natural terms like 'project planning', 'development workflow', 'break down tasks', etc.

1 / 3

Distinctiveness Conflict Risk

The artificial trigger 'team roadmap-dev' makes it distinctive in a narrow sense, but the underlying description ('roadmap-driven development workflow') could overlap with project management, planning, or general development skills. The specificity of the trigger command helps avoid false positives but the conceptual scope is broad.

2 / 3

Total

7

/

12

Passed

Implementation

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 clearly defines architecture, role routing, delegation constraints, and multi-phase workflow with explicit validation checkpoints. The actionability is excellent with concrete spawn templates, tool call patterns, and directory structures. Minor verbosity in explanatory sections (model selection rationale, context accumulation descriptions) prevents a perfect conciseness score, but overall the content is high quality and well-organized.

DimensionReasoningScore

Conciseness

The skill is fairly long but most content is structural/architectural documentation that a coordinator agent needs. Some sections like the Model Selection Guide rationale column and the Multi-Phase Context Accumulation explanations add moderate verbosity without being strictly necessary. The ASCII architecture diagram is helpful but could be tighter.

2 / 3

Actionability

The skill provides concrete, copy-paste-ready templates for spawning agents, specific tool call patterns with named targeting, exact file paths, a complete delegation lock table with allowed/blocked verdicts, and executable spawn_agent/wait_agent/close_agent patterns. The session directory structure and error handling table are highly specific.

3 / 3

Workflow Clarity

The multi-step pipeline is clearly sequenced (PLAN -> EXEC -> VERIFY per phase, multi-phase progression). Validation checkpoints are explicit: gap closure loops with max 3 iterations, agent health checks via list_agents, verification phase with gap detection, and clear error recovery paths. The delegation lock acts as a validation gate for the coordinator role.

3 / 3

Progressive Disclosure

The skill serves as a clear router/overview pointing to one-level-deep role files (roles/coordinator/role.md, roles/planner/role.md, etc.) and specs (specs/pipelines.md). The Role Registry table provides a well-organized navigation index. Content is appropriately split between this overview and the referenced role files.

3 / 3

Total

11

/

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.