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
59%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.codex/skills/team-executor/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
227244f
Table of Contents
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.