CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

html-ppt-zhangzara-retro-zine

A neighborhood zine on the disappearing corner shops — portraits, voices, and what a block loses when they close. Built as a decision-grade story deck for community, local readers.

56

Quality

70%

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-retro-zine/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 tight, well-structured instruction skill: a crisp identity summary, an unambiguous six-step workflow with a concrete output contract, and clearly signaled one-level references. The only notable gaps are the absence of any validation/critic pass in the workflow and a few slightly under-specified edit steps.

Suggestions

Add a final validation step to the workflow, e.g. re-open the emitted artifact and check fonts, palette, and decorative elements are intact before delivering.

Include one small concrete example of a placeholder swap (before/after headline or image tag) so step 2 is copy-paste unambiguous.

Briefly enumerate the bundle's key files at the top (example.html, template.json, assets/) so the referenced inventory is self-describing.

DimensionReasoningScore

Conciseness

The ~60-line body is lean with zero padding: every section (at-a-glance metadata, best for / avoid for, 6-step workflow, output contract, license) carries information Claude does not already know, and nothing explains concepts Claude already understands. This matches anchor 5 'Lean and efficient; assumes Claude's competence; every token earns its place' — nothing here could be trimmed without losing real guidance.

5 / 5

Actionability

The guidance is concrete and executable for an instruction-only skill: 'Clone `example.html` into the user's workspace', an exact copy-paste `<artifact>` output contract, and specific rules ('Never substitute fonts, recolor the palette... '). It is not 5 because a few steps remain high-level — e.g. 'Replace placeholder content' and 'Update page-number labels' give no concrete example of the placeholder format or where numbering lives.

4 / 5

Workflow Clarity

The six steps are clearly sequenced from cloning through output, covering extension ('duplicate an existing slide'), reduction ('drop slides from the bottom'), and novel layouts ('design it from scratch using the same fonts, palette, decorative vocabulary'). It sits at 4 rather than 5 because there is no validation or critic checkpoint (e.g. re-render the deck or verify the artifact against the rubric in the frontmatter), though this operation is non-destructive so no cap applies.

4 / 5

Progressive Disclosure

The body is a compact, well-sectioned overview with clearly signaled one-level-deep references to bundle files (`example.html`, `template.json`, `assets/deck-stage.js`, `LICENSE`) and no nested-reference indirection. It is 4 rather than 5 because the referenced bundle files cannot be confirmed against a listing (no references/scripts/assets directories are present alongside it), leaving the pointer inventory slightly under-specified — e.g. no explicit statement of what `template.json` contains beyond 'the upstream metadata snapshot'.

4 / 5

Total

17

/

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 vividly conveys the skill's subject and audience but never states what the skill actually does or when to invoke it. It reads like a deck synopsis rather than a capability statement, costing it on specificity and completeness.

Suggestions

Add an explicit 'Use when...' clause with concrete trigger phrases, e.g. 'Use when the user wants a zine, photo essay, indie magazine-style story deck, or printed-lofi HTML presentation.'

State the capability in third person with concrete actions, e.g. 'Builds a self-contained HTML story deck from the retro-zine template — clones the layout, swaps in the user's headlines, photos, and quotes, and extends slide count by duplicating layouts.'

Include natural synonyms users would actually say ('photo essay', 'zine layout', 'slide deck', 'indie magazine') to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ("A neighborhood zine on the disappearing corner shops") and the output form ("a decision-grade story deck"), but contains no concrete actions or verbs — it describes the artifact's subject matter ("portraits, voices, and what a block loses") rather than what the skill does. This matches the anchor 'Names the domain but actions are minimal or generic'; it is above 1 because the domain and output are named concretely, but below 3 because no specific capability (create/edit/build slides) is stated.

2 / 5

Completeness

The 'what' is reasonably clear (produce a zine-style story deck about disappearing corner shops for community readers), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description — per the judging guidelines this caps completeness at 3. It is above 2 because the what is concrete, not vague, and below 4 because 'when' is entirely missing rather than merely implicit.

3 / 5

Trigger Term Quality

Some natural keywords users would say are present — "neighborhood zine", "story deck", "portraits", "community" — but common variations and synonyms are missing (photo essay, zine layout, slide deck, indie magazine). This fits anchor 3 'Some relevant keywords but missing common variations or synonyms'; above 2 because several genuinely natural terms exist, below 4 because phrases like "decision-grade" are jargon users would not say and obvious variants are absent.

3 / 5

Distinctiveness Conflict Risk

The subject (a specific neighborhood-zine aesthetic, "riso-printed", corner-shop storytelling for community readers) carves out a fairly distinct niche with low conflict risk against general skills. It sits at anchor 4 'Mostly distinct; minor overlap risk' rather than 5 because the generic framing "decision-grade story deck for community, local readers" could collide with sibling story-deck skills that share the same pattern.

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-retro-zine/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.