CtrlK
BlogDocsLog inGet started
Tessl Logo

team-coordinate

Universal team coordination skill with dynamic role generation. Uses team-worker agent architecture with role-spec files. Only coordinator is built-in -- all worker roles are generated at runtime as role-specs and spawned via team-worker agent. Beat/cadence model for orchestration. Triggers on "Team Coordinate ".

62

Quality

53%

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 ./.claude/skills/team-coordinate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

57%

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 communicates a unique architectural approach to team coordination and provides an explicit trigger phrase, making it distinctive. However, it focuses heavily on implementation details (role-specs, beat/cadence model) rather than concrete user-facing capabilities, and the trigger guidance is limited to a single literal phrase rather than describing natural user scenarios. The description would benefit from listing specific actions and broadening the 'when to use' guidance.

Suggestions

Add concrete user-facing actions like 'coordinates multi-agent tasks, assigns dynamic roles, manages parallel workstreams, synthesizes team outputs'.

Expand the 'when' clause beyond the literal trigger phrase to include natural user intents, e.g., 'Use when the user needs to break a complex task into parallel subtasks, coordinate multiple roles, or orchestrate multi-step workflows'.

Include natural trigger term variations users might say, such as 'delegate', 'parallel tasks', 'multi-agent', 'orchestrate', 'team up'.

DimensionReasoningScore

Specificity

The description names the domain (team coordination) and mentions some architectural details (team-worker agent architecture, role-spec files, beat/cadence model), but these are implementation details rather than concrete user-facing actions. It doesn't list specific things it does like 'assign tasks', 'track progress', or 'manage deadlines'.

2 / 3

Completeness

The 'what' is partially addressed (team coordination with dynamic role generation), and there is a trigger clause ('Triggers on "Team Coordinate"'), but the 'when' is very narrow—it only specifies a literal trigger phrase rather than describing scenarios or user intents that should activate this skill.

2 / 3

Trigger Term Quality

It includes the explicit trigger phrase 'Team Coordinate' and mentions 'team coordination', but these are somewhat narrow. It lacks natural variations users might say like 'organize team', 'delegate tasks', 'project planning', 'collaborate', or 'assign roles'.

2 / 3

Distinctiveness Conflict Risk

The description is quite distinctive with its specific architecture (team-worker agent, role-spec files, beat/cadence model) and explicit trigger phrase. It's unlikely to conflict with other skills due to its unique coordination paradigm and narrow trigger.

3 / 3

Total

9

/

12

Passed

Implementation

50%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a structurally ambitious coordination skill that provides a clear architectural overview and some concrete spawn/completion patterns, but falls short on actionability for key phases (task analysis, role-spec generation) which are deferred to external files without inline examples. The workflow sequence is present but lacks explicit validation checkpoints between phases, and the document is longer than necessary due to inline schemas and directory trees that could be referenced externally.

Suggestions

Add a concrete example of a generated role-spec (even abbreviated) inline so the coordinator has a tangible template to follow, rather than only referencing specs/role-spec-template.md

Insert explicit validation checkpoints into the lifecycle workflow (e.g., 'Verify task-analysis.json has ≥1 task before proceeding to Phase 2', 'Confirm role-spec files exist before spawning workers')

Move the full team-session.json schema and directory tree to a referenced spec file (e.g., specs/session-schema.md) and keep only a brief summary inline to reduce token footprint

Add a concrete end-to-end mini-example showing input task description → generated roles → task chain → spawn commands to make the orchestration flow actionable rather than abstract

DimensionReasoningScore

Conciseness

The skill is moderately efficient but includes substantial structural detail (full JSON schemas, directory trees, architecture diagrams) that could be offloaded to reference files. Some tables and sections repeat information (e.g., CLI tools listed twice). However, most content is domain-specific configuration that Claude wouldn't inherently know.

2 / 3

Actionability

The spawn template and completion action provide concrete, copy-paste-ready patterns, but many sections describe architecture rather than instruct. Key operations like 'generate role-specs' and 'task analysis' lack concrete examples of what the output should look like. The Agent() and AskUserQuestion() calls are specific and executable, but Phase 1-5 details are deferred to external files without inline summaries.

2 / 3

Workflow Clarity

The lifecycle is outlined as a clear sequence (Phase 0-5) with a callback loop, and session resume has explicit reconciliation steps. However, validation checkpoints are largely absent — there's no explicit 'verify role-spec was generated correctly' or 'validate task-analysis.json before proceeding' step. Error handling is listed but not integrated into the workflow as feedback loops.

2 / 3

Progressive Disclosure

References to specs/ and roles/ files are well-signaled in a table, which is good. However, no bundle files were provided, so we can't verify these references resolve. The SKILL.md itself is quite long (~200+ lines) with inline JSON schemas and directory structures that could be in separate reference files. The split between what's inline vs. referenced feels inconsistent — full session JSON schema is inline but core phase logic is deferred.

2 / 3

Total

8

/

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.