Unified team skill for brainstorming team. Uses team-worker agent architecture with role directories for domain logic. Coordinator orchestrates pipeline, workers are team-worker agents. Triggers on "team brainstorm".
51
40%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.codex/skills/team-brainstorm/SKILL.mdQuality
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 focuses almost entirely on internal implementation architecture (team-worker agents, role directories, coordinator pipelines) rather than describing user-facing capabilities or use cases. It fails to explain what kind of brainstorming it supports, what outputs it produces, or when it should be selected beyond the narrow trigger phrase 'team brainstorm'. A user reading this would have no idea what value this skill provides.
Suggestions
Replace architectural jargon with concrete user-facing actions, e.g., 'Generates diverse ideas on a topic by simulating multiple expert perspectives, producing structured brainstorm outputs with categorized suggestions and action items.'
Add a clear 'Use when...' clause with natural trigger terms users would actually say, such as 'brainstorm ideas', 'generate ideas', 'ideation session', 'creative thinking', 'explore options', 'group brainstorm'.
Remove implementation details (team-worker agent architecture, role directories, pipeline orchestration) as these do not help Claude decide when to select this skill and add noise to the selection process.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague, architectural language like 'team-worker agent architecture', 'role directories for domain logic', and 'Coordinator orchestrates pipeline' without describing any concrete user-facing actions or capabilities. It describes implementation details rather than what the skill actually does for the user. | 1 / 3 |
Completeness | The 'what' is extremely weak — it says 'brainstorming team' but never explains what kind of brainstorming, what outputs are produced, or what problems it solves. The 'when' is limited to 'Triggers on team brainstorm' which is minimal and not framed as explicit guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | The only trigger term is 'team brainstorm', which is narrow and unlikely to match natural user language. Terms like 'team-worker agent architecture', 'role directories', and 'pipeline' are internal jargon, not natural user keywords. Users seeking brainstorming help would say things like 'brainstorm ideas', 'generate ideas', 'ideation', etc. | 1 / 3 |
Distinctiveness Conflict Risk | The mention of 'team brainstorm' and the specific architectural pattern (team-worker agents) gives it some distinctiveness, but the core domain — brainstorming — is generic enough to overlap with any ideation or creative thinking skill. The architectural details don't help Claude distinguish when to use this vs other brainstorming tools. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
72%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-structured orchestration skill with strong actionability through concrete spawn templates and clear delegation rules. Progressive disclosure is excellent with role files properly referenced. The main weaknesses are some redundancy in spawn templates and a lack of explicit validation checkpoints between pipeline phases, which is important for a multi-step orchestration workflow.
Suggestions
Add explicit validation/checkpoint steps between pipeline phases (e.g., 'After ideator outputs collected, verify at least N ideas exist before spawning challenger') to improve workflow clarity.
Consolidate the duplicate parallel ideator spawn template—reference the base Worker Spawn Template and note only the differences for parallel spawning to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly detailed and includes useful specifics, but there's some redundancy—the parallel ideator spawn template is essentially repeated twice with minor variations, and the v4 Agent Coordination section partially restates information already covered in the Worker Spawn Template section. Some sections like the ASCII architecture diagram add clarity but could be more compact. | 2 / 3 |
Actionability | The skill provides concrete spawn_agent templates with exact parameter structures, a clear delegation lock table with allowed/blocked tool calls, specific session directory layouts, and executable coordination patterns (wait_agent, close_agent, list_agents). The guidance is copy-paste ready for orchestration tasks. | 3 / 3 |
Workflow Clarity | The overall pipeline flow (generate -> challenge -> synthesize -> evaluate) is stated and the architecture diagram shows the dispatch pattern, but there are no explicit validation checkpoints between pipeline phases. The error handling table exists but lacks feedback loops—e.g., no explicit 'if worker fails, retry or escalate' sequence. The Generator-Critic loop mention (max 2 rounds) hints at iteration but isn't fully sequenced. | 2 / 3 |
Progressive Disclosure | The skill acts as a clear router/overview, with well-signaled one-level-deep references to role files (roles/coordinator/role.md, roles/ideator/role.md, etc.) and specs (specs/pipelines.md). The Role Registry table provides a clean navigation index, and domain logic is appropriately delegated to role-specific files rather than inlined. | 3 / 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
0f8e801
Table of Contents
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.