CtrlK
BlogDocsLog inGet started
Tessl Logo

team-frontend

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

Quality

32%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/team-frontend/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

10

/

11

Passed

Repository
catlog22/Claude-Code-Workflow
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.