CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

html-ppt-xhs-white-editorial

A staff-engineer promotion packet — scope, the proof moments, the artifacts, and the impact that clears the bar. Built as a decision-grade career deck for manager, calibration committee.

55

Quality

69%

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-xhs-white-editorial/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.

A well-structured pointer card that holds exactly the template-specific knowledge (asset-path 404 gotcha, class preservation, notes placement) while delegating general authoring rules to the master skill. The guidance is concrete and sequenced, with the main failure mode explicitly mitigated; the only misses are a missing end-to-end verification step and reliance on external paths that are unverifiable within this bundle.

Suggestions

Add a final verification step to the workflow, e.g. 'open index.html and confirm arrow-key navigation works before delivering' — this would close the feedback loop the 404 warning anticipates.

Trim the explanatory rationale for the 404 issue to one sentence and drop the trailing 'Either way, do not ship...' line since the two recipes already enforce it.

Show one literal before/after rewrite pair (e.g. <link rel="stylesheet" href="../../../assets/base.css"> → <link rel="stylesheet" href="assets/base.css">) to make Recipe A copy-paste ready.

DimensionReasoningScore

Conciseness

The body is dense with non-generic specifics (exact file paths, the '.tpl-xhs-white-editorial' class, theme mechanism) with no padding, but the 404 rationale ("sits three folders deep inside... meaning the deck never activates and slide navigation is dead") and the closing repeat of the warning ("do not ship the upstream ../../../assets/... URLs verbatim") could each be trimmed a sentence or two. This matches anchor 4 (minor instances of over-explanation), not 5, and is well above anchor 3 since nothing explains concepts Claude already knows.

4 / 5

Actionability

Steps are concrete and executable: exact source folder ('design-templates/html-ppt/templates/full-decks/xhs-white-editorial/'), the four named asset files with their project-local rewrite targets, '<link id="theme-link">' with 'T' cycle, and the notes element ('<aside class="notes">'). Falls short of anchor 5 only because no literal before/after <link>/<script> snippet is shown, leaving the exact rewrite to inference.

4 / 5

Workflow Clarity

A clearly numbered 1-6 sequence with sub-recipes, and the one real failure mode (parent-relative asset URLs 404ing after the copy) is pre-empted with two explicit recipes plus a guard. Anchor 4 rather than 5 because there is no explicit verify step (e.g., 'open index.html and confirm slide navigation works') to close the loop; not 3 because the sequence is complete and the main error path is addressed head-on.

4 / 5

Progressive Disclosure

The card correctly delegates all authoring rules to the master skill via clearly signaled one-level links ('[../html-ppt/SKILL.md](../html-ppt/SKILL.md)', 'full-decks catalog'), keeping only template-specific gotchas inline. Scored against the actual bundle structure, no references/scripts/assets exist and every referenced path points outside this bundle, so the targets cannot be verified here — a minor gap that keeps it at anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

53%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 names a specific, well-differentiated deliverable and audience, but it reads as an artifact tagline rather than a capability statement: no explicit actions the skill performs and no 'Use when' trigger guidance. The rubric's completeness cap for missing trigger guidance and thin natural-keyword coverage hold the mid-level scores.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to write a promotion packet, promotion case, or year-end self-review deck for a staff-engineer review.'

State the skill's concrete actions in third person, e.g. 'Structures the packet into scope, proof moments, artifacts, and impact; drafts slides for a manager and calibration-committee audience.'

Include natural synonyms users would actually say — 'promotion case', 'promotion materials', 'self-review', 'year-end review' — to improve trigger term coverage.

DimensionReasoningScore

Specificity

The domain is named precisely ('A staff-engineer promotion packet', 'decision-grade career deck for manager, calibration committee') and its components are listed ('scope, the proof moments, the artifacts, and the impact that clears the bar'), but the only action is the single implicit verb 'Built as' — it describes the artifact's contents rather than what the skill does. This sits between anchor 2 (minimal actions) and anchor 3 (1-2 concrete actions), landing at 3 because the deliverable is concrete; not 4 since no list of specific performed actions exists.

3 / 5

Completeness

The 'what' is present — a decision-grade promotion packet deck with named components — but there is no 'Use when...' clause or any equivalent explicit trigger guidance; the audience mention ('for manager, calibration committee') only weakly implies when. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3, which this description clearly fits.

3 / 5

Trigger Term Quality

It contains some genuinely natural phrases a user might say ('staff-engineer promotion packet', 'career deck', 'promotion'), but misses the common variations users would plausibly use — 'promotion case', 'promotion materials', 'self-review', 'year-end review' — matching anchor 3 (some relevant keywords, missing common variations or synonyms). Not 4: synonym coverage is thin.

3 / 5

Distinctiveness Conflict Risk

The niche is distinct ('staff-engineer promotion packet', calibration committee) and unlikely to trigger for unrelated skills, matching anchor 4 (mostly distinct, minor overlap risk). Not 5: the shared 'career deck'/'portfolio' framing could overlap with sibling career/portfolio deck skills in the same template family.

4 / 5

Total

13

/

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-xhs-white-editorial/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.