CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

team-lead

Use this skill whenever delegating work to subagents — whether a single Task call or a full team via TeamCreate. Guides delegation, task decomposition, agent selection, and coordination. Covers when to spawn architect (design decisions, trade-offs), researcher (explorations, technical investigation), developer (FEATURE specs and code), tech-writer (documentation), qa (post-implementation validation), and architecture-critic (stress-testing architect output). Trigger on any subagent spawn, team creation, multi-agent coordination, or parallel work request.

71

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 highly actionable orchestration policy: exact tool-call syntax, literal delegation message templates, scenario-specific compositions, a sequenced spawn order with required QA and architect-review gates, and concrete error-recovery loops. Its main weakness is redundancy — the never-implement rule and its temptation scenarios are repeated across the Cardinal Rule, Delegation, and Error Recovery sections — plus a longish single-file layout with no offloaded references.

Suggestions

Merge the Cardinal Rule 'temptations' list with the Error Recovery section — they cover the same four scenarios (agent failure, file conflict, task status, cascading error) twice; keep one canonical list and reference it from the other section.

State the never-implement rule once (in The Cardinal Rule) and cut the repetitions of it in the Delegation opener ('not to implement') and Error Recovery opener ('you coordinate, you don't implement').

Deduplicate the slow-teammate guidance: 'Monitor, don't intervene' in Coordination and 'Slow teammate' in Error Recovery give the same advice; keep the fuller Error Recovery version and drop the duplicate bullet.

DimensionReasoningScore

Conciseness

Mostly efficient, imperative, and project-specific (no explaining of concepts Claude already knows), but the never-implement rule is stated three times — "The team lead NEVER implements", "not to implement" (Delegation opener), "you coordinate, you don't implement" (Error Recovery) — and the Cardinal Rule temptations list ("A file conflict needs resolution — don't touch the file", "An error cascades...") duplicates the Error Recovery section nearly bullet-for-bullet, as does "Monitor, don't intervene" vs "Slow teammate". More than minor trimming opportunity, but far from padded — fits the 3 anchor ('could be tightened') rather than 2 ('several padded sections').

3 / 5

Actionability

Concrete, executable guidance throughout: exact call syntax ("Task(subagent_type=<agent>, prompt=\"...\")", "Multiple `Task(..., run_in_background=true)` calls", "`TeamCreate` then `Task(..., team_name, name)`", "`addBlockedBy` dependencies", "Send `shutdown_request` to each teammate", "Call `TeamDelete`"), a copy-paste delegation message ("Implement the plugin system per the federation/plugin-system FEATURE. Reference architecture/ for context."), a worked good/bad task-description pair ("Verify all sitemap URLs return HTTP 200 and report any failures"), and a scenario-to-agents composition table. As an instruction-only skill, absence of code is not penalized; the guidance is directly executable and covers the common cases — matches the 5 anchor.

5 / 5

Workflow Clarity

Spawn order is a numbered 1-6 sequence with explicit entry/exit points ("A bug fix starts at step 3. A research question stops at step 1"), the Constructor Studio flow includes a review gate ("2. Team lead reviews and approves the design"), and validation is mandatory with feedback loops — "Once implementation is complete, invoke the `qa` agent... Route blockers back to the developer", "Once QA passes, have an architect review... Route findings back to the developer", plus error-recovery loops (cascade: "Stop the chain, route the fix to the agent who owns the source, then reassess downstream tasks") and a shutdown checklist. Matches the 5 anchor: explicit validation steps, error-recovery feedback loops, checklists.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the one external pointer — "Consult [architecture/DESIGN.md](../../../architecture/DESIGN.md)" — is clearly signaled at the top and one level deep. Sections are well organized with navigation-friendly tables (file ownership, subagent vs teammate, typical compositions). Not a 5: at ~180 lines, blocks like the six per-agent spawn criteria and the typical-compositions table are inline reference material that could be split out, and the 5 anchor ('content appropriately split') plus the under-50-lines exception don't apply; comfortably above the 3 anchor since nothing here is API-reference-style content that clearly belongs in a separate file.

4 / 5

Total

17

/

20

Passed

Description

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

A strong description: it explicitly states what the skill does (delegation, task decomposition, agent selection, coordination, per-agent spawn criteria) and when to trigger it, in natural user vocabulary with a distinct multi-agent niche. The only soft spot is that capability verbs sit at guidance altitude ('Guides', 'Covers') rather than fully concrete operations.

DimensionReasoningScore

Specificity

"Guides delegation, task decomposition, agent selection, and coordination" names four concrete capabilities, and "Covers when to spawn architect (design decisions, trade-offs), researcher (explorations, technical investigation), developer (FEATURE specs and code)..." enumerates per-agent coverage. Not a 3 ('1-2 concrete actions') since it lists several specific actions; not quite a 5 because the verbs are guidance-level ('Guides', 'Covers') and body-level capabilities like error recovery and shutdown are omitted — minor gaps in coverage.

4 / 5

Completeness

What: "Guides delegation, task decomposition, agent selection, and coordination" with enumerated per-agent coverage. When: "Use this skill whenever delegating work to subagents" and an explicit trigger clause — "Trigger on any subagent spawn, team creation, multi-agent coordination, or parallel work request." Both what and when are explicit with concrete trigger phrases; a missing 'Use when' clause would cap at 3, but two explicit trigger statements are present. Voice is third-person/declarative ('Guides', 'Covers', 'Trigger on').

5 / 5

Trigger Term Quality

Triggers read as natural user phrasing: "delegating work to subagents", "subagent spawn", "team creation", "multi-agent coordination", "parallel work request", plus tool names ("a single Task call", "TeamCreate") and all six role names. Synonym coverage (delegating/spawn/team/parallel/coordinate) is comprehensive for the domain, matching the anchor-5 pattern of including variations; no common phrasing a user would naturally say is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche — multi-agent delegation/orchestration — with triggers ("subagent spawn", "team creation", "multi-agent coordination") that are unlikely to fire for a non-delegation skill. The role names (architect, researcher) appear only as objects of spawn guidance, not as standalone triggers, so overlap risk with single-role skills is minimal; fits the anchor-5 'clear niche with distinct triggers' better than the 4 anchor's 'minor overlap risk'.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

constructorfabric/gears-frontx

Path

.claude/skills/team-lead/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.