CtrlK
BlogDocsLog inGet started
Tessl Logo

team

N coordinated agents on shared task list using Claude Code implicit agent teams

52

Quality

58%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/team/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers an unusually complete, executable orchestration spec with a genuinely well-gated staged pipeline, but it is a monolithic 1,000+ line document with significant duplication and reference material that should live in bundle files. Workflow clarity is excellent; token efficiency and file organization are the main drags.

Suggestions

Split reference-grade material into bundle files (e.g. references/role-routing.md for the per-role provider/model spec and aliases, references/worktree-api.md for the worktree function table, references/cli-workers.md for the Cursor/Codex evidence-timeout and outbox policies), keeping SKILL.md as an overview with one-level-deep pointers.

Deduplicate the repeated "Claude Code 2.1.178+ removed TeamCreate/TeamDelete" caveat into a single stated fact, and consolidate the shutdown protocol described in both Phase 7 and the Shutdown Protocol section.

Trim Claude-obvious filler such as provider marketing descriptions, install URLs, and env-var value enumerations that add tokens without changing execution.

DimensionReasoningScore

Conciseness

The ~1,050-line body repeats the "Claude Code 2.1.178+ removed TeamCreate/TeamDelete; no TeamDelete exists" caveat at least eight times, describes the shutdown protocol twice (Phase 7 vs. the Shutdown Protocol section), and inlines provider-routing trivia (Antigravity install URLs, env-var caps, tier minutiae) that Claude does not need from this file. This matches 'noticeably verbose; several unnecessary explanations or padded sections'; not 3 because the padding is pervasive rather than occasional, though much of the operational detail is legitimately novel, keeping it above 1.

2 / 5

Actionability

Concrete JSON payloads for task entries, owner assignment, and shutdown messages; exact state_write/state_read call shapes with a state schema table; a runnable cleanup command (node scripts/cleanup-orphans.mjs --team-name ...); routing tables; and a copy-paste worker preamble. Minor gaps: several sections (Goal Workflow Relationship, Cursor/Codex startup evidence, Stickiness) are prose-only direction without executable artifacts. Not 5 for those abstract stretches; not 3 because the guidance is overwhelmingly executable.

4 / 5

Workflow Clarity

The staged pipeline (team-plan -> team-prd -> team-exec -> team-verify -> team-fix) has explicit per-stage entry and exit criteria, a bounded verify/fix feedback loop with max_fix_loops terminal handling, watchdog thresholds (5-min status check, 10-min dead worker, 2-failure reassign threshold), and a blocking shutdown gated on acknowledgement or timeout. This matches the top anchor: clear sequence, explicit validation stage, feedback loops, and terminal-state checklist; the only deduction risk is that the sheer volume of side sections buries the core sequence.

5 / 5

Progressive Disclosure

Sections and a table of stage routing are well organized, but the skill ships no reference/asset bundle at all: large reference-grade blocks (the worktree API table, outbox reader functions, per-role provider/model routing spec, Team-vs-Swarm comparison, Cursor/Codex evidence timeout policy) are inlined when they clearly belong in separate one-level-deep files, and inline pointers (skills/cancel/SKILL.md, docs/REFERENCE.md, scripts/cleanup-orphans.mjs) target files outside this bundle. Fits 'some structure but content that should be separate is inline'; not 4 given how much reference material is inlined, not 2 given the strong section structure.

3 / 5

Total

14

/

20

Passed

Description

53%Weight 40%Scale 1-5

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 is a terse, accurate 'what' statement with a distinct technical identity, but it omits any 'when to use' trigger guidance and most natural trigger vocabulary a user would say. It would benefit most from an explicit use-when clause with common synonyms.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks to parallelize work across multiple agents, run a team of workers, or coordinate subtasks on a shared task list."

Add natural synonyms and variations users would actually say ("parallel agents", "multiple agents", "fan out", "delegate work") to broaden trigger term coverage.

Mention one or two more concrete capabilities (task decomposition, verify/fix pipeline) so the description covers more than a single action.

DimensionReasoningScore

Specificity

"N coordinated agents on shared task list using Claude Code implicit agent teams" names the domain plus 1-2 concrete actions (spawning coordinated agents, working a shared task list), but coverage stops there -- no mention of decomposition, monitoring, shutdown, or hybrid CLI workers. Not 4: it does not list several specific actions; not 2: it is more than a bare domain label.

3 / 5

Completeness

The 'what' is clear (spawn N coordinated agents on a shared task list via implicit agent teams) but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4: 'when' is entirely absent, not merely weakly implied.

3 / 5

Trigger Term Quality

Natural terms like "agents", "team", "task list", and "coordinated" are present, but common variations users would actually say ("parallel", "multiple agents", "delegate", "fan out", "swarm") are missing. Not 4: keyword coverage is too thin for 'good coverage'; not 2: the terms present are relevant rather than purely generic.

3 / 5

Distinctiveness Conflict Risk

"Claude Code implicit agent teams" plus "shared task list" carves a mostly distinct orchestration niche with only minor overlap risk against closely related delegation/orchestration skills. Not 5: the terseness leaves "coordinated agents" broad enough to overlap with generic multi-agent delegation skills; not 3: it is more specific than 'somewhat specific but could still overlap'.

4 / 5

Total

13

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1054 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
Yeachan-Heo/oh-my-claudecode
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.