Deep collaborative analysis team skill. All roles route via this SKILL.md. Beat model is coordinator-only (monitor.md). Structure is roles/ + specs/. Triggers on "team ultra-analyze", "team analyze".
52
58%
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-ultra-analyze/SKILL.mdQuality
Discovery
40%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 is heavily focused on internal architecture and implementation details (roles, specs, coordinator patterns) rather than communicating what the skill does for the user. The 'what' is almost entirely absent — 'deep collaborative analysis' is vague and undefined. While it does provide explicit trigger phrases, they are artificial commands rather than natural user language.
Suggestions
Replace 'deep collaborative analysis' with specific concrete actions the skill performs, e.g., 'Performs multi-perspective analysis of complex problems by examining technical feasibility, risks, and strategic implications'.
Add natural trigger terms users would actually say, such as 'in-depth analysis', 'comprehensive review', 'multi-angle evaluation', or domain-specific terms relevant to the analysis type.
Remove internal implementation details (roles/, specs/, monitor.md, coordinator-only) from the description and replace with user-facing information about what problems this skill solves and what outputs it produces.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague, abstract language like 'deep collaborative analysis' without listing any concrete actions. It focuses on internal architecture ('roles/', 'specs/', 'monitor.md') rather than what the skill actually does for the user. | 1 / 3 |
Completeness | The 'when' is partially addressed via explicit trigger phrases, but the 'what' is extremely weak — 'deep collaborative analysis' tells nothing about what kind of analysis, on what data, or what outputs are produced. The description focuses on internal implementation details rather than user-facing functionality. | 2 / 3 |
Trigger Term Quality | It includes specific trigger phrases ('team ultra-analyze', 'team analyze') but these are artificial command-style triggers rather than natural keywords a user would organically say. No natural language variations like 'analyze data', 'deep analysis', or domain-specific terms are provided. | 2 / 3 |
Distinctiveness Conflict Risk | The custom trigger phrases ('team ultra-analyze') reduce conflict risk somewhat, but 'analysis' is extremely broad and could overlap with many other analytical skills. The description doesn't clarify what domain or type of analysis distinguishes it. | 2 / 3 |
Total | 7 / 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-crafted orchestration skill with strong actionability and workflow clarity. The delegation lock, spawn templates, and pipeline definitions give Claude precise, unambiguous instructions. The main weakness is moderate verbosity — some sections repeat patterns or include explanatory context that could be trimmed — and the SKILL.md carries a lot of inline detail that might benefit from being split into referenced files for better progressive disclosure.
Suggestions
Consider moving the v4 Agent Coordination section (Message Semantics, Parallel Phase Coordination, Agent Health Check, Named Agent Targeting) into a separate reference file like specs/agent-coordination.md to reduce SKILL.md length.
Remove the JavaScript-style pseudocode comments in the Parallel Phase Coordination section (e.g., '// EXPLORE phase: spawn N explorers in parallel') since the Worker Spawn Template already provides the concrete pattern — or consolidate them into a single authoritative example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly detailed and well-structured, but includes some redundant information (e.g., the architecture ASCII diagram partially duplicates the role registry table, and the v4 Agent Coordination section repeats spawn/wait patterns already shown in the Worker Spawn Template). Some sections like Message Semantics explain things Claude could infer. However, most content is domain-specific configuration that Claude genuinely needs. | 2 / 3 |
Actionability | The skill provides concrete, executable spawn_agent templates with exact parameter names, a clear delegation lock table with allowed/blocked tool calls, specific file paths, session directory structure, timeout values (1800000ms), and precise command patterns. The worker spawn template and parallel coordination code are copy-paste ready. | 3 / 3 |
Workflow Clarity | The pipeline modes (Quick/Standard/Deep) are clearly sequenced with explicit phase ordering. The timeout cascade (STATUS_CHECK → FINALIZE with interrupt → mark timed_out → close_agent) provides a clear error recovery loop. The delegation lock acts as a validation checkpoint before every tool call. Agent health check reconciliation handles crash recovery. The completion action provides explicit branching with user input. | 3 / 3 |
Progressive Disclosure | The skill references role files (roles/coordinator/role.md, etc.) and specs (specs/team-config.json) with proper links, which is good progressive disclosure. However, the SKILL.md itself is quite long (~200 lines of dense content) with sections like v4 Agent Coordination, Parallel Phase Coordination, and Named Agent Targeting that could potentially be split into separate reference files. Without bundle files provided, we can't verify the referenced paths exist, but the structure is reasonable if somewhat front-loaded. | 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.