CtrlK
BlogDocsLog inGet started
Tessl Logo

presentation-structure

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

55

Quality

61%

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

72%

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 well-structured, actionable reference with concrete HTML and named APIs, and it appropriately stays self-contained without unnecessary file splitting. Its main weaknesses are minor cross-section redundancy and an only-implicit feedback loop in the renumbering workflow.

Suggestions

Remove the duplicated .level-badge note and the repeated data-level="low" HTML block by stating the rule once and cross-referencing it from the other section.

Make the renumbering feedback loop explicit, e.g. 'If gaps or duplicates are found, renumber the affected data-slide values sequentially and re-verify before updating goToSlide() calls.'

DimensionReasoningScore

Conciseness

The body is mostly lean and assumes Claude's competence, but the .level-badge JS-injection note is stated twice (Journey Bar Level System and Section Divider Format) and the data-level="low" section-divider HTML block is repeated across two sections, so it could be tightened.

2 / 3

Actionability

It provides concrete, copy-paste-ready HTML examples, specific attribute names (data-slide, data-level), and named JS functions (goToSlide(n), querySelectorAll), giving fully executable guidance rather than vague direction.

3 / 3

Workflow Clarity

The Renumbering Rules give a clear 4-step sequence with a validation checkpoint ('Verify no gaps or duplicates exist'), but for a batch HTML-editing operation the error-recovery feedback loop (what to do when gaps/duplicates are found) is only implicit rather than explicit.

2 / 3

Progressive Disclosure

The content is organized into clearly headed sections (File Location, Slide Format, Journey Bar, Navigation, Renumbering, Section Dividers) with no nested references and no wall of text; as a cohesive single-presentation reference it does not benefit from file splitting.

3 / 3

Total

10

/

12

Passed

Description

50%

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 identifies a clear, specific domain and enumerates concrete facets of it, but it is framed as passive 'knowledge about' rather than actions and entirely lacks a 'Use when...' trigger clause. All four dimensions land at the midpoint as a result.

Suggestions

Rewrite in third-person active voice listing concrete actions, e.g. 'Renumbers data-slide attributes, updates goToSlide() calls, and sets journey-bar levels when editing the presentation.'

Add an explicit trigger clause such as 'Use when adding, removing, reordering, or re-leveling slides in presentation/index.html.'

Replace the internal jargon 'weight system' with user-natural terms like 'journey bar levels' or 'slide levels'.

DimensionReasoningScore

Specificity

The description names a specific domain plus four concrete facets ("presentation slide format, weight system, navigation, and section structure") but uses no action verbs, so it is more specific than a vague 'Helps with documents' yet stops short of listing concrete actions.

2 / 3

Completeness

It answers 'what' (knowledge about the presentation's structure) but provides no 'Use when...' clause or equivalent trigger guidance, so completeness is capped at 2 per the judging guidelines.

2 / 3

Trigger Term Quality

It includes some natural terms a user would say ("presentation", "slide format", "section structure") but mixes in internal jargon ("weight system") and omits common variations like 'slides' or '.pptx'.

2 / 3

Distinctiveness Conflict Risk

The niche (one presentation's slide/weight/navigation structure) is fairly specific, but the absence of explicit triggers means it could still overlap with a general presentation-editing skill.

2 / 3

Total

8

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
shanraisshan/claude-code-best-practice
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.