CtrlK
BlogDocsLog inGet started
Tessl Logo

team-uidesign

Unified team skill for UI design team. Research -> design tokens -> audit -> implementation. Uses team-worker agent architecture with roles/ for domain logic. Coordinator orchestrates dual-track pipeline with GC loops and sync points. Triggers on "team ui design", "ui design team".

49

Quality

53%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

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

Quality

Discovery

35%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description focuses heavily on internal architecture details (agent architecture, GC loops, sync points, coordinator, dual-track pipeline) rather than user-facing capabilities. The trigger terms are unnatural command-like phrases that users would rarely say organically. While it identifies a domain (UI design), it fails to describe concrete outcomes or include the natural language terms users would actually use when needing this skill.

Suggestions

Replace implementation jargon ('GC loops', 'sync points', 'team-worker agent architecture') with concrete user-facing capabilities like 'creates design tokens', 'audits UI components for consistency', 'generates implementation specs from designs'.

Expand trigger terms to include natural phrases users would say, such as 'design system', 'UI components', 'design tokens', 'style guide', 'accessibility audit', 'component library', 'visual consistency'.

Rewrite the 'Use when' clause to describe user scenarios, e.g., 'Use when the user needs to create or audit a design system, generate design tokens, or bridge the gap between UI design and implementation.'

DimensionReasoningScore

Specificity

It names a domain (UI design) and mentions some actions (research, design tokens, audit, implementation), but these are listed as a pipeline rather than concrete user-facing capabilities. Terms like 'GC loops', 'sync points', and 'team-worker agent architecture' are internal implementation details, not specific actions.

2 / 3

Completeness

It partially answers 'what' (research, design tokens, audit, implementation pipeline) and has a 'Triggers on' clause, but the trigger terms are so narrow and unnatural that the 'when' guidance is effectively weak. The explicit trigger clause prevents capping at 1, but the triggers themselves are poor.

2 / 3

Trigger Term Quality

The explicit triggers are 'team ui design' and 'ui design team', which are unnatural phrases users would rarely say. Natural terms like 'design system', 'UI components', 'style guide', 'color tokens', or 'accessibility audit' are absent. The listed triggers feel like command keywords rather than natural language.

1 / 3

Distinctiveness Conflict Risk

The description is somewhat specific to UI design team workflows with its mention of design tokens and dual-track pipelines, but terms like 'research', 'audit', and 'implementation' are generic enough to overlap with many other skills. The narrow trigger phrases help reduce false positives but at the cost of missing true positives.

2 / 3

Total

7

/

12

Passed

Implementation

72%

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 orchestration skill that effectively uses progressive disclosure to manage complexity across a multi-agent team architecture. Its strongest aspects are actionability (concrete spawn templates, CLI commands, directory structures) and progressive disclosure (clean separation of concerns across role files and spec references). The main weakness is workflow clarity — while the high-level pipeline is described, the actual sequencing, sync points between workers, and validation checkpoints for the dual-track pipeline are insufficiently detailed in this file.

Suggestions

Add explicit sequencing for the pipeline stages (e.g., 'researcher completes → designer starts; designer completes → reviewer starts') with sync point definitions and what triggers each transition.

Include validation checkpoints in the workflow — e.g., what the coordinator checks before advancing from research to design, or what constitutes a passing audit review before implementation begins.

DimensionReasoningScore

Conciseness

The content is reasonably efficient and avoids explaining basic concepts, but includes some structural overhead that could be tightened — the ASCII architecture diagram, while helpful, is verbose, and some tables (like error handling) contain generic entries that don't add much value. The worker spawn template is appropriately detailed since it's a non-obvious pattern.

2 / 3

Actionability

The skill provides concrete, executable guidance: the role router logic is explicit, the worker spawn template is copy-paste ready with clear placeholders, CLI tools are specified with exact flags, message bus calls include parameter names, and the session directory structure is fully specified. The role registry table with paths and prefixes is immediately actionable.

3 / 3

Workflow Clarity

The architecture diagram shows the overall flow (coordinator → analyze → dispatch → spawn workers → STOP), and the worker spawn template includes progress milestones (context loaded → core work done → verification). However, the multi-step pipeline (research → design tokens → review → implementation) lacks explicit sequencing details, sync points between workers, and validation checkpoints. The GC loop mechanism is mentioned (max 2 rounds) but not clearly sequenced. Error handling exists but is generic.

2 / 3

Progressive Disclosure

Excellent progressive disclosure structure: SKILL.md serves as a clear router/overview, with role-specific logic delegated to `roles/<role>/role.md` files (one level deep, clearly linked), and detailed specs split into well-organized reference files (pipelines, design-standards, anti-patterns, scoring-guide, ux-writing). Navigation is clear via the Role Registry table and Specs Reference section.

3 / 3

Total

10

/

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.