CtrlK
BlogDocsLog inGet started
Tessl Logo

team-ultra-analyze

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

Quality

58%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.codex/skills/team-ultra-analyze/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.