CtrlK
BlogDocsLog inGet started
Tessl Logo

coss

Helps implement coss UI components correctly. Use when building UIs with coss primitives (buttons, dialogs, selects, forms, menus, tabs, inputs, toasts, etc.), migrating from shadcn/Radix to coss/Base UI, composing trigger-based overlays, or troubleshooting coss component behavior. Covers imports, accessibility, Tailwind styling, and common pitfalls.

69

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured navigator skill: concise, correctly assumes Claude's competence, and built around a verified flat reference bundle with a registry index for discovery. The main gaps are minor — a small amount of section redundancy, a high-level manual-install pattern with no inline code example, and no error-recovery loop in the workflow.

Suggestions

Merge 'Component discovery' and 'Primitive Guidance' into one section — both currently restate that every primitive has a guide at references/primitives/<name>.md — and fold the overlapping accessibility/composition items from 'Critical usage rules' into the 'Output Checklist'.

Make the manual-install pattern concrete: show the exact dependency-install command (e.g., the npm/pnpm/bun variants) and name the registry source file the component is copied from, mirroring the specificity of the CLI pattern.

Add one inline minimal usage snippet (e.g., a documented Dialog import and trigger/content composition) so the body demonstrates the documented pattern it tells the agent to follow before deferring to primitive guides.

DimensionReasoningScore

Conciseness

The body is lean — imperative bullets, no explanation of concepts Claude already knows (React, Tailwind, what a component library is), and a tight ~100 lines. It is not a 5 because there is minor redundancy: 'Component discovery' and 'Primitive Guidance' both restate that every primitive has a guide at `references/primitives/<name>.md`, and 'Critical usage rules' and 'Output Checklist' overlap on accessibility and composition invariants.

4 / 5

Actionability

Concrete, executable guidance dominates: a copy-paste CLI command (`npx shadcn@latest add @coss/<component>`), exact file paths (`apps/ui/registry/default/particles/p-<name>-<N>.tsx`), and per-topic rule files named with one-line descriptions. It falls short of fully executable (5) because the manual-install pattern stays high-level ('install dependencies listed in the component docs page... copy required component file(s)') and the body includes no minimal inline usage snippet, leaving a small gap before the reader reaches a reference file.

4 / 5

Workflow Clarity

The 'Usage workflow' is a clear 6-step sequence (intent → registry lookup → select → check a particle example → write → self-check) with a validation checkpoint in step 6 and an explicit pre-return 'Output Checklist'. It is not a 5 because there is no error-recovery feedback loop — e.g., what to do when a step fails or docs and code disagree — only the forward-looking 'verify against component docs first' rule; the destructive/batch cap does not apply since this skill produces code rather than performing batch operations.

4 / 5

Progressive Disclosure

The body is a genuine overview that defers all detail to well-signaled, one-level-deep references, and every referenced file exists in the bundle: 4 rule files under references/rules/, portal-props.md, cli.md, component-registry.md, and all 53 primitive guides claimed (including the 6 named high-risk ones); component-registry.md serves as a flat index into the primitive guides, so navigation is easy and nothing is nested two-plus levels deep.

5 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

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

A strong description: third-person voice, concrete capability list, and an explicit multi-scenario 'Use when' clause covering build, migrate, compose, and troubleshoot cases. The only weakness is that a few natural component synonyms (modal, dropdown, popover) are folded into the abstract phrase 'trigger-based overlays' rather than named.

DimensionReasoningScore

Specificity

Multiple concrete actions are enumerated — 'implement coss UI components', 'migrating from shadcn/Radix to coss/Base UI', 'composing trigger-based overlays', 'troubleshooting coss component behavior' — plus concrete coverage areas ('imports, accessibility, Tailwind styling, and common pitfalls'). This matches the anchor for multiple specific concrete actions with comprehensive coverage of the domain; it is not score 4 because no meaningful capability area of the skill is left unlisted.

5 / 5

Completeness

Both questions are explicitly answered: what ('Helps implement coss UI components correctly... Covers imports, accessibility, Tailwind styling, and common pitfalls') and when ('Use when building UIs with coss primitives..., migrating..., composing trigger-based overlays, or troubleshooting coss component behavior'). The 'when' clause lists four concrete trigger scenarios, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'buttons, dialogs, selects, forms, menus, tabs, inputs, toasts', 'migrating from shadcn/Radix', 'Tailwind styling' are phrases users would naturally say. It falls short of the comprehensive anchor (5) because common synonyms users plausibly say — 'modal', 'dropdown', 'popover', 'tooltip', 'combobox' — are absent (only covered abstractly as 'trigger-based overlays').

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a named niche library ('coss', 'coss/Base UI') with migration direction explicitly stated ('from shadcn/Radix to coss/Base UI'), giving it a clear niche with distinct triggers and minimal conflict risk. The only conceivable overlap — a user merely working in shadcn — is disambiguated by the explicit migration direction.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
MapleTechLabs/maple
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.