This skill should be used when the user says "feature spec teams", "arness code feature spec teams", "team feature spec", "debate this feature", "collaborative feature spec", "spec with agent teams", "multi-agent feature spec", "feature spec debate", or wants to develop a feature idea through structured debate between multiple specialist agents (architects, UX experts, and security specialists) before writing the specification. Uses Claude Code's experimental Agent Teams feature. Requires Agent Teams to be enabled. For standard single-agent feature spec, use arn-code-feature-spec instead.
59
68%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-feature-spec-teams/SKILL.mdQuality
Discovery
89%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 is a strong description that excels at trigger term coverage and completeness, with explicit 'use when' guidance and clear disambiguation from a related skill. The main weakness is that the specific capabilities could be more concrete—listing what the specialist agents actually produce or what the output looks like would strengthen specificity. The description is functional and well-suited for skill selection among many options.
Suggestions
Add more concrete output descriptions, e.g., 'Produces a structured feature specification document after rounds of debate covering architecture trade-offs, UX considerations, and security concerns.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (feature spec development) and mentions some actions (structured debate between specialist agents, writing specifications), but doesn't list multiple concrete actions in detail—it's more about the process (debate between agents) than specific outputs or capabilities. | 2 / 3 |
Completeness | Clearly answers both 'what' (develops feature ideas through structured debate between specialist agents before writing the specification) and 'when' (explicit trigger phrases and use-case description). Also includes helpful disambiguation ('For standard single-agent feature spec, use arn-code-feature-spec instead'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of trigger terms with many natural variations explicitly listed: 'feature spec teams', 'debate this feature', 'collaborative feature spec', 'spec with agent teams', 'multi-agent feature spec', 'feature spec debate'. These are terms users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche (multi-agent team-based feature spec via debate). Explicitly differentiates itself from the single-agent alternative (arn-code-feature-spec), reducing conflict risk significantly. | 3 / 3 |
Total | 11 / 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 is a comprehensive and well-structured workflow with excellent error handling and clear sequencing, but it suffers significantly from verbosity. The skill inlines massive amounts of detail (spawn prompt contents, classification logic, greenfield context per-role) that should be extracted into reference files, making it far too long for efficient context window usage. The actionability is moderate — steps are clear but lack executable templates for the most critical operations (agent spawning).
Suggestions
Extract the teammate spawn prompt specifications (Step 4) into a reference file like `references/spawn-prompts.md` — this section alone accounts for ~40% of the document and is highly repetitive across roles.
Move the three-axis detection logic and team composition matrix (Step 3) into a reference file like `references/team-classification.md`, keeping only a brief summary in the main skill.
Consolidate the repeated greenfield context instructions (duplicated across architect, UX, and security sections) into a single shared context block with role-specific deltas.
Provide an actual executable spawn prompt template or code snippet rather than describing what each prompt should contain in prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~300+ lines with extensive conditional logic, detailed team composition matrices, and exhaustive spawn prompt specifications. Much of this content (e.g., explaining what each role does, repeating greenfield context loading instructions across every teammate) could be significantly condensed or moved to reference files. The inline detail about what to include in each teammate's prompt is particularly bloated. | 1 / 3 |
Actionability | The workflow provides concrete steps and specific commands (e.g., checking env variables, file paths, regex patterns), but much of the guidance is procedural description rather than executable code. The spawn prompt sections describe what to include but don't provide actual prompt templates. The team composition matrix and classification axes are well-structured but the actual agent spawning mechanics are left abstract. | 2 / 3 |
Workflow Clarity | The multi-step workflow is clearly sequenced with numbered steps, explicit validation checkpoints (checking Agent Teams availability, confirming team composition with user, convergence criteria), error recovery paths, and user escalation points. The debate loop has explicit convergence criteria (>4 rounds escalation, repeated disagreement detection). Error handling is comprehensive with fallback paths for every failure mode. | 3 / 3 |
Progressive Disclosure | The skill references external files appropriately (debate-protocol.md, greenfield-loading.md, feature-spec-template.md) but the SKILL.md itself is a monolithic wall of text that inlines enormous amounts of detail that should be in reference files — particularly the teammate spawn prompt specifications, the team composition matrix, and the three-axis detection logic. The greenfield context loading instructions are repeated for each teammate role rather than being centralized. | 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
b9084b6
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.