CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-teams

Claude Code Agent Teams - default team-based development with strict TDD pipeline enforcement

52

Quality

65%

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/agent-teams/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's greatest strength is workflow clarity — the TDD pipeline is sequenced with explicit verification gates, blocking rules, and error-recovery loops. Its weaknesses are token efficiency (the pipeline is stated three times) and progressive disclosure (a long monolith whose cross-references point to files not shipped in the bundle, plus a malformed settings example).

Suggestions

Consolidate the three renditions of the 10-step pipeline (Core Principle box, Feature Agent Workflow, Task Dependency Chain) into one canonical presentation and reference it from the other sections.

Fix the Environment Setup example — the JSON key 'agent teams (via .claude/agents/ definitions)': '1' is not a valid settings entry; state the actual env var or remove the section.

Move the agent roster details, task-chain template, and agent-definition format into a references/ file in the bundle (and either bundle or clearly mark the cross-referenced skills like base.md and icpg.md) so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

The same 10-step pipeline is rendered three times in full — the ASCII 'STRICT FEATURE PIPELINE' box, the 'Feature Agent Workflow' step list, and the 'Task Dependency Chain' ASCII box — plus a fourth parallel-execution diagram repeating the same task names, which is substantial padded redundancy across ~450 lines. It avoids explaining concepts Claude already knows (better than anchor 1's 'extensively explains known concepts'), so it sits at 'noticeably verbose; several padded sections' rather than 'severely verbose'.

2 / 5

Actionability

Most guidance is executable and specific: a concrete git/gh command sequence ('git checkout -b feature/{feature-name}', 'gh pr create'), 'polyphony spawn "$FEATURE" --type feature', exact task-naming conventions, an 80% coverage threshold, and enumerated tool lists for each agent. It falls short of 5 because key details defer to unbundled files ('Follow the atomic TODO format from base.md skill', 'Uses Ralph loops') and the required-settings example is malformed (a JSON key 'agent teams (via .claude/agents/ definitions)': '1').

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced with explicit validation checkpoints and feedback loops: 'Quality Agent runs tests and verifies ALL new tests fail', 'If tests fail or coverage insufficient -> fix and re-request', 'If Critical or High issues -> fix and re-request review', and 'Merger Agent refuses to branch if any predecessor task is incomplete'. This matches the top anchor ('clear sequence with explicit validation steps; feedback loops for error recovery'), and the destructive/batch git operations (staging, branching) do have validation ('Stages ONLY files changed for this feature (never git add -A)', predecessor verification).

5 / 5

Progressive Disclosure

Section structure is good (clear ## headers, tables), but the document is a ~450-line monolith: the agent roster details, all three pipeline renditions, and the task-chain template are inlined where a reference file would serve, and no bundle files exist (no references/, scripts/, or assets/). The many cross-references (base.md, code-review.md, security.md, icpg.md, code-graph.md, .claude/agents/ templates) point to files not present in this bundle, so navigation leads nowhere — fitting 'some structure but could be better organized; references present but not clearly signaled' rather than 4's 'most content appropriately placed'.

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 communicates a clear identity and one differentiating capability, but it reads more like a title-plus-tagline than a capability description: no trigger clause, few concrete actions, and limited keyword variation. Folding the 'when-to-use' content and a short list of concrete actions into the description would move it up a full band.

Suggestions

Add an explicit 'Use when...' clause to the description itself (e.g., 'Use when spawning multiple agents for parallel feature development or when the user asks for team-based/TDD workflows') instead of relying on the separate when-to-use field.

List 2-3 concrete actions in the description (e.g., 'spawns one feature agent per feature, verifies RED/GREEN test phases, and gates merges on code review and security scans') to lift specificity and trigger-term coverage.

Include natural synonyms users would say — 'parallel development', 'multi-agent', 'test-driven' — to broaden trigger matching.

DimensionReasoningScore

Specificity

The description names its domain ("Claude Code Agent Teams") and one concrete capability ("strict TDD pipeline enforcement"), but offers no other concrete actions such as spawning agents, verifying RED/GREEN transitions, or creating PRs — matching the 'domain plus 1-2 concrete actions, not comprehensive' anchor. It is above score 2 ('actions minimal or generic') because 'strict TDD pipeline enforcement' is a specific, distinguishing capability, but below score 4, which requires several specific listed actions.

3 / 5

Completeness

The 'what' is clear (default team-based development with strict TDD pipeline enforcement), but the description itself contains no 'Use when...' clause or equivalent trigger guidance — the when-guidance lives in a separate 'when-to-use' frontmatter field, not the description. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3; it does not fall to 2 because the 'what' half is explicit.

3 / 5

Trigger Term Quality

It contains relevant keywords a user might say — "agent teams", "team-based development", "TDD pipeline" — but misses common variations and synonyms like "parallel development", "feature agents", "multi-agent", or "test-driven". This fits anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than 4, whose example shows a fuller spread of natural terms.

3 / 5

Distinctiveness Conflict Risk

"Agent Teams" with "strict TDD pipeline enforcement" carves a fairly distinct niche with minimal conflict risk against generic skills, matching 'mostly distinct; minor overlap risk'. It is not a 5 because the body itself notes overlap with a 'team-coordination' skill it supersedes, and 'team-based development' is broad enough to collide with general orchestration/coordination skills.

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

alinaqi/maggy

Path

skills/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.