CtrlK
BlogDocsLog inGet started
Tessl Logo

tdg-personal/team-builder

Interactive agent picker for composing and dispatching parallel teams

53

Quality

53%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

7%

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 too abstract and jargon-heavy to be effective for skill selection. It fails to list concrete actions, lacks natural trigger terms users would employ, and provides no explicit 'Use when...' guidance. The only slight strength is that the concept of parallel agent dispatch is somewhat distinctive.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g., 'Use when the user wants to run multiple agents in parallel, coordinate team tasks, or dispatch concurrent workflows.'

Replace abstract language with concrete actions, e.g., 'Selects agents from available options, configures parallel task assignments, and launches concurrent agent teams.'

Include natural user-facing keywords like 'multi-agent', 'parallel tasks', 'run agents simultaneously', 'team coordination', or 'concurrent execution'.

DimensionReasoningScore

Specificity

The description uses vague, abstract language. 'Interactive agent picker' and 'composing and dispatching parallel teams' are buzzword-heavy without listing concrete actions the skill performs (e.g., selecting agents, configuring team parameters, launching parallel tasks).

1 / 3

Completeness

The description only vaguely addresses 'what' and completely lacks a 'when' clause. There is no explicit trigger guidance for when Claude should select this skill.

1 / 3

Trigger Term Quality

The terms 'agent picker', 'composing', 'dispatching', and 'parallel teams' are technical jargon unlikely to match natural user language. Users would more likely say things like 'run multiple agents', 'assign tasks', or 'multi-agent workflow'.

1 / 3

Distinctiveness Conflict Risk

The concept of 'parallel teams' and 'agent picker' is somewhat niche, which provides some distinctiveness. However, the vague phrasing could overlap with other agent orchestration or task management skills.

2 / 3

Total

5

/

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 skill with excellent workflow clarity and actionability — the 5-step process is clearly sequenced with validation checkpoints, error handling, and concrete examples of expected inputs/outputs. The main weakness is moderate verbosity: the prefix-counting algorithm, dual layout explanations, and configuration details add length that could be trimmed or split into reference files. The end-to-end example effectively demonstrates the complete interaction pattern.

Suggestions

Consider moving the detailed directory layout examples and prefix-counting algorithm into a separate AGENT-DISCOVERY.md reference file, keeping only a brief summary in the main skill.

Trim the 'When to Use' section — Claude can infer when to use a team builder from the skill description and workflow.

DimensionReasoningScore

Conciseness

The skill is fairly detailed and well-structured, but includes some unnecessary explanation (e.g., the lengthy description of flat vs subdirectory layouts, the prefix-counting algorithm explanation). Some sections like 'When to Use' explain things Claude could infer. However, most content is genuinely instructive rather than padded.

2 / 3

Actionability

The skill provides concrete, specific guidance at every step: exact menu formats to display, specific input patterns to accept ('1,3' or 'security + seo'), exact Agent tool parameters (subagent_type, prompt format), error handling behavior, and a complete end-to-end example. The instructions are copy-paste actionable for Claude.

3 / 3

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit validation points: checking if agents exist (Step 1 has a 'no agents found' fallback), enforcing max 5 agents with a narrowing prompt (Step 3), confirming selection before proceeding, handling agent failures inline (Step 4), and conditional synthesis logic (Step 5). Error recovery is addressed at each stage.

3 / 3

Progressive Disclosure

The content is well-organized with clear sections and headers, but it's a fairly long monolithic document (~150+ lines of content). The directory layout examples, configuration details, and the full discovery algorithm could potentially be split into referenced files. For a skill of this complexity, some content would benefit from being in supplementary files.

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

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents