CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

presentation-structure

Knowledge about the presentation slide format, weight system, navigation, and section structure

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 ./.claude/skills/presentation/presentation-structure/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.

This is a strong, focused reference skill: concrete HTML patterns, exact slide-range and bar-height tables, and a correct renumbering procedure with a verification step. Its weaknesses are minor — duplicated examples, a verification step lacking a concrete mechanism — and it contains no fluff or over-explanation.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no HTML tutorializing, no explanation of what a div or attribute is), with concrete tables and code earning their tokens. It falls short of a 5 due to redundancy: the data-level section-slide example appears twice (Slide Format and Section Divider Format) and the level-badge injection rule is stated twice ('A .level-badge is JS-injected... do NOT hardcode' at the top and again at the end).

4 / 5

Actionability

Guidance is concrete and executable: real HTML snippets for all three slide types, an exact slide-range/data-level/bar-height table, concrete fill percentages (25/50/75/100), and a numbered renumbering procedure. Below a 5 because a few specifics lack a method — 'Verify no gaps or duplicates exist' gives no concrete command (e.g., a grep) and no example of a TOC goToSlide() call to update.

4 / 5

Workflow Clarity

The renumbering workflow is a clear 4-step sequence that includes a checkpoint ('Verify no gaps or duplicates exist') and correctly notes that totalSlides auto-computes, preventing a common manual-update error. It does not reach 5 because the batch renumbering operation has no concrete validation mechanism or error-recovery loop (what to do if a duplicate is found); a validation command or explicit check procedure would close the gap.

4 / 5

Progressive Disclosure

No bundle directories (references/, scripts/, assets/) exist, and none are needed — the skill is a single self-contained reference. Sections are well-organized with headers, two tables, and code blocks that make specific facts (transition rules, navigation API) easy to locate. It misses the 5 (reserved for well-signaled one-level-deep references or a sub-50-line body) only because it is ~85 lines and slightly redundant, which makes it marginally longer than necessary for inlined content.

4 / 5

Total

16

/

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 correctly identifies the domain and its subtopics but is written as a passive topic list with no trigger guidance and no action verbs. It is mediocre across all dimensions: specific enough to not be fluff, but without a 'Use when...' clause, natural synonyms, or distinctive triggers it would not reliably fire for the right task.

Suggestions

Add an explicit trigger clause, e.g., 'Use when editing, renumbering, or adding slides to the presentation at presentation/index.html'.

Replace the passive 'Knowledge about...' framing with concrete third-person actions ('Documents the slide HTML format... Explains the level/journey-bar system...') so the 'what' reads as capabilities, not topics.

Include natural user-facing synonyms and specifics — 'slide layout', 'journey bar / progress bar', 'goToSlide', 'section dividers' — and rename the misleading 'weight system' to match the body's 'level system'.

DimensionReasoningScore

Specificity

The description names the domain plus several concrete facets ("presentation slide format, weight system, navigation, and section structure"), but frames everything as "Knowledge about" — a noun phrase with no concrete actions, matching the 'names domain and some specifics but not comprehensive as actions' level. It is above anchor 2 ('Processes PDF files' is far sparser) but below anchor 4, which requires several specific actions rather than topic labels.

3 / 5

Completeness

The 'what' is reasonably clear (knowledge of slide format, level/weight system, navigation, section structure) but there is no 'when' at all — no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. It does not fall to anchor 2 because the 'what' is concrete, and cannot reach 4 without any explicit 'when'.

3 / 5

Trigger Term Quality

Reasonable natural keywords are present ("presentation", "slide", "navigation", "section"), but common synonyms a user would actually say ("deck", "slide layout", "progress bar", "journey bar") are missing, and "weight system" is internal jargon that a user would not naturally say. This matches anchor 3: some relevant keywords but missing common variations.

3 / 5

Distinctiveness Conflict Risk

"Presentation slide format" carves out a niche, but the description could plausibly overlap with generic presentation-authoring skills (e.g., .pptx skills), and "weight system" is ambiguous (suggests numeric weighting rather than the level system the body actually documents). Somewhat specific but still overlap risk with closely related presentation skills — anchor 3.

3 / 5

Total

12

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

shanraisshan/claude-code-best-practice

Path

.claude/skills/presentation/presentation-structure/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.