Unified team skill for frontend development. Pure router — all roles read this file. Beat model is coordinator-only in monitor.md. Built-in ui-ux-pro-max design intelligence. Triggers on "team frontend".
45
32%
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 ./.claude/skills/team-frontend/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 reads like internal implementation notes rather than a skill description meant to help Claude select the right skill. It lacks concrete actions, natural user-facing trigger terms, and clear guidance on when to use it. The heavy use of internal jargon ('pure router', 'beat model', 'ui-ux-pro-max design intelligence') provides no useful information about what the skill actually does.
Suggestions
Replace internal jargon with concrete actions the skill performs, e.g., 'Builds React components, implements responsive layouts, styles UI elements with CSS/Tailwind'.
Add a clear 'Use when...' clause with natural trigger terms users would say, e.g., 'Use when the user asks about frontend development, React components, CSS styling, responsive design, or UI implementation'.
Remove implementation details like 'pure router', 'beat model', 'coordinator-only in monitor.md' that describe internal architecture rather than user-facing capabilities.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague, jargon-heavy language like 'pure router', 'beat model', 'built-in ui-ux-pro-max design intelligence' without listing any concrete actions the skill performs. No specific capabilities like 'creates components', 'styles layouts', or 'builds pages' are mentioned. | 1 / 3 |
Completeness | The 'what' is essentially missing — it says it's for 'frontend development' but doesn't describe what it actually does. The 'when' is weakly addressed with 'Triggers on team frontend' but this is not a meaningful use-case trigger. Neither question is adequately answered. | 1 / 3 |
Trigger Term Quality | The only trigger term mentioned is 'team frontend', which is not a natural phrase a user would say. Terms like 'pure router', 'beat model', 'coordinator-only', and 'monitor.md' are internal jargon, not user-facing keywords. Missing natural terms like 'React', 'CSS', 'UI', 'web page', 'component', etc. | 1 / 3 |
Distinctiveness Conflict Risk | The phrase 'team frontend' and the specific internal references (monitor.md, coordinator-only) make it somewhat distinctive from generic skills, but 'frontend development' is broad enough to overlap with any other frontend-related skill. The internal jargon helps avoid accidental triggering but doesn't clearly carve out a niche. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
57%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 routing document for a multi-agent frontend development skill. Its greatest strength is progressive disclosure — it cleanly separates the router overview from role-specific details. Its main weaknesses are the lack of explicit validation checkpoints in the orchestration workflow and some verbosity in sections like the session directory tree and spawn template that could potentially live in referenced files.
Suggestions
Add explicit validation checkpoints to the coordinator workflow (e.g., 'verify task-analysis.json is valid before spawning workers', 'confirm all workers acknowledged before STOP')
Consider moving the detailed session directory structure and worker spawn template to a referenced specs file to keep the router leaner
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient for a routing/architecture document, but includes some information that could be trimmed — e.g., the full session directory tree and the worker spawn template are quite verbose for a router file that should primarily point to role specs. The architecture ASCII diagram is helpful but borderline. | 2 / 3 |
Actionability | The role router logic is concrete ('Has --role <name> → Read roles/<name>/role.md'), the spawn template is copy-paste ready, and CLI tools are named. However, much of the content is structural/architectural description rather than executable guidance — there are no concrete code examples for actual frontend development tasks, and the router logic itself is minimal. | 2 / 3 |
Workflow Clarity | The architecture diagram shows the flow from coordinator to workers, and the role registry provides clear paths. However, the multi-step workflow (analyze → dispatch → spawn → execute) lacks explicit validation checkpoints. The error handling table helps but there's no feedback loop for the coordinator's orchestration steps — e.g., no 'verify workers started successfully before proceeding' step. | 2 / 3 |
Progressive Disclosure | Excellent progressive disclosure: SKILL.md serves as a clean router/overview, with each role clearly linked to its own role.md file one level deep. The specs reference and role registry table provide well-signaled navigation. Content is appropriately split between this overview and the referenced files. | 3 / 3 |
Total | 9 / 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.