CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

html-ppt-zhangzara-8-bit-orbit

A gamer's journey building a retro-arcade collection — the obsession, the hunt, and what the machines came to mean. Built as a decision-grade story deck for friends, hobby community.

52

Quality

65%

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-zhangzara-8-bit-orbit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 template-use guide: concrete workflow steps, an explicit output contract, and honest license provenance. Its main weakness is the absence of any validation or verification step after the deck is assembled, and its references point at bundle files that are not shipped alongside it here.

Suggestions

Add an explicit verification step to the workflow, e.g. 'After assembly, open the deck and confirm slide count, page-number labels, and that placeholder text and images are fully replaced.'

Ship the referenced bundle files (`example.html`, `template.json`, `LICENSE`, any `assets/` runtime) with the skill, or restate critical design tokens (fonts, palette) inline so the guide is self-sufficient.

Trim the duplicated admonition to stay within the template — stated both in the intro ('stay inside this one') and in step 5 ('never bail to a different template').

DimensionReasoningScore

Conciseness

The body is lean and well-sectioned (At a glance, Best for/Avoid for, Workflow, Output contract, Source & license) with no explanation of concepts Claude already knows. It falls short of anchor 5 only through minor repetition — 'stay inside this one' is restated as 'never bail to a different template' — so anchor 4 (efficient, minor trims possible) fits.

4 / 5

Actionability

The guidance is concrete and executable for an instruction-only skill: clone `example.html`, replace placeholders with real headlines/numbers/names, duplicate layouts to lengthen, keep `assets/deck-stage.js` intact, and emit via an explicit `<artifact>` contract with a literal example. Minor gaps (no font/palette specifics) are acceptable since they live in the template file, matching anchor 4 rather than fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

The six steps are clearly sequenced with edge-case handling (more content, less content, missing layouts), but there are no validation or verification checkpoints at all — no 'confirm the deck renders', 'check page-number labels match slide count', or critic pass step. Anchor 3 (sequence present, checkpoints missing) fits better than 4 (most checkpoints present).

3 / 5

Progressive Disclosure

The body is well organized into clear sections with one-level-deep, clearly signaled file references (`example.html`, `template.json`, `LICENSE`). It does not reach anchor 5 because the referenced bundle files are not present in this skill's directory, leaving the pointers unverifiable against an actual bundle structure.

4 / 5

Total

15

/

20

Passed

Description

48%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 blurb for the deck's subject matter rather than a functional description of the skill: it names a distinctive niche but says nothing about what the skill does or when to invoke it. Adding explicit capability verbs and a 'Use when...' clause with natural trigger phrases would lift it substantially.

Suggestions

Rewrite the description in third person with concrete actions, e.g. 'Creates a single-file HTML story deck in a pixel-art retro-arcade template: clones the template, swaps in the user's photos and story beats, and adjusts deck length while preserving the design system.'

Add an explicit trigger clause such as 'Use when the user wants to turn a personal hobby, trip, or passion project into a presentation or story deck of slides.'

Include natural trigger terms users would actually say — 'presentation', 'slides', 'HTML deck', 'hobby story' — alongside the existing niche terms.

DimensionReasoningScore

Specificity

The description names the domain ('retro-arcade collection', 'decision-grade story deck') but contains no concrete actions the skill performs — 'Built as a... story deck' describes the deck's subject, not what the skill does. This matches anchor 2 (names the domain, minimal/generic actions) rather than 3, which requires 1–2 concrete actions.

2 / 5

Completeness

There is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. The 'what' is only weakly implied — the description characterizes the deck's content rather than the skill's function — so it does not reach 4, but the deliverable and audience are at least identifiable, keeping it above 2.

3 / 5

Trigger Term Quality

Terms like 'story deck', 'gamer', 'retro-arcade collection', and 'hobby community' are topically relevant, but common natural variations users would say ('presentation', 'slides', 'make a deck about my hobby') are missing. Anchor 3 (some relevant keywords, missing variations) fits better than 4 (good coverage, a few missing).

3 / 5

Distinctiveness Conflict Risk

The retro-arcade hobby story-deck niche is specific and unlikely to trigger for unrelated skills, with only minor overlap risk against sibling story-deck or photo-essay deck skills. Mostly distinct (anchor 4) rather than a fully clear niche (anchor 5).

4 / 5

Total

12

/

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: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

nexu-io/open-design

Path

design-templates/html-ppt-zhangzara-8-bit-orbit/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.