Meta-skill for generating team skills following the v4 architecture pattern. Produces complete skill packages with SKILL.md router, coordinator, worker roles, specs, and templates. Triggers on "team-designer", "design team".
58
67%
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 ./.claude/skills/team-designer/SKILL.mdQuality
Discovery
85%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 well-crafted description that clearly communicates what the skill produces (complete skill packages with specific components) and when to use it (explicit trigger terms). Its main weakness is that the trigger terms are somewhat narrow and technical, potentially missing natural language variations a user might employ. The description is concise, uses third person voice correctly, and carves out a very distinct niche.
Suggestions
Broaden trigger terms to include natural language variations like 'create a team skill', 'multi-agent skill', 'build a skill with multiple roles', or 'scaffold a team architecture'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'generating team skills', 'produces complete skill packages with SKILL.md router, coordinator, worker roles, specs, and templates'. These are concrete deliverables and actions. | 3 / 3 |
Completeness | Clearly answers both what ('generates team skills following v4 architecture pattern, produces complete skill packages with SKILL.md router, coordinator, worker roles, specs, and templates') and when ('Triggers on team-designer, design team'), providing explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes 'team-designer' and 'design team' as explicit triggers, plus domain terms like 'v4 architecture pattern', 'skill packages', 'router', 'coordinator', 'worker roles'. However, the trigger terms are narrow and somewhat technical—users might say 'create a team skill' or 'build a multi-agent skill' which aren't covered. | 2 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche—'meta-skill for generating team skills following the v4 architecture pattern' is very specific and unlikely to conflict with other skills. The combination of 'team-designer', 'v4 architecture', and the specific deliverables creates a clear, unique identity. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a well-structured overview of a team skill generation workflow with clear architectural patterns and a sensible four-phase approach. Its main weaknesses are redundancy (the same flow described three different ways), lack of concrete executable generation logic in the router itself, and missing intermediate validation checkpoints between phases. The progressive disclosure strategy is sound but undermined by the absence of the referenced phase documents.
Suggestions
Consolidate the three flow representations (Architecture Overview, Execution Flow, Data Flow) into a single clear section to reduce token waste by ~40%.
Add intermediate validation checkpoints between phases (e.g., 'After Phase 2, verify SKILL.md was created and directory structure matches expected layout before proceeding to Phase 3').
Include at least one concrete, executable example of file generation (e.g., a minimal SKILL.md router template or a role.md YAML frontmatter example) so the skill is actionable even without the phase documents.
Provide the referenced phase documents (phases/01-04) as bundle files, or embed minimal fallback logic inline so the skill remains functional if phase files are missing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content has significant redundancy — the execution flow is described three times (architecture overview diagram, execution flow section, and data flow section) with overlapping information. The ASCII diagrams, while visually appealing, consume many tokens for information that could be stated once. However, it avoids explaining basic concepts Claude already knows. | 2 / 3 |
Actionability | The skill provides structural guidance (directory layouts, naming conventions, phase references) but lacks executable code or concrete commands for actually generating files. The input processing section shows a template format but no actual generation logic — the real actionable content is deferred to phase documents that aren't provided in the bundle. | 2 / 3 |
Workflow Clarity | The four-phase workflow is clearly sequenced with auto-continue rules and progressive loading instructions. However, validation is only mentioned as Phase 4 at the end rather than having intermediate checkpoints between phases. For a generative/destructive operation (creating multiple files), the lack of validate-after-each-phase feedback loops is a gap. The 'Core Rules' section helps but doesn't define what to do if a phase fails mid-stream. | 2 / 3 |
Progressive Disclosure | The skill correctly references four phase documents via a clear table with links, and states 'read on-demand when phase executes' — good progressive disclosure intent. However, no bundle files are provided, so the referenced phase documents don't actually exist, making the references unverifiable. Additionally, the SKILL.md itself contains redundant content (three representations of the same flow) that could have been trimmed given the phase-document delegation strategy. | 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 |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
5ff5e86
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.