CtrlK
BlogDocsLog inGet started
Tessl Logo

book-serif-index

Create an archival book-reader design system with serif-led pages, mono index navigation, aged paper surfaces, margin notes, and a premium catalog frame.

49

Quality

53%

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

Fix and improve this skill with Tessl

tessl review fix ./agent-skills/web-design/book-serif-index/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

47%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-organized, reasonably concise design brief, but it has a glaring structural defect: the 'Workflow' section is empty, and the 'Use When' section restates the description instead of giving trigger conditions. Its guidance is directionally rich yet lacks the concrete tokens or patterns that would make it directly executable for a design task.

Suggestions

Fill in or remove the empty '## Workflow' section — either give a real sequence (define palette and typography tokens, build the outer shell, build the book surface, add index navigation, add scholarly details) or delete the heading so it doesn't advertise missing content.

Replace the 'Use When' bullet that repeats the description verbatim with actual trigger conditions (e.g. 'Use when the user asks for a book-reader, archival, or editorial reading interface').

Make the guidance executable by adding concrete tokens: example font stacks (a display serif, a readable body serif, a mono for labels), a sample palette (dark shell hex, warm paper hex, ink tones, one accent), and CSS techniques for the crease/texture effects instead of descriptive prose.

DimensionReasoningScore

Conciseness

The body is mostly lean directive bullets with no explanation of concepts Claude already knows, but the same material (paper texture, crease shadows, index rails) is restated across 'Visual target', 'Implementation guidance', and 'Recommended patterns', and the 'Use When' section repeats the frontmatter description verbatim instead of stating conditions.

3 / 5

Actionability

As an instruction-only design skill it gives concrete vocabulary ('drop caps, marginalia boxes', 'subdued oxblood, bronze, or antique gold', 'two-zone composition'), but it stops short of executable specifics such as font stacks, color values, spacing scale, or component structure — the guidance hints at what to build without the details needed to build it.

3 / 5

Workflow Clarity

The '## Workflow' section is completely empty — no steps, no sequence, and no checkpoints anywhere in the body, which sits between anchor 1 (steps missing) and anchor 3 (steps listed but validation-gapped); it is not a destructive/batch operation, so no validation cap applies.

2 / 5

Progressive Disclosure

The body is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist), and the sections are clearly labeled and organized, so it qualifies for the simple-skill exception; the empty 'Workflow' heading and the redundant 'Use When' section keep it below a 5.

4 / 5

Total

12

/

20

Passed

Description

58%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 communicates a distinctive and fairly concrete design direction, but it omits any 'Use when...' trigger guidance and lacks natural synonym keywords users would say. Adding an explicit trigger clause with common phrasings would lift both completeness and trigger term quality.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks for a book-reader, archival, editorial, or reading-centric interface, or mentions serif typography, margin notes, or catalog-style index navigation.'

Include natural synonyms and variations users would say ('reading app', 'e-reader', 'library/archive interface', 'editorial layout') so the description matches real user phrasing, not just internal terminology.

Consider naming the concrete actions the skill performs (e.g. 'Build page layouts, index sidebars, and typography tokens') rather than submerging everything under a single 'Create' verb.

DimensionReasoningScore

Specificity

The description lists several concrete deliverables — 'serif-led pages, mono index navigation, aged paper surfaces, margin notes, and a premium catalog frame' — but frames them all under a single 'Create' action rather than multiple distinct actions, so it falls between the 3 and 5 anchors.

4 / 5

Completeness

The 'what' is clear (create an archival book-reader design system with the listed traits), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Terms like 'archival', 'book-reader', and 'catalog' are relevant, but the description misses common natural variations users would say ('reading app', 'editorial layout', 'e-reader', 'library interface') and contains no explicit trigger phrasing.

3 / 5

Distinctiveness Conflict Risk

The niche ('archival book-reader design system' with aged paper and mono index navigation) is mostly distinct and specific enough to avoid firing for unrelated skills, with only minor overlap risk against other aesthetic design-system skills.

4 / 5

Total

14

/

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