CtrlK
BlogDocsLog inGet started
Tessl Logo

theme-factory

Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.

66

2.04x
Quality

49%

Does it follow best practices?

Impact

100%

2.04x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/all-skills/skills/theme-factory/SKILL.md

The canonical home for this skill is theme-factory in anthropics/skills

SKILL.md
Quality
Evals
Security

Quality

Content

45%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 well-organized into clear sections with a sensible confirm-then-apply workflow, but it is undermined by dangling references — theme-showcase.pdf and the themes/ directory do not exist in the bundle — and by guidance that never gets concrete about what a theme is or how to apply one. Duplication across three sections wastes tokens without adding information.

Suggestions

Ship the referenced bundle files (themes/ directory with the 10 theme specs and theme-showcase.pdf) or restructure the skill so all needed theme details live inside SKILL.md or a real references/ file — currently every reference is broken.

Add one concrete example of a theme's structure (name, palette hex codes, header/body font pairing) so 'apply the theme' and 'create a custom theme similar to the ones above' become executable instructions.

Remove the verbatim repetition of the 'Cohesive color palette / Complementary font pairings / Distinct visual identity' bullets across Purpose, Themes Available, and Theme Details, keeping them in one place.

DimensionReasoningScore

Conciseness

The body is mostly lean, but the Purpose section, the Themes Available intro, and Theme Details all repeat the same three bullets verbatim ('Cohesive color palette with hex codes / Complementary font pairings / Distinct visual identity'), and there are typos ('themes themes', 'Create your Own Theme'). Not a 4 because the duplicated bullets and filler sections could clearly be trimmed; not a 2 because there is no padding that explains concepts Claude already knows.

3 / 5

Actionability

The guidance is procedural but stays at the hint level — 'apply the specified colors and fonts consistently throughout the deck', 'create a custom theme similar to the ones above', 'Use any basic description provided to choose appropriate colors/fonts' — with no example of what a theme file contains, no code or command, and every referenced file (theme-showcase.pdf, themes/) does not exist in the bundle. Not a 3 because the key executable details (theme file format, how to apply, what the showcase is) are missing and the referenced artifacts are unavailable; not a 1 because the numbered usage steps do give a real high-level procedure.

2 / 5

Workflow Clarity

The usage workflow is a clear sequence with explicit checkpoints — 'Show the theme showcase', 'Ask for their choice', 'Wait for selection: Get explicit confirmation', 'Apply the theme' — and the custom-theme path adds 'show it for review and verification'. This is a non-destructive, non-batch skill so the validation cap does not apply. Not a 5 because there is no verification step after applying a theme (e.g., checking contrast/readability beyond a one-line mention) and step 1 is unexecutable since theme-showcase.pdf is missing; not a 3 because checkpoints (explicit confirmation, review of generated themes) are present and explicit.

4 / 5

Progressive Disclosure

The body references 'theme-showcase.pdf' and 'the themes/ directory' as load-bearing resources, but neither exists in the bundle — there are no references/, scripts/, assets/, or themes/ directories at all, so navigation to the actual theme specifications fails entirely. Not a 3 because the referenced paths, while clearly signaled, are broken, leaving the skill's core content (the theme specs) unreachable; not a 1 because the SKILL.md body itself is well-sectioned and flat with no nesting.

2 / 5

Total

11

/

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 clearly states what the skill does and carves out a reasonably distinct theming niche, but it has no 'use when' trigger guidance, omits common user phrasings, and contains typos ('reportings', 'has been creating') that slightly undercut clarity. It sits squarely at the midpoint: a clear 'what' with a missing 'when'.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to style or restyle a slide deck, document, report, or HTML page, or mentions themes, colors, or fonts.'

Fix the typos ('reportings' → 'reports', 'has been creating' → 'has been created') and name the concrete actions users would recognize: browse a theme showcase, apply a preset theme, or generate a custom theme.

Broaden natural trigger terms with synonyms users actually say — 'design', 'branding', 'look and feel', 'presentation', 'deck' — to improve trigger matching.

DimensionReasoningScore

Specificity

Quotes 'apply to any artifact' and 'can generate a new theme on-the-fly' — the domain is named and two concrete actions are given, but coverage is not comprehensive (no mention of reading theme specs, showing a showcase, or what 'applying' concretely involves). It is not a 4 because it stops at two actions with gaps, and not a 2 because the actions are more than minimal or generic.

3 / 5

Completeness

The 'what' is clear ('Toolkit for styling artifacts with a theme... 10 pre-set themes... generate a new theme on-the-fly'), but there is no 'Use when...' clause or any trigger guidance — the rubric explicitly caps completeness at 3 in that case. It is not a 2 because the 'what' is concrete and specific, and not a 4 because 'when' is entirely absent rather than merely implicit.

3 / 5

Trigger Term Quality

Terms like 'styling', 'theme', 'slides', 'docs', 'HTML landing pages' are relevant natural keywords, but common variations users would say are missing ('design', 'branding', 'presentation', 'deck', 'fonts', 'colors'). Not a 4 because the keyword set is thin on synonyms; not a 2 because it goes beyond one or two generic keywords.

3 / 5

Distinctiveness Conflict Risk

The theming/styling niche with '10 pre-set themes with colors/fonts' for 'slides, docs, reportings, HTML landing pages' is mostly distinct with only minor overlap risk against generic design or presentation-building skills. Not a 5 because the artifact list is broad ('docs', 'HTML landing pages') and could overlap with document or web-styling skills; not a 3 because the theme-specific trigger concept is unmistakable.

4 / 5

Total

13

/

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
davepoon/buildwithclaude
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.