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 triggers, making it poorly suited for organic skill selection. While it outlines a high-level workflow (plan -> execute -> verify), the actual capabilities are described in abstract process terms rather than concrete actions. The internal implementation details (--role arg, coordinator/dispatcher pattern) are not useful for skill selection.

Suggestions

Replace the artificial trigger 'team roadmap-dev' with natural 'Use when...' guidance describing real user scenarios, e.g., 'Use when the user wants to plan and execute a multi-phase development project from a roadmap'.

Add specific concrete actions the skill performs, e.g., 'Breaks down roadmap items into implementation tasks, generates execution plans, runs code changes, and verifies results against acceptance criteria'.

Include natural trigger terms users would actually say, such as 'project planning', 'roadmap implementation', 'phased development', 'break down features', 'sprint planning'.

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 when...' clause describing user scenarios. The 'when' is technically present but not useful for natural skill selection.

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 'coordinator', 'dispatches', and '--role arg' are internal jargon, not natural user language. Missing natural terms like 'plan project', 'development workflow', 'break down tasks', etc.

1 / 3

Distinctiveness Conflict Risk

The artificial trigger 'team roadmap-dev' would prevent false positives, but the description's mention of 'roadmap-driven development workflow' and 'plan -> execute -> verify' could overlap with other project planning or development workflow skills. The specificity of the artificial trigger helps but the underlying domain description is somewhat generic.

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 provides highly actionable guidance with clear workflow sequencing, explicit validation checkpoints, and good progressive disclosure to role-specific files. The content is mostly concise but has some areas of mild verbosity (model selection rationale, some redundancy in explaining coordination patterns). Overall it's a strong skill that effectively communicates a complex multi-agent pipeline.

DimensionReasoningScore

Conciseness

The content is mostly efficient and avoids explaining basic concepts, but includes some sections that could be tightened—the Model Selection Guide rationale column is somewhat redundant, and the architecture ASCII diagram, while helpful, is verbose. The Delegation Lock table is thorough but borderline over-specified for things Claude could infer.

2 / 3

Actionability

Provides concrete spawn_agent templates with exact parameters, specific tool call allowlists/blocklists, exact file paths, timeout values (1800000ms), and precise session directory structures. The worker spawn template is copy-paste ready and the error handling table gives specific resolutions.

3 / 3

Workflow Clarity

The multi-phase pipeline is clearly sequenced (PLAN -> EXEC -> VERIFY with gap closure loop, max 3 iterations). Validation checkpoints are explicit: agent health checks via list_agents, verification phase with gap closure feedback loops, timeout escalation protocol (STATUS_CHECK -> FINALIZE -> mark timed_out -> close). The Delegation Lock acts as a pre-execution validation gate.

3 / 3

Progressive Disclosure

SKILL.md serves as a clear router/overview with well-signaled one-level-deep references to role files (roles/coordinator/role.md, roles/planner/role.md, etc.) and specs (specs/pipelines.md). The Role Registry table provides a clean navigation index. Content is appropriately split between the overview here and detailed role instructions in referenced 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.