CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

html-ppt-presenter-mode

OpenDesign live demo: from a one-line prompt to runnable design in a single session — the flow, live. Built as a decision-grade AI literacy deck for developers, prospects, community.

49

Quality

62%

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 ./design-templates/html-ppt-presenter-mode-reveal/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is a tight, well-structured entry-point skill: a numbered authoring workflow with concrete file paths, an explicit two-recipe treatment of the asset-URL failure mode, and clean delegation of detailed rules to the master skill. Its only notable weakness is the absence of a post-copy validation step confirming the runtime and keyboard navigation actually load. Conciseness is good, with only the 404 explanation running slightly long.

Suggestions

Add a final validation step, e.g. 'After rewriting the asset URLs, open index.html and confirm runtime.js loads and keyboard navigation (arrows / T) works before delivering.'

Show the exact four <link>/<script> lines before and after the rewrite (a short diff-style snippet) so the fix is copy-paste ready rather than described.

Trim the multi-line explanation of why '../../../assets/...' URLs break to a single sentence — the recipes already make the fix unambiguous.

DimensionReasoningScore

Conciseness

The body is efficient: it assumes competence, uses precise file paths, and avoids explaining concepts Claude already knows (no 'what is HTML' padding). The one passage that could be tightened is the explanation of why '../../../assets/...' URLs 404 after copying, which spends several lines on a problem that could be stated in one. This fits 'Efficient; minor instances of over-explanation that could be trimmed' — not 5 because of that passage, not 3 because nothing is unnecessary filler.

4 / 5

Actionability

Guidance is concrete and executable: exact paths to copy ('design-templates/html-ppt/assets/fonts.css', '.../base.css', '.../animations/animations.css', '.../runtime.js'), the exact rewrite ('../../../assets/...' → project-local paths), the body class to keep ('.tpl-presenter-mode-reveal'), and the elements for speaker notes ('<aside class="notes">'). It stops short of copy-paste-ready snippets — the actual <link>/<script> tag lines are described, not shown — so it is 'mostly executable guidance with minor gaps', not fully copy-paste ready at 5.

4 / 5

Workflow Clarity

A clear six-step sequence (read master skill → copy template → fix asset URLs via Recipe A/B → pick theme → replace content → add notes) with the trickiest failure mode (broken parent-relative URLs) handled explicitly. What is missing is a validation checkpoint: no step verifies the deck actually runs (e.g., open index.html and confirm runtime.js loads and navigation works) after the rewrite. This is 'Clear sequence with most checkpoints present; minor validation gaps' — not 5 because the post-rewrite verification is implicit, not 3 because the sequence itself is complete and the one risky operation is guarded by two explicit recipes.

4 / 5

Progressive Disclosure

The body is a lean pointer card: all authoring rules are delegated to the master skill (../html-ppt/SKILL.md) with clearly labeled links, and the template catalog is one level deep (../html-ppt/references/full-decks.md). No local references/, scripts/, or assets/ bundle exists to check against, and the structure here is well-organized with section headers. It sits at 'Good structure; most content appropriately placed; references mostly clear' — not 5 because the referenced sibling paths cannot be verified from this bundle and a couple of references (the templates folder, the themes glob) are prose rather than links, but well above 3.

4 / 5

Total

16

/

20

Passed

Description

36%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 reads as a tagline for the deck's content rather than a capability statement for the skill: it says what the deck is about, not what the skill does or when to invoke it. There is no 'Use when...' trigger guidance and no concrete action verbs, which leaves both completeness and specificity weak. The niche subject matter (OpenDesign live demo) gives it moderate distinctiveness despite the generic framing.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user asks for a live-demo deck, presenter-mode HTML slides, or an AI literacy presentation in the presenter-mode-reveal look.'

State concrete actions in third person (per the guidelines' voice rule): e.g. 'Builds an HTML presenter-mode slide deck from a single prompt, wires keyboard navigation, and adds speaker notes.'

Include natural trigger synonyms users would say — 'slides', 'presentation', 'HTML deck', 'speaker notes' — rather than only 'deck' and 'AI literacy'.

DimensionReasoningScore

Specificity

The description names the domain ("OpenDesign live demo: from a one-line prompt to runnable design in a single session") but describes the deck's subject matter rather than concrete actions the skill performs — there is no verb-driven capability list (e.g., 'creates HTML decks', 'applies a presenter-mode template'). This matches the anchor 'Names the domain but actions are minimal or generic'; it is above 1 because the domain itself is concrete, and below 3 because no specific actions are listed at all.

2 / 5

Completeness

The 'what' is vague — 'Built as a decision-grade AI literacy deck for developers, prospects, community' describes the artifact's framing, not what the skill does — and there is no 'when' / 'Use when...' clause anywhere in the description, which the guidelines cap at 3 regardless. It fits anchor 2 ('Has a vague what and no when'): above 1 because the topic is stated, below 3 because the what is framing language rather than a clear capability statement.

2 / 5

Trigger Term Quality

Some natural, relevant terms appear — "live demo", "AI literacy", "deck" — but common variations a user would actually say ("slides", "presentation", "HTML deck", "speaker notes") are missing from the description itself. This sits at 'Some relevant keywords but missing common variations or synonyms'; it is not 4 because the natural-phrase coverage is thin, and not 2 because the keywords present are ones users do say.

3 / 5

Distinctiveness Conflict Risk

"OpenDesign live demo" is a clear niche marker, but the surrounding terms ("AI literacy deck", "developers, prospects, community") are broad and could overlap with other deck/slide skills. This matches 'Somewhat specific but could still overlap with similar skills'; not 4 because nothing in the description itself distinguishes it from sibling deck skills, and not 2 because the named subject does constrain it.

3 / 5

Total

10

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 suspicious

Warning

referenced_paths_exist

Referenced path issues: 5 missing, 2 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository

nexu-io/open-design

Path

design-templates/html-ppt-presenter-mode-reveal/SKILL.md

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.