CtrlK
BlogDocsLog inGet started
Tessl Logo

modular-ds-spectrum-model

Use when: deciding how to structure a new Primer React component, evaluating whether an existing component's API is at the right level of abstraction, or orienting on the modular design system approach before using a more specific modular-ds-* skill. Covers how the four API types (config, presentational, base, utilities) relate and compose, and how to decide which ones a component needs. The model itself is defined in contributor-docs/style.md.

65

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/modular-ds-spectrum-model/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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.

The body is a well-structured, lean orientation skill that defers detail to style.md and sibling skills and gives concrete decision guidance with an illustrative example. Its main gap is workflow clarity: the decision process is coherent but lacks explicit checkpoints or a feedback loop.

Suggestions

Add an explicit decision checklist for 'which API types does this component need' (e.g., a short ordered set of questions ending in 'surface the narrower reversible option') so the workflow has clear checkpoints rather than a loose sequence.

Tighten or remove redundant framing sentences like 'This skill and its siblings carry the operational detail for applying that model, not a second definition of it' to push conciseness toward the lean anchor.

Clarify the feedback/validation step after surfacing a decision (e.g., what to do when the reviewer rejects the narrower option) to give the decision workflow an explicit recovery loop.

DimensionReasoningScore

Conciseness

The body is lean, assumes React/TSX competence, and explicitly avoids re-defining the model ('not a second definition of it'), but a few framing sentences ('This skill and its siblings carry the operational detail...') could be trimmed, so it is efficient with minor over-explanation rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Concrete decision rules ('Before adding custom behavior... look for an existing base component', 'keep the public API identical and surface the structural decisions', 'shipping the narrower, reversible option and asking') plus an illustrative TSX worked example give mostly executable guidance; it stops short of anchor 5 because the example is explicitly non-runnable in the repo.

4 / 5

Workflow Clarity

A loose sequence is present (orient via style.md -> understand the four types -> decide which are needed -> surface the decision) and the core rule (ship the narrower reversible option, ask) is clear, but there are no explicit validation checkpoints or feedback loops in the decision process, matching 'sequence present but checkpoints missing or implicit'.

3 / 5

Progressive Disclosure

It is a clean overview that pushes detail one level deep via clearly signaled references — 'contributor-docs/style.md is the source of truth', the listed sibling skills for 'detailed rules', and 'modular-ds-accessibility-contract' — with content appropriately split and easy to navigate; no bundle files exist to detract from this structure.

5 / 5

Total

16

/

20

Passed

Description

83%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.

The description is strong: third-person voice, explicit 'Use when:' triggers, and a clear what/when split tied to a concrete Primer niche. Its only weakness is mild overlap with the sibling modular-ds skills and a few missing natural trigger synonyms.

DimensionReasoningScore

Specificity

Lists several concrete use cases ('deciding how to structure a new Primer React component', 'evaluating whether an existing component's API is at the right level of abstraction', 'orienting on the modular design system approach') plus the four named API types, so it sits at 'several specific actions; minor gaps' rather than the fully comprehensive anchor 5.

4 / 5

Completeness

It explicitly answers both — 'Covers how the four API types... relate and compose' (what) and 'Use when: deciding how to structure... or orienting on the modular design system approach before using a more specific modular-ds-* skill' (when) with concrete trigger phrases, matching the anchor that requires both clearly and explicitly.

5 / 5

Trigger Term Quality

Natural Primer-contributor phrases like 'structure a new Primer React component', 'level of abstraction', and 'modular design system' appear with an explicit 'Use when:' clause, giving good keyword coverage, but a few common synonyms/variations a contributor might say are absent so it is not the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (Primer React, the spectrum-of-abstraction model) and explicitly positions itself 'before using a more specific modular-ds-* skill', but it inherently overlaps with the sibling modular-ds-config/presentational/base/utilities skills it references, leaving minor overlap risk rather than minimal.

4 / 5

Total

17

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
primer/react
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.