CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ui

Use this skill when contributing to InsForge's reusable UI package. This is for maintainers editing design-system primitives, exports, styles, and package-level component behavior in the InsForge monorepo.

Quality

86%

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

92%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 tight, well-organized repo policy skill: all content is non-inferable project knowledge, validation commands are explicit with conditional checkpoints, and structure is clean for its length. The only room for improvement is inlining a minimal example of the Radix-wrapper/typed-export patterns instead of deferring entirely to existing code.

DimensionReasoningScore

Conciseness

Every line carries project-specific rules Claude could not infer: placement boundaries, tooling conventions ("class-variance-authority", "cn()"), the typing rule, and downstream-consumption caveats. There is no explanation of concepts Claude already knows — a clean match for 'Lean and efficient; assumes Claude's competence; every token earns its place'.

5 / 5

Actionability

Concrete, executable guidance throughout: exact paths ("packages/ui/src/index.ts", "styles.css"), copy-paste validation commands ("cd packages/ui && npm run build"), and a three-way placement decision rule. It stops short of level 5 because some instruction is deferred to the repo itself ("Follow the existing Radix-wrapper and typed-export patterns") and 'when appropriate' hedges the cva rule — minor gaps the level-4 anchor describes.

4 / 5

Workflow Clarity

This is a simple, single-purpose rules skill, so the simple-skill exception applies: the action is unambiguous (edit within scope, respect the rules, then validate), and the Validation section gives explicit commands with conditional escalation checkpoints ("Also validate packages/dashboard/ when the changed component is used in the dashboard"). No destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

The body is 43 lines with no external references needed and no bundle files exist, so per the rubric's guideline for short skills, well-organized sections alone qualify: Scope, Working Rules, and Validation are cleanly separated and each is scannable.

5 / 5

Total

19

/

20

Passed

Description

73%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 well-scoped, repo-specific description that answers both what and when without padding. Its main weaknesses are generic action verbs and a single trigger clause with no natural-term variations.

Suggestions

Replace the generic verbs 'contributing' and 'editing' with concrete actions, e.g., 'Add, export, and type reusable design-system components and styles in InsForge's packages/ui.'

Broaden the trigger with natural variations users would actually say, e.g., '...when the user mentions the design system, shared UI components, or packages/ui in the InsForge monorepo.'

Optionally name the concrete artifacts touched (component variants via class-variance-authority, the public export surface in src/index.ts, styles.css) to lift specificity.

DimensionReasoningScore

Specificity

The domain is clearly named ("InsForge's reusable UI package") and it lists concrete objects of work ("design-system primitives, exports, styles, and package-level component behavior"), but the action verbs stay generic — "contributing" and "editing" — without naming what is actually done (e.g., adding components, exporting them, maintaining variants). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' and is below level 4, which expects several specific actions.

3 / 5

Completeness

Both halves are present: what ("editing design-system primitives, exports, styles, and package-level component behavior") and an explicit when ("Use this skill when contributing to InsForge's reusable UI package"). It is not level 5 because the 'when' clause is a single trigger with no concrete trigger-phrase variations (e.g., 'when the user mentions the design system or packages/ui').

4 / 5

Trigger Term Quality

Good natural-term coverage for the niche: "UI package", "design-system primitives", "exports", "styles", "monorepo", "maintainers" — phrases a contributor would plausibly say. It falls short of level 5 because common variations like "design system", "shared components", or the literal path "packages/ui" are absent.

4 / 5

Distinctiveness Conflict Risk

It is tightly scoped to one named repository's UI package ("in the InsForge monorepo", "for maintainers"), giving it a clear niche with distinct triggers and minimal risk of firing for unrelated skills — a clean match for level 5.

5 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

InsForge/InsForge

Path

.agents/skills/insforge-dev/ui/SKILL.md

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.