CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

html-ppt-zhangzara-pin-and-paper

A field-biology capstone on urban pollinator decline — the survey design, the data, the contribution, and the caveats. Built as a decision-grade coursework defense deck for faculty reviewers.

50

Quality

63%

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-pin-and-paper/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

A lean, well-organized template skill body with a concrete six-step workflow and an explicit output contract — the writing quality is high and nothing pads the token budget. Its weakness is bundle integrity rather than prose: the workflow's central file (`example.html`) plus the referenced `LICENSE` and `template.json` are absent from the shipped skill, leaving the most important instructions unexecutable and the license-redistribution instruction unsatisfiable.

Suggestions

Ship the referenced bundle files (`example.html`, `LICENSE`, `template.json`) inside the skill directory so step 1 ("Clone `example.html` AND the `assets/` folder") and the license-redistribution requirement are executable, or remove the dead references from the body.

Add an explicit verification step after cloning/adjusting the deck, e.g. "Confirm `assets/deck-stage.js` loads and keyboard navigation advances a slide before emitting the artifact," turning step 1's 404 warning into a checkpoint.

Merge step 6 ("Keep the navigation runtime as shipped") into step 1 to remove the redundancy about `assets/deck-stage.js`.

DimensionReasoningScore

Conciseness

The body is tight: "At a glance" is a four-bullet spec, "Best for"/"Avoid for" are one paragraph each, and nothing explains concepts Claude already knows (no "what HTML is", no font tutorials). Only minor trimming candidates exist — step 6 ("Keep the navigation runtime as shipped") partially repeats step 1's treatment of `assets/deck-stage.js`, and step 1's 404 explanation runs slightly long. This is anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed"), not 5, because of that redundancy.

4 / 5

Actionability

The guidance is genuinely concrete — "Clone `example.html` AND the `assets/` folder", "Update page-number labels", and an exact `<artifact identifier="zhangzara-pin-and-paper" type="text/html">` output contract. But the central executable target is missing from the bundle: `example.html` (and the referenced `LICENSE` and `template.json`) do not exist alongside `assets/deck-stage.js` and `assets/styles.css`, so the primary instruction cannot be executed as written. That is a key missing detail, matching anchor 3 ("Some concrete guidance but incomplete; ... missing key details") rather than 4's "minor gaps".

3 / 5

Workflow Clarity

Six numbered steps in a clear sequence: clone files, replace placeholders, preserve the design system, duplicate layouts for length, design missing layouts in-system, keep the runtime intact. Step 1 even names the failure mode ("those paths will 404 ... navigation/styling will silently break"), which functions as an implicit checkpoint. This is not a destructive or batch operation, so the validation cap does not apply; it sits at anchor 4 ("Clear sequence with most checkpoints present; minor validation gaps") rather than 5 because there is no explicit verify step (e.g., confirm navigation works in the emitted deck) and rather than 3 because the steps are far more concrete than that anchor's example.

4 / 5

Progressive Disclosure

Sectioning is good (At a glance / Best for / Avoid for / Workflow / Output contract / Source & license) and references are one level deep and clearly signaled as markdown links (`LICENSE`, `template.json`, `assets/*`). But scored against the actual bundle, three of the referenced paths are dead — `example.html`, `LICENSE`, and `template.json` are not shipped — so the navigation the body promises does not hold up. This lands at anchor 3 ("Some structure but could be better organized") rather than 4, whose "references mostly clear" presumes the referenced files actually exist.

3 / 5

Total

14

/

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 is distinctive and domain-specific but reads as a description of one particular deck's subject matter rather than a statement of the skill's capability. It lists no concrete actions, omits any "use when" trigger guidance, and lacks common synonyms (presentation, slides, thesis defense) users would naturally say. Adding explicit capability verbs and trigger conditions would raise all four dimensions.

Suggestions

Rewrite the description to state capabilities in third person (e.g., "Builds a coursework defense deck as a self-contained HTML slide deck using the Pin & Paper template") instead of describing the example subject matter (urban pollinator decline), which belongs in an example, not the description.

Add an explicit trigger clause, e.g. "Use when the user asks for a capstone, thesis, or coursework defense presentation, student slides, or an academic defense deck."

Include natural trigger synonyms such as "defense presentation", "slides", "thesis defense", and "HTML deck" so the skill surfaces for the phrasings users actually say.

DimensionReasoningScore

Specificity

The description names a precise domain — "A field-biology capstone on urban pollinator decline — the survey design, the data, the contribution, and the caveats" and "decision-grade coursework defense deck for faculty reviewers" — but contains essentially no capability verbs: it describes the deck's subject matter, not what the skill does (no "create", "build", "design slides", "generate HTML"). This matches anchor 2 ("Names the domain but actions are minimal or generic") rather than 3, which requires 1-2 concrete actions; it is not anchor 1 because the domain framing is specific, not vague.

2 / 5

Completeness

The "what" is present but framed as the artifact's subject ("Built as a decision-grade coursework defense deck for faculty reviewers") rather than an explicit capability; there is no "Use when..." clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. Anchor 3 ("Has a clear 'what' but 'when' is missing or only weakly implied") is the best fit — not 2, because the what is not vague.

3 / 5

Trigger Term Quality

Some natural terms users would say are present: "capstone", "defense deck", "coursework", "field-biology". But common variations are missing: "presentation", "slides", "thesis defense", "defense presentation", "HTML deck". This fits anchor 3 ("Some relevant keywords but missing common variations or synonyms"), above anchor 2 because the terms present are relevant rather than generic, below anchor 4 because key synonyms users actually say are absent.

3 / 5

Distinctiveness Conflict Risk

The ultra-specific subject ("urban pollinator decline", "faculty reviewers") gives it a clear niche with minimal generic conflict risk, fitting anchor 4 ("Mostly distinct; minor overlap risk with closely related skills") — the residual overlap is with the sibling family of template-deck skills, since the description never names "HTML deck" or the template system that distinguishes it from them. Not 5, because those closely related siblings share the generic "deck"/"coursework" vocabulary.

4 / 5

Total

12

/

20

Passed

Validation

87%

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

Validation — 14 / 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

Total

14

/

16

Passed

Repository

nexu-io/open-design

Path

design-templates/html-ppt-zhangzara-pin-and-paper/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.