CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-code-agent-teams

This skill should be used when the user asks to "create an agent team", "run a multi-agent team", "coordinate multiple Claude sessions", "use agent teams", or wants to parallelize work across multiple Claude Code instances.

56

Quality

71%

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 ./plugins/toolkit/skills/claude-code-agent-teams/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

A well-structured, appropriately split skill body: an actionable overview with copy-paste settings/commands and a clear enable→start→steer→cleanup lifecycle, delegating depth to a single well-signaled reference file. The only notable gaps are mild cross-section redundancy and a missing hook configuration example.

DimensionReasoningScore

Conciseness

The body is dense and Claude-Code-specific (settings JSON, keyboard shortcuts, storage paths) rather than explaining generally known concepts, but there is mild redundancy across 'When to Use Agent Teams', 'Agent Teams vs Subagents', and 'Best Practices', and the 'Starting a Team' example prompt is padded. This matches anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') — not anchor 5's 'every token earns its place'.

4 / 5

Actionability

Concrete, executable guidance dominates: the enabling settings JSON, `claude --teammate-mode in-process`, natural-language team-creation prompts, keyboard shortcuts, hook names with exit-code semantics ("Exit code 2 sends feedback"), and storage paths. The minor gap keeping it below anchor 5 is the hooks section, which names `TeammateIdle`/`TaskCompleted` and their exit-code behavior but gives no configuration example.

4 / 5

Workflow Clarity

The body follows a coherent lifecycle — enable (Prerequisites) → start (Starting a Team) → control/steer (Controlling, 'Monitor and steer', hook-based quality gates that send feedback and keep teammates working) → clean up ('Shut down all teammates first', 'Always use the lead to clean up'). Checkpoints and feedback loops are mostly present, but there's no explicit validation before cleanup or team disbanding, matching anchor 4 ('clear sequence with most checkpoints present; minor validation gaps').

4 / 5

Progressive Disclosure

SKILL.md is a clean overview pointing to one clearly signaled reference — 'See [Agent Teams Guide](./references/agent-teams-guide.md) for the complete reference including use case examples, architecture details, and troubleshooting' — and that file exists, is one level deep (it links only external URLs, no nested local references), and holds the detail (262 lines of use cases, architecture, troubleshooting). This matches anchor 5 ('clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

17

/

20

Passed

Description

52%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 trigger-first: it excels at 'when' with natural, well-varied trigger phrases, but omits the 'what' entirely — no capability statement appears in the frontmatter. Its strongest dimension is trigger term quality; its weakest is completeness.

Suggestions

Open with a one-sentence capability statement in third person (e.g., 'Coordinates multiple Claude Code instances working as a team with shared task lists, inter-agent messaging, and centralized management.') before the trigger clause, so the description answers both 'what' and 'when'.

Fold 1-2 of the concrete capabilities from the body into the description to raise specificity — e.g., mention spawning teammates with specific models, plan approval, and the shared task list.

Consider a trigger phrase that disambiguates from subagents (e.g., 'when teammates need to share findings and coordinate directly rather than report back'), reducing overlap with a subagent/parallelization skill.

DimensionReasoningScore

Specificity

The description names the domain ("parallelize work across multiple Claude Code instances") and one concrete action (parallelizing work), but never states what the skill actually does (coordinate teammates via shared task lists, inter-agent messaging, centralized management) — that 'what' lives only in the body. It fits anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'): more concrete than 'Processes PDF files' (2), but not the several specific actions of anchor 4.

3 / 5

Completeness

The 'when' is explicit and strong ("This skill should be used when the user asks to..."), but the 'what' is entirely absent — the description never says what the skill does or provides. This matches anchor 2 ('only when is present without what'); it cannot reach anchor 4, which requires both 'what' and 'when', because no capability statement exists anywhere in the description.

2 / 5

Trigger Term Quality

Quotes like "create an agent team", "run a multi-agent team", "coordinate multiple Claude sessions", "use agent teams" cover natural phrasings users would actually say, with synonym variation across team/sessions/instances. It is short of anchor 5's comprehensiveness — common variations such as 'spawn teammates', 'parallel Claude sessions', or 'multi-Claude' are missing — matching anchor 4 ('good keyword coverage; a few natural terms missing').

4 / 5

Distinctiveness Conflict Risk

Triggers like "create an agent team" and "run a multi-agent team" occupy a clear niche, but "parallelize work across multiple Claude Code instances" overlaps with the closely related subagent/parallelization feature, so the wrong skill could plausibly trigger. This is anchor 4 ('mostly distinct; minor overlap risk with closely related skills') rather than anchor 5's minimal conflict risk.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

dwmkerr/claude-toolkit

Path

plugins/toolkit/skills/claude-code-agent-teams/SKILL.md

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.