CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

md-slides

Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional HTML-comment `notes:` presenter-notes blocks) into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and `@media print` page-per-slide for PDF export. Triggers when the markdown-html-orchestrator classifies an input as SLIDES, or when invoked directly via /cs-md-slides. Reuses md-document's markdown parser for slide-body rendering and reads design-system tokens via config_loader.py. Refuses if input has no clear slide boundaries, produces a 1-slide deck, or `--strict-notes` is on with under 50% notes coverage. Use after orchestrator routing.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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, actionable skill body: an executable three-command pipeline, explicit refusal/validation rules with exit codes, and clean progressive disclosure to real one-level reference files. The minor gaps are slight verbosity in the forcing-question and 'Distinct from' sections and the absence of an explicit post-render verification step.

DimensionReasoningScore

Conciseness

The body is dense and table-driven with no tutorials on concepts Claude already knows, but a few sections could be trimmed — the canon citations in the forcing-question library ('Canon: Tufte Cognitive Style of PowerPoint') and the 'Distinct from' prose explaining Keynote/PowerPoint. Not 5 because some tokens restate the description and reference rationale that could be cut; above 3 because no section teaches known concepts.

4 / 5

Actionability

Fully executable guidance: the three-step pipeline gives complete copy-paste commands ('python3 markdown-html/skills/md-slides/scripts/slide_splitter.py --input <path>.md --output /tmp/slides.json'), plus exact key bindings, exit codes (5/6/7), and a concrete output artifact pattern with collision suffixing. This matches the anchor for copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

The pipeline is clearly sequenced (numbered steps, ASCII diagram) with validation encoded as refusal exit codes and routing fallbacks ('Otherwise exit 6 — route to md-document'), but there is no explicit post-render verification step (e.g., confirm slide count in deck.html) and no instruction for handling a mid-pipeline failure. Fits anchor 4 — clear sequence with most checkpoints present, minor validation gaps.

4 / 5

Progressive Disclosure

The body is a concise overview with well-signaled one-level-deep references — 'See references/ for full citations (presentation_ux, keyboard_nav_patterns, single_file_deck_conventions)' — and all three files exist, are substantive (72–85 lines), and contain no nested pointers; scripts and the HTML template are correctly kept out of the body. Matches the clear-overview anchor exactly.

5 / 5

Total

18

/

20

Passed

Description

92%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.

A highly specific, third-person description that answers both 'what' and 'when' explicitly and delineates its niche with refusal conditions and routing rules. The only weakness is trigger phrasing that references internal orchestrator routing and a slash command more than natural user-spoken phrases, missing synonyms and file extensions.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage — 'Converts a markdown deck ... into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and @media print page-per-slide for PDF export' — covering input formats, output features, and refusal behaviors in third person. It is not 4 because there are no meaningful coverage gaps in the action list.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' is the full conversion capability list, and the 'when' is concrete — 'Triggers when the markdown-html-orchestrator classifies an input as SLIDES, or when invoked directly via /cs-md-slides ... Use after orchestrator routing.' Not 4 because the 'when' is explicit and concrete rather than weakly implied.

5 / 5

Trigger Term Quality

Natural terms like 'slides', 'deck', 'presentation', 'presenter notes', and 'PDF export' are present, but the trigger guidance leans on internal routing ('Triggers when the markdown-html-orchestrator classifies an input as SLIDES, or when invoked directly via /cs-md-slides') rather than user-spoken phrases, and lacks synonyms like 'slideshow' or 'talk' and file extensions. It exceeds 3 (keyword coverage is good, not partial) but falls short of 5 (not comprehensive natural-term coverage).

4 / 5

Distinctiveness Conflict Risk

It carves a clear deck-conversion niche with explicit refusal boundaries ('Refuses if input has no clear slide boundaries, produces a 1-slide deck, or --strict-notes is on with under 50% notes coverage') that separate it from md-document and similar converters. Not 4 because the refusal conditions and routing rules make overlap risk minimal.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

markdown-html/skills/md-slides/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.