CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

atelier

Orchestrating design-to-implementation pipelines (code to visual to code closed loop), persisting a project design system across agents. Not for a single prototype (Forge) or direction only (Vision).

Quality

69%

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 ./atelier/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 densely specified orchestration contract with an exemplary phase workflow — explicit exit criteria, measurable validation gates, and genuine error-recovery loops. Its weaknesses are redundancy across the four routing sections with duplicated summary blocks, and heavy dependence on ~15 referenced bundle files that are not present, leaving phase detail and the handoff template inaccessible.

Suggestions

Consolidate the overlapping routing sections (Trigger Guidance, Delegate Matrix, Output Routing, Collaboration) into a single routing section, and remove the CAPABILITIES_SUMMARY/COLLABORATION_PATTERNS comment block that duplicates them.

Ship or inline the critical referenced files — at minimum `reference/autorun-schema.md` (ONBOARDING/EXECUTE phase detail) and `_templates/handoff-bundle.template.json` — so the deferred procedural content and JSON Schema validation gate are actually reachable.

State the duplicated output-language rule once (in Core Contract or Output Requirements) instead of verbatim in both places.

DimensionReasoningScore

Conciseness

The prose is telegraphic and assumes Claude's competence (no basic-concept explanations), but routing logic is restated across four sections (Trigger Guidance, Delegate Matrix, Recipes/Subcommand Dispatch, Output Routing), the language-output rule appears verbatim twice, and the CAPABILITIES_SUMMARY/COLLABORATION_PATTERNS comment block plus the Collaboration section duplicate each other nearly wholesale. This is 'mostly efficient but could be tightened' — not score 2 because every line carries orchestration rules, not padding, and not score 4 because the cross-section redundancy is more than minor.

3 / 5

Actionability

Guidance is concrete throughout: exact paths (`.agents/design-system/{project}.json`), measurable gates ("WCAG 2.2 AA", "4.5:1 text, 3:1 UI", "fidelity ≥ 95%", "cap fan-out at 5 concurrent delegates"), worked examples per operation layer, and a delegate matrix keyed by artifact shape. It is not score 5 because key executable specifics are deferred to files not present in the bundle (`reference/autorun-schema.md` for ONBOARDING/EXECUTE phase detail, `_templates/handoff-bundle.template.json` for bundle validation), leaving the actual handoff-bundle format unspecified. Per the rubric's scoring notes, absence of code in an instruction-only skill is not penalized when guidance is actionable, which holds here.

4 / 5

Workflow Clarity

The ONBOARDING → INTAKE → PLAN → EXECUTE → HANDOFF → DELIVER table gives each phase a goal, a key rule, and an explicit exit criterion, with validation gates baked in ("All bundles validate against `_templates/handoff-bundle.template.json` (JSON Schema)", "Validate WCAG 2.2 AA before DELIVER", "token-drift = 0, pixel fidelity ≥ 95%") and error-recovery loops (Ask First on ambiguity/oversized fan-out, escalation to Nexus, drift-triggered re-extraction). Batch fan-out operations do have validation, so the batch-operation cap does not apply. This matches the anchor for a clear sequence with explicit validation steps and feedback loops.

5 / 5

Progressive Disclosure

The Reference Map is well-organized (file + "read this when" column, one level deep) and the body consistently defers detail to named files, but the bundle ships none of them — no `references/`, `scripts/`, or `assets/` directories exist, so the ~15 referenced paths (`_common/HANDOFF.md`, `_common/design-system-registry.md`, `reference/autorun-schema.md`, `_templates/handoff-bundle.template.json`, etc.) are unverifiable or dangling, and the skill's structure cannot actually function as written. This sits between 'references present but not clearly signaled' (they are clearly signaled) and 'good structure, references mostly clear' (they cannot be confirmed to exist), so 3 is the best fit.

3 / 5

Total

15

/

20

Passed

Description

53%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 carves a clear niche with an explicit negative boundary against the two closest sibling skills, but it omits any positive 'use when' trigger guidance and leans on orchestration jargon ('closed loop', 'pipelines') rather than natural user phrases. What it does is stated concretely, though not comprehensively.

Suggestions

Add an affirmative trigger clause, e.g. "Use when the user wants a design-to-implementation pass in one request: Figma to code, codebase tokens to prototype, or a design-system-aligned bundle (deck + marketing assets + landing page)."

Include natural trigger keywords users would actually say — "Figma to code", "design tokens", "landing page", "brand-aligned deck" — alongside the existing jargon.

Briefly enumerate the concrete orchestrated actions (extract design system, generate prototypes/assets, implement production code) to lift specificity from domain-level to action-level.

DimensionReasoningScore

Specificity

Phrases like "persisting a project design system across agents" and "code to visual to code closed loop" name the domain plus 1-2 concrete actions, but the description stops short of listing the concrete capabilities it orchestrates (token extraction, prototyping, production implementation, asset generation). It matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor; it is above score 2 because the closed-loop mechanism and persistence are specific, but below score 4 because no multi-action inventory is given.

3 / 5

Completeness

The "what" is clear (orchestrate design-to-implementation pipelines, persist the design system), but there is no "Use when..." clause or equivalent positive trigger guidance — only the negative "Not for a single prototype (Forge) or direction only (Vision)". Per the judging guidelines, a missing explicit trigger clause caps completeness at 3: the 'when' is only weakly implied via exclusion. Not score 4 because an affirmative when-to-use statement is entirely absent, and not score 2 because the negative boundary does implicitly constrain usage.

3 / 5

Trigger Term Quality

Relevant keywords like "design-to-implementation", "design system", and "prototype" appear, but natural user phrasings such as "Figma to code", "landing page", "design tokens", or "extract tokens" are missing, and jargon like "closed loop" dominates. This fits 'some relevant keywords but missing common variations or synonyms'; it is not score 4 because the everyday phrasings a user would actually say are largely absent, yet not score 2 since several genuinely relevant terms are present.

3 / 5

Distinctiveness Conflict Risk

The explicit exclusion "Not for a single prototype (Forge) or direction only (Vision)" carves a clear niche (pipeline orchestration between direction and single-artifact work), which is mostly distinct. It falls short of score 5's 'distinct triggers; minimal conflict risk' because the description names only two of the many adjacent siblings (Frame, Artisan, Muse go unmentioned) and its trigger terms (design, implementation, prototype) are broad enough to invite overlap with those unmentioned neighbors.

4 / 5

Total

13

/

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

simota/agent-skills

Path

atelier/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.