CtrlK
BlogDocsLog inGet started
Tessl Logo

design-brief

Parse a structured design brief written in I-Lang protocol format into a concrete design spec. Eliminates ambiguity from vague requests like "make it professional" by requiring explicit dimensions: palette, typography, layout, mood, density, and constraints. Trigger keywords: "design brief", "create a design brief", "ilang brief", "structured brief".

67

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 dense, highly actionable skill body: a crisp five-step workflow with closed-vocabulary validation, exact design tokens, default resolution rules, and a complete output template. The only real waste is two paragraphs of repo-history commentary that adds tokens without operational value.

DimensionReasoningScore

Conciseness

The body is almost entirely operational (mapping tables, exact hex tokens, default rules, template), but the Background aside about OpenDesign's "71-system catalog" and the Section 3 paragraph about repo package schema ("not the current repository package schema... manifest.json, tokens.css") are extraneous history that could be trimmed. These are minor instances of over-explanation in an otherwise efficient document, matching anchor 4 rather than 3.

4 / 5

Actionability

Everything is executable: exact token resolutions ("Background: #0F172A, Surface: #1E293B"), exact spacing values ("Section spacing: 96px"), a complete fill-in DESIGN.md template, concrete preview requirements (primary button, card, text input as live HTML), and a scripted clarification prompt for unrecognized values. This instruction-only skill provides fully concrete, copy-ready guidance covering the common cases, matching anchor 5.

5 / 5

Workflow Clarity

A clear 5-step sequence (accept input → validate dimensions → generate DESIGN.md → generate preview → report defaults) with explicit validation checkpoints: prompting for clarification on unrecognized values, asking the user before overwriting an existing DESIGN.md, and reporting unspecified dimensions with the rule that selected each default. Feedback loops for error recovery are present and there are no unvalidated destructive or batch operations, matching anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist; the 220-line body is well-sectioned with numbered steps and every table (mapping, tokens, defaults) is load-bearing on each run, so inlining is mostly appropriate. Not 5: the document is well over 50 lines and the 58-line DESIGN.md template and token-resolution table are natural candidates for a references/ file; this is good structure with minor organization gaps, matching anchor 4.

4 / 5

Total

18

/

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 solid, specific description with a clear niche and low conflict risk. Its main weakness is that the trigger guidance is a keyword list rather than an explicit use-condition clause, and it undersells the skill's concrete outputs (DESIGN.md and the HTML preview).

Suggestions

Add an explicit "Use when..." clause (e.g., "Use when the user provides a design brief or asks to turn vague design requests into a structured spec") instead of relying solely on the trigger keyword list.

Mention the concrete outputs in the what-statement: generating DESIGN.md and a brief-preview.html, so the description covers the full action surface.

Broaden trigger coverage with natural synonyms users might say, such as "design spec", "style brief", or "design requirements".

DimensionReasoningScore

Specificity

"Parse a structured design brief written in I-Lang protocol format into a concrete design spec" names the domain and one concrete action, and the six explicit dimensions (palette, typography, layout, mood, density, constraints) add concreteness, but it omits the actual outputs (DESIGN.md, brief-preview.html) and downstream actions. This matches anchor 3 (1-2 concrete actions, not comprehensive) rather than 4, which requires only minor coverage gaps.

3 / 5

Completeness

The "what" is clear (parse I-Lang brief into a concrete design spec with explicit dimensions) and explicit trigger guidance is present via the keyword list, so it is not capped at 3. Not 5 because the "when" is a bare keyword list rather than an explicit use-condition clause ("Use when the user asks for..."), leaving it slightly less contextualized than the anchor-5 pattern.

4 / 5

Trigger Term Quality

Trigger keywords "design brief", "create a design brief", "ilang brief", "structured brief" are natural phrases a user would plausibly say, giving good coverage. Not 5 because common synonyms and variants (e.g., "design spec", "style brief", "design requirements") are missing.

4 / 5

Distinctiveness Conflict Risk

"ilang brief" and "structured brief" are highly niche triggers, and "design brief" scopes to a distinct planning task with minimal overlap with general design or document skills. This matches anchor 5 (clear niche, distinct triggers, minimal conflict risk).

5 / 5

Total

16

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
nexu-io/open-design
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.