CtrlK
BlogDocsLog inGet started
Tessl Logo

team-executor

Lightweight session execution skill. Resumes existing team-coordinate sessions for pure execution via team-worker agents. No analysis, no role generation -- only loads and executes. Session path required. Triggers on "Team Executor".

67

Quality

59%

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-executor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

42%

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 carves out a clear, distinct niche and explicitly states what it does NOT do, which helps with disambiguation. However, it relies on internal jargon and a single artificial trigger phrase rather than natural user language, and the concrete actions ('loads and executes') remain vague. The description would benefit from more natural trigger terms and clearer specification of what execution entails.

Suggestions

Replace or supplement the artificial trigger 'Team Executor' with natural phrases users might say, such as 'run team session', 'execute team workflow', or 'resume coordination session'.

Specify what 'executes' means concretely — e.g., 'dispatches tasks to team-worker agents, monitors progress, collects results' — to improve specificity of capabilities.

DimensionReasoningScore

Specificity

Names the domain (session execution, team-worker agents) and some actions (resumes sessions, loads and executes), but the actual concrete actions are vague — 'loads and executes' what exactly? The negations ('No analysis, no role generation') help clarify scope but don't add concrete capabilities.

2 / 3

Completeness

The 'what' is partially addressed (resumes sessions, executes via team-worker agents), and there is a trigger clause ('Triggers on "Team Executor"'), but the 'when' is extremely narrow and artificial — it only triggers on a specific phrase rather than describing natural use conditions. The trigger guidance is present but minimal.

2 / 3

Trigger Term Quality

The only explicit trigger is 'Team Executor', which is a specific internal phrase unlikely to be naturally used by users. There are no natural keywords a user would organically say when needing this skill — terms like 'session execution', 'team-coordinate', and 'team-worker agents' are internal jargon.

1 / 3

Distinctiveness Conflict Risk

The description is highly specific to a narrow niche — resuming team-coordinate sessions for pure execution with no analysis or role generation. The explicit 'Triggers on "Team Executor"' phrase and the negations make it very unlikely to conflict with other skills.

3 / 3

Total

8

/

12

Passed

Implementation

77%

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 execution skill with strong actionability — concrete function calls, specific templates, and clear error handling tables. The workflow is clearly sequenced with proper validation gates and state reconciliation. Minor weaknesses include some redundancy between sections (validation appears in multiple forms) and references to bundle files that aren't provided, making progressive disclosure harder to fully evaluate.

Suggestions

Remove the redundant Role Router dispatch logic table since it restates the validation section without adding new information.

Provide the referenced bundle files (roles/executor/role.md, specs/session-schema.md) or note them as expected session artifacts to improve progressive disclosure scoring.

DimensionReasoningScore

Conciseness

The skill is moderately efficient but includes some redundancy — the dispatch logic table largely repeats the validation section, and the architecture ASCII diagram adds little value given the textual explanation. Some sections like the Integration table and Model Selection Guide are useful but could be tighter.

2 / 3

Actionability

Provides concrete, executable spawn templates with specific function calls (spawn_agent, wait_agent, close_agent, list_agents, send_message, followup_task, request_user_input), specific timeout values, exact JSON-like structures, and precise argument formats. The worker spawn template and completion action are copy-paste ready.

3 / 3

Workflow Clarity

The lifecycle is clearly sequenced (validate -> Phase 0 reconcile -> Phase 1 spawn -> worker callback -> advance -> Phase 2 report). Validation checkpoints are explicit before execution begins, state reconciliation handles orphaned/interrupted tasks, timeout handling includes a graduated escalation (STATUS_CHECK -> FINALIZE -> mark timed_out), and error recovery paths are well-defined.

3 / 3

Progressive Disclosure

References roles/executor/role.md and specs/session-schema.md but no bundle files are provided to verify these exist. The skill keeps most content inline rather than splitting detailed sections (like the spawn template or completion action handlers) into separate files. The structure is reasonable but the referenced files are unverifiable and some inline content could benefit from being split out.

2 / 3

Total

10

/

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.