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

Advisory

Suggest reviewing before use

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 documentation or architectural notes rather than a skill description meant to help Claude select the right skill. It is filled with jargon ('Pure router', 'Beat model', 'coordinator-only in monitor.md') that provides no actionable information about what the skill does or when to use it. It fails to describe concrete capabilities and lacks natural trigger terms a user would employ.

Suggestions

Replace jargon with concrete actions the skill performs, e.g., 'Builds React components, styles pages with CSS/Tailwind, implements responsive layouts, and creates interactive UI elements.'

Add a clear 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about frontend development, React components, CSS styling, UI design, web layouts, or building user interfaces.'

Remove internal architectural details ('Pure router', 'Beat model', 'monitor.md') that are meaningless for skill selection and replace with user-facing capability descriptions.

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 'build components', 'style pages', or 'create layouts' are mentioned.

1 / 3

Completeness

The 'what' is extremely vague — 'frontend development' is mentioned but no specific actions are described. The 'when' is limited to 'Triggers on team frontend' which is a narrow and unnatural trigger phrase, not a meaningful 'Use when...' clause with explicit guidance.

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', 'HTML', 'UI', 'component', 'web page', etc.

1 / 3

Distinctiveness Conflict Risk

The phrase 'team frontend' as a trigger is distinctive enough to avoid accidental conflicts, but the broader mention of 'frontend development' and 'ui-ux' could overlap with other design or frontend skills. The internal jargon paradoxically helps avoid conflicts since it's unlikely to match normal queries.

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-organized routing/architecture skill that effectively serves as an entry point for a multi-role frontend team workflow. Its strengths are clear progressive disclosure and a well-defined role registry with direct links. Its weaknesses are moderate verbosity in the spawn template and architecture diagram, and limited validation/feedback loops in the main workflow sequence — most actionable content is deferred to role-specific files that aren't provided for evaluation.

Suggestions

Add explicit validation checkpoints in the main coordinator workflow (e.g., 'after all workers complete → coordinator validates outputs → if QA fails → re-dispatch'), rather than burying QA thresholds only in the error handling table.

Compress the Worker Spawn Template — consider showing just the key fields and noting that the full template is in a referenced file, since the current inline version is verbose for a router document.

DimensionReasoningScore

Conciseness

The content is reasonably structured and avoids explaining basic concepts, but includes some verbose sections like the full ASCII architecture diagram and the worker spawn template that could be more compact. The session directory tree and multiple tables add bulk but are mostly justified.

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 actionability is deferred to role.md files and specs that aren't provided, and there's no executable code beyond the spawn template — the skill is more of a routing/architecture document than a hands-on guide.

2 / 3

Workflow Clarity

The architecture diagram and role registry clearly show the flow from coordinator to workers, and the spawn template includes progress milestones. However, validation checkpoints are weak — the QA score threshold is mentioned in error handling but there's no explicit feedback loop for the main workflow (e.g., what happens between worker completion and final delivery). The error handling table helps but lacks sequenced recovery steps.

2 / 3

Progressive Disclosure

The skill is well-structured as a router/overview that clearly points to one-level-deep role specs (roles/<name>/role.md) and pipeline specs. The role registry table provides clear navigation with direct links. Content is appropriately split between this overview and the referenced role 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.