CtrlK
BlogDocsLog inGet started
Tessl Logo

create-theme

Use this skill when the user wants to create, draft, author, or extract a slide theme in this open-slide repo. Triggers on phrases like "create a theme", "make a theme called X", "extract a theme from <slide>", "build a theme from these images". Produces two paired files under `themes/` — `<id>.md` (palette, typography, layout, fixed Title/Footer components, motion) and `<id>.demo.tsx` (a runnable demo slide that the dev-UI Themes panel previews). Do NOT use for editing real slides — only for authoring the theme bundle.

75

Quality

94%

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

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.

The body is a highly actionable, well-sequenced workflow: concrete templates, executable code, a self-review checklist, and anti-patterns leave little ambiguity about what to produce. Its only weaknesses are mild guardrail repetition and a large inline template that could be split into a reference file.

Suggestions

Consolidate the repeated 'never modify real slides/config' guardrail into one place (e.g. the Anti-patterns section) to trim redundancy and improve conciseness.

Consider moving the full theme markdown template (Step 4) into a references/ file (e.g. references/theme-template.md) and keeping only the section order and rules inline, so SKILL.md stays a navigable overview.

Step 2's per-input extraction bullets and Step 4b's contract could cross-reference each other explicitly (e.g. noting which checklist items verify which contract points) to tighten the feedback loop.

DimensionReasoningScore

Conciseness

The body is dense and nearly every section is load-bearing (exact template, paste-ready components, contract list, checklist, anti-patterns), but there is some redundancy: "Never modify real slides or other configuration", "Do not modify real slides — even to demonstrate the theme", and the anti-pattern "Editing slides/, packages/, package.json..." restate the same guardrail three times. This fits the level-4 anchor (efficient with minor instances that could be trimmed) rather than level 5, where every token would earn its place.

4 / 5

Actionability

Guidance is fully executable: an exact section-ordered markdown template, complete paste-ready Title/Footer/Eyebrow React components with concrete inline styles, a demo .tsx skeleton with import lines, and a precise contract list ("import { type Page, useSlidePageNumber } from '@open-slide/core'", "Export 2–3 Page components and a default array"). This matches the copy-paste-ready top anchor rather than level 4, which would allow minor gaps; even edge rules (webfont @import exception) are stated explicitly.

5 / 5

Workflow Clarity

Six clearly sequenced steps with an explicit validation checkpoint: Step 5's self-review checklist ("verify it against the Step 4b contract by reading the file — do not start a server") and an error-recovery path for conflicting inputs ("When inputs disagree... ask the user which to honor"). This matches the top anchor (explicit validation steps, feedback loops, checklists for complex processes) rather than level 4, where checkpoints would be mostly rather than fully present.

5 / 5

Progressive Disclosure

The single file is well organized with clear step headings and correctly delegates shared knowledge to the slide-authoring skill ("read it before writing the theme so your overrides are stated explicitly", "see references/webfonts.md in slide-authoring"). However, the ~130-line embedded theme template makes the body monolithic; moving it or the demo contract to a references file would improve navigability. This fits the level-4 anchor (good structure, mostly appropriate placement, minor gaps) rather than level 5's well-signaled one-level-deep reference split.

4 / 5

Total

18

/

20

Passed

Description

100%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 is exemplary: it states what the skill produces (two paired files with their contents enumerated), gives explicit natural-language trigger phrases, and draws a sharp boundary against slide editing. Everything stated is concrete with no fluff or over-claims.

DimensionReasoningScore

Specificity

Concrete actions are enumerated: "create, draft, author, or extract a slide theme", and the outputs are specified precisely — "two paired files under themes/ — <id>.md (palette, typography, layout, fixed Title/Footer components, motion) and <id>.demo.tsx (a runnable demo slide that the dev-UI Themes panel previews)". This matches the top anchor (multiple specific concrete actions, comprehensive coverage) rather than the level-4 anchor, which requires minor gaps in coverage; the artifact set and their contents are fully named.

5 / 5

Completeness

Both what and when are explicit: "Use this skill when the user wants to create, draft, author, or extract a slide theme" plus "Triggers on phrases like..." for when, and the two-file output contract for what, plus an exclusion ("Do NOT use for editing real slides"). It matches the level-5 anchor exactly; level 4 would require the when-clause to be less explicit, but here it is stated with concrete trigger phrases.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases are quoted: "create a theme", "make a theme called X", "extract a theme from <slide>", "build a theme from these images" — covering create/author/extract intents with colloquial phrasing users would actually say. This matches the comprehensive-synonyms anchor rather than level 4, where a few natural terms would be missing; no common variation of the request is absent.

5 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — authoring theme bundles in the open-slide repo — and it is explicitly disambiguated from the adjacent skill: "Do NOT use for editing real slides — only for authoring the theme bundle". This gives minimal conflict risk with create-slide or slide-editing requests, matching the clear-niche top anchor rather than the level-4 minor-overlap anchor.

5 / 5

Total

20

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
1weiho/open-slide
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.