CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-teams

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

51

Quality

40%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/agent-teams/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 identifies a domain (team-based agent development with TDD) but lacks concrete actions, explicit trigger guidance, and natural user-facing keywords. It reads more like a title than a functional description, making it difficult for Claude to reliably select this skill over alternatives.

Suggestions

Add an explicit 'Use when...' clause specifying trigger conditions, e.g., 'Use when the user requests multi-agent collaboration, parallel task execution, or test-driven development workflows.'

List specific concrete actions the skill performs, such as 'Orchestrates sub-agents for parallel development, enforces red-green-refactor TDD cycles, coordinates task assignment and merging across agent teams.'

Include natural keyword variations users might say, such as 'test-driven development', 'multi-agent', 'parallel coding', 'sub-agents', 'team workflow', and 'CI pipeline'.

DimensionReasoningScore

Specificity

Names the domain ('team-based development') and mentions a specific methodology ('strict TDD pipeline enforcement'), but does not list concrete actions like 'creates test files', 'runs test suites', 'assigns tasks to agents', etc.

2 / 3

Completeness

There is a weak 'what' (team-based development with TDD pipeline enforcement) but no 'when' clause at all — no 'Use when...' or equivalent trigger guidance, which per the rubric should cap completeness at 2, and the 'what' itself is also vague, bringing this to 1.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'team-based development', 'TDD', and 'pipeline', but misses common user-facing variations such as 'test-driven development', 'multi-agent', 'parallel tasks', 'sub-agents', or 'testing workflow'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'Agent Teams' and 'TDD pipeline' provides some distinctiveness, but 'team-based development' is broad enough to overlap with other collaboration or multi-agent skills, and 'default' in the description suggests it could be a catch-all.

2 / 3

Total

7

/

12

Passed

Implementation

47%

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

This skill has excellent workflow clarity with a well-defined 10-step pipeline, explicit quality gates, and clear dependency chains. However, it is severely over-verbose, repeating the same pipeline information in multiple formats (ASCII diagrams, numbered steps, task chain, parallel execution diagram). The content would benefit greatly from consolidation and splitting detailed reference material into separate files.

Suggestions

Consolidate the pipeline description to a single representation - remove the redundant ASCII box diagram, Feature Agent Workflow section, and Task Dependency Chain section in favor of one concise description with the dependency chain.

Move the detailed inter-agent communication examples, parallel execution diagrams, and branch/PR strategy into separate reference files, keeping only a brief summary in SKILL.md.

Replace the ASCII box for the agent roster with just the table - the box diagram and table contain identical information.

Add executable examples for key operations like spawning agents and creating task chains, rather than just describing the concepts abstractly.

DimensionReasoningScore

Conciseness

Extremely verbose with massive ASCII box diagrams that repeat information multiple times. The pipeline is described in the Core Principle section, then again in Feature Agent Workflow, then again in Task Dependency Chain Model, then again in Parallel Feature Execution. The agent roster is described twice (box diagram + table). Inter-agent communication examples are obvious given the workflow description. Much of this could be condensed to 1/3 the length.

1 / 3

Actionability

Provides concrete task naming conventions, git commands for the Merger Agent, and clear role definitions. However, lacks executable code for spawning agents, creating tasks, or the actual API calls needed. References commands like `/spawn-team` and `/ralph-loop` without showing their implementation. The agent definition format is deferred to 'see agent files' rather than shown.

2 / 3

Workflow Clarity

The 10-step pipeline is extremely well-defined with explicit task dependencies, blocking rules, and verification checkpoints at each stage. Quality gates are clearly specified with concrete thresholds (coverage >= 80%, block on Critical/High). Feedback loops are explicit (fix and re-request review/scan). The dependency chain model makes ordering unambiguous.

3 / 3

Progressive Disclosure

References external skills (base.md, code-review.md, security.md) with a clear integration table, which is good. However, the SKILL.md itself is monolithic - the pipeline description, agent roster, task chain model, communication patterns, and branch strategy could be split into separate files. The content that is inline is far too detailed for an overview document.

2 / 3

Total

8

/

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

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
alinaqi/claude-bootstrap
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.