CtrlK
BlogDocsLog inGet started
Tessl Logo

terracotta

A sun-baked, clay-toned editorial interface built on warm cream surfaces, ink-brown headlines set in a display serif, and a single terracotta accent.

48

Quality

51%

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

Quality

Content

85%

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 tight, well-structured guideline-authoring skill with real token values, explicit required component states, and a clearly sequenced workflow with validation-oriented quality gates. Its only weakness is actionability: it gives strong instruction but no worked, copy-paste-ready example artifact.

DimensionReasoningScore

Conciseness

The body is a lean, well-organized set of short bullet lists and short numbered steps with no padding or explanation of concepts Claude already knows; every section earns its place (e.g., 'WCAG 2.2 AA, keyboard-first interactions, visible focus states').

3 / 3

Actionability

It provides concrete, specific guidance — real token values ('primary=#C56A3C'), a typographic scale, explicit required states ('default, hover, focus-visible, active, disabled, loading, error'), and concrete do/don't rules — but it is an instruction/guideline-authoring skill with no executable code or copy-paste examples, and the 'Example Constraint Language' section gives format rules rather than a worked example, so it stops short of fully copy-paste-ready artifacts.

2 / 3

Workflow Clarity

The 'Guideline Authoring Workflow' is a clear, sequenced 6-step process and the 'Required Output Structure' gives a concrete checklist-style deliverable shape; quality gates and acceptance criteria ('No rule should depend on ambiguous adjectives alone') act as explicit validation checkpoints, and per the scoring notes a guidance skill of this clarity merits a 3.

3 / 3

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist and none are referenced, and at under 50 lines with well-organized sections (Mission, Brand, Foundations, Accessibility, Rules, Workflow, Output Structure, Quality Gates), the body functions as a clean single-level overview; per the simple-skills scoring note this earns a 3.

3 / 3

Total

11

/

12

Passed

Description

17%

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 reads as evocative brand copy rather than a functional skill trigger: it characterizes an aesthetic but states no concrete actions and omits any 'Use when...' guidance. It is unlikely to be surfaced when a user needs it.

Suggestions

Add an explicit 'Use when...' clause naming natural trigger terms (e.g., 'Use when authoring or applying the Terracotta design system, building editorial or long-form reading UI, or applying brand color and typography tokens').

Replace aesthetic adjectives with concrete capabilities the skill performs (e.g., 'Authors design-system guidelines, defines color and typography tokens, and specifies component anatomy, states, and accessibility rules').

Switch to third-person action verbs (the current phrasing is descriptive, not action-stated), and include keywords users would naturally say such as 'design system', 'brand colors', 'editorial layout', and 'typography tokens'.

DimensionReasoningScore

Specificity

The description states the domain ('editorial interface') and several concrete visual elements ('warm cream surfaces', 'ink-brown headlines', 'display serif', 'terracotta accent'), but these are descriptive attributes of an aesthetic rather than concrete actions a skill performs, so it does not reach the 'lists multiple specific concrete actions' bar.

2 / 3

Completeness

It conveys a 'what' only indirectly (an aesthetic description), and entirely lacks any 'Use when...' clause or equivalent explicit trigger guidance, so per the judging guidelines completeness is capped at 2 and here sits at 1 because even the 'what' is an adjective-rich characterization rather than a stated capability.

1 / 3

Trigger Term Quality

It contains no natural trigger phrases a user would say when needing this skill (e.g., 'design system', 'editorial UI', 'brand colors'); instead it relies on evocative descriptive prose ('sun-baked, clay-toned editorial interface') that reads as marketing copy rather than searchable keywords.

1 / 3

Distinctiveness Conflict Risk

The terracotta/editorial aesthetic is a recognizable niche and is unlikely to be confused with unrelated skills, but the description gives no behavioral triggers that would distinguish it from other design-system or styling skills, leaving moderate overlap risk.

2 / 3

Total

6

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
bergside/awesome-design-skills
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.