Unified team skill for plan-and-execute pipeline. Pure router — coordinator always. Beat model is coordinator-only in monitor.md. Triggers on "team planex".
42
42%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.codex/skills/team-planex/SKILL.mdQuality
Discovery
7%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description reads like internal developer notes rather than a functional skill description. It fails to communicate what the skill actually does for users, relies on jargon ('pure router', 'beat model', 'coordinator-only'), and provides no natural trigger terms beyond the specific phrase 'team planex'. It would be nearly impossible for Claude to correctly select this skill based on user intent alone.
Suggestions
Replace jargon with a clear explanation of what the plan-and-execute pipeline does in user-facing terms (e.g., 'Coordinates multi-step task execution by breaking complex requests into subtasks and delegating them').
Add a 'Use when...' clause with natural trigger terms describing scenarios where users would need this skill (e.g., 'Use when the user needs to break down a complex task into steps, coordinate multiple agents, or execute a multi-phase plan').
Remove internal implementation details like 'pure router', 'beat model', and 'coordinator-only in monitor.md' that serve no purpose for skill selection.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague, jargon-heavy language like 'plan-and-execute pipeline', 'pure router', 'coordinator always', and 'beat model is coordinator-only in monitor.md' without describing any concrete user-facing actions or capabilities. | 1 / 3 |
Completeness | The 'what' is extremely vague — it says it's a 'router' for a 'plan-and-execute pipeline' but never explains what that pipeline actually does for the user. The 'when' is limited to the trigger phrase 'team planex' with no broader context for when this skill should be selected. | 1 / 3 |
Trigger Term Quality | The only explicit trigger is 'team planex', which is internal jargon unlikely to be naturally used by end users. Terms like 'pure router', 'coordinator', and 'beat model' are technical internals, not natural user language. | 1 / 3 |
Distinctiveness Conflict Risk | The very specific trigger phrase 'team planex' does reduce conflict risk since it's unlikely to match other skills accidentally. However, the rest of the description is so vague that without that exact trigger phrase, it would be impossible to distinguish this skill's purpose from other coordination or pipeline skills. | 2 / 3 |
Total | 5 / 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 strong orchestration skill with highly actionable content — the delegation lock, spawn templates, and timeout cascades are concrete and immediately usable. The workflow is well-sequenced with clear error recovery paths. The main weakness is moderate verbosity: some sections (model selection guide, message semantics table, agent health check) could be more concise or split into referenced files to reduce the token footprint of the main SKILL.md.
Suggestions
Move the 'v4 Agent Coordination' section (message semantics, two-phase pattern, agent health check, named agent targeting) into a separate reference file like specs/coordination.md to reduce SKILL.md size and improve progressive disclosure.
Trim the Model Selection Guide — since both roles use default model with 'high' effort, a single sentence ('All workers use default model with high reasoning_effort; override in spawn_agent if needed') would suffice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly well-structured and avoids explaining basic concepts, but includes some redundancy (e.g., the model selection guide's rationale column, the verbose spawn template, and the agent coordination section repeating patterns already shown). The delegation lock table and architecture diagram are efficient, but overall it could be tightened. | 2 / 3 |
Actionability | Provides concrete spawn_agent templates with exact parameter structures, specific tool call allow/block lists, explicit timeout values (1800000ms), exact file paths, and copy-paste ready code patterns. The delegation lock table is immediately actionable with clear verdicts. | 3 / 3 |
Workflow Clarity | The two-phase pipeline pattern is clearly sequenced (analyze → dispatch → spawn planner → wait → spawn executors → wait). Timeout cascade with explicit steps (STATUS_CHECK → FINALIZE → close_agent) provides a feedback loop for error recovery. The delegation lock acts as a validation checkpoint before every tool call. Error handling table covers failure scenarios with resolutions. | 3 / 3 |
Progressive Disclosure | References to role files (roles/coordinator/role.md, roles/planner/role.md, roles/executor/role.md) and specs (specs/pipelines.md) are clearly signaled with links. However, no bundle files were provided to verify these exist, and the SKILL.md itself is quite long (~180 lines) with sections like the full session directory structure and agent coordination details that could potentially live in referenced files. The architecture is well-organized but borders on monolithic. | 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 | |
5ff5e86
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.