CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

html-ppt-zhangzara-grove

A municipal urban-tree-canopy policy proposal — the public need, the evidence, the options, and the funding decision. Built as a decision-grade policy briefing deck for city council, agency reviewers.

52

Quality

66%

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

Quality

Content

71%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 lean, well-structured instruction guide with a concrete six-step workflow and an exact output contract, and it avoids over-explaining anything Claude already knows. Its main weaknesses are the absence of any validation or critic checkpoint in the workflow and the fact that the files it instructs the reader to clone and redistribute (example.html, template.json, LICENSE, assets/deck-stage.js) are missing from the bundle, leaving its core instructions unexecutable as shipped.

Suggestions

Ship the referenced bundle files (example.html, template.json, LICENSE, and any assets/deck-stage.js runtime) or remove/adjust the instructions that depend on them, so step 1 of the workflow is actually executable.

Add a final validation step to the workflow, e.g. 'Before emitting, re-check the deck: fonts, palette, and decorative elements unchanged; slide count and page-number labels consistent; artifact opens as valid HTML.'

Move the upstream-license redistribution detail (currently four sentences) into the LICENSE/template.json files themselves and keep a one-line pointer in SKILL.md to tighten the closing section.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence — no HTML or design-concept explanations — with every section (At a glance, Best for, Avoid for, Workflow, Output contract) earning its place; minor verbosity in the Source & license prose keeps it just below the lean score-5 anchor, and there is no padded over-explanation that would drop it to 3.

4 / 5

Actionability

The workflow gives concrete executable steps ('Clone `example.html` into the user's workspace as the working file', 'duplicate an existing slide of the most appropriate layout', 'Update page-number labels') plus a copy-paste-ready `<artifact>` output snippet; minor gaps — no example of a completed slide and no output verification step — keep it below the fully-executable score-5 anchor, while it clearly exceeds the incomplete-guidance score-3 anchor.

4 / 5

Workflow Clarity

Six well-ordered, unambiguous steps cover clone → replace → preserve → resize → extend → ship, plus an explicit output contract; the sequence is clear but there is no validation/critic checkpoint (e.g., a final check that the deck renders or matches the template system), matching the 'clear sequence with most checkpoints; minor validation gaps' anchor rather than the score-5 anchor requiring explicit validation steps. The destructive/batch cap does not apply since this is a creative authoring task.

4 / 5

Progressive Disclosure

The body itself is short and well-sectioned, but it directs the reader to bundle files that are not present in this skill directory — `example.html`, `template.json`, `LICENSE`, and `assets/deck-stage.js` (no references/, scripts/, or assets/ directories exist) — so the workflow's first step ('Clone `example.html`') cannot actually be executed and navigation targets are unresolvable; this matches the 'references present but not clearly signaled/verifiable' score-3 anchor rather than the good-structure score-4 anchor.

3 / 5

Total

15

/

20

Passed

Description

50%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 gives a concrete, well-scoped picture of the deliverable (a decision-grade municipal tree-canopy policy briefing deck with need, evidence, options, and funding), but it describes the artifact rather than the skill's actions and completely omits any 'Use when' trigger guidance. It also leans on domain-specific vocabulary while missing the natural phrases a user would say.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for a policy brief, government-policy deck, or urban green-space/green-infrastructure presentation for city council or agency review.'

Lead with the skill's concrete actions in third person (e.g., 'Creates and edits a policy-briefing HTML deck...') instead of describing the artifact's subject matter.

Include natural user-facing synonyms such as 'policy brief', 'presentation', 'slides', and 'green infrastructure' to improve trigger matching and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain ('A municipal urban-tree-canopy policy proposal — the public need, the evidence, the options, and the funding decision') and one implicit action ('Built as a decision-grade policy briefing deck'), which matches the 'domain and 1-2 concrete actions' anchor; it is more informative than the score-2 anchor but does not list several concrete actions needed for a 4.

3 / 5

Completeness

The 'what' is clear (a decision-grade policy briefing deck covering need, evidence, options, and funding), but there is no 'Use when...' clause or equivalent explicit trigger guidance — only a weakly implied 'when' via the audience ('for city council, agency reviewers'), so per the guideline the score is capped at 3; it is not a 2 because the 'what' is concrete and specific.

3 / 5

Trigger Term Quality

Relevant keywords like 'policy briefing deck', 'city council', and 'funding decision' are present, but common natural variations users would say — 'policy brief', 'presentation', 'slides', 'green space' — are missing, matching the 'some relevant keywords but missing common variations' anchor rather than the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

The urban-tree-canopy policy niche is fairly specific, but broadly useful terms like 'policy', 'proposal', 'decision', and 'deck' create real overlap risk with the many sibling template/policy-deck skills, matching the 'somewhat specific but could still overlap with similar skills' anchor; it is not a 4 because the description offers no differentiating trigger phrasing.

3 / 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-grove/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.