slideshow

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

81%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 highly actionable, well-sequenced authoring contract with executable schema, a worked example, and explicit validation feedback loops. Its main weakness is length and redundancy in the media/mute and standalone-interim sections, which dilute token efficiency and keep some inlinable detail in the main file.

Suggestions

Consolidate the repeated cross-realm iframe mute/pause rule into one canonical statement and reference it, instead of restating it in both Media cleanup and Global nav mute.

Extract the dense porting-source-pages rules into a references file (e.g. references/porting.md) and keep a concise summary plus pointer in the main body.

Trim the standalone 'interim' section's hedging about the not-yet-shipped engine-hosted path to a single sentence.

Dimension	Reasoning	Score
Conciseness	The body is information-dense and avoids explaining concepts Claude already knows, but at ~520 lines it carries notable redundancy — the iframe cross-realm/mute rule is restated across Media cleanup and Global nav mute, and the standalone 'interim' section hedges heavily ('durable answer... coming').	3 / 5
Actionability	Provides copy-paste-ready, executable guidance: the full JSON island schema, a complete worked HTML deck example, exact commands ('npx hyperframes lint', 'npx hyperframes present', 'bun run build'), and explicit lint rules covering the common cases.	5 / 5
Workflow Clarity	Sequences the full authoring process (intent confirmation → scenes → island → slides → fragments → branching → validation) with explicit validation checkpoints and a fix-and-rerun feedback loop ('Fix the file and rerun until lint reports 0 error(s)').	5 / 5
Progressive Disclosure	One real, clearly signaled one-level-deep reference (skills/slideshow/references/standalone-harness.md) offloads the standalone bridge patterns, and the main body is well sectioned; however only a single reference exists and substantial detail (porting rules, media-cleanup, mute semantics) is inlined that could live in references.	4 / 5
	Total	17 / 20 Passed

Description

91%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 specific, well-triggered description that names concrete capabilities and natural user terms while carving out a distinct niche. The 'when' guidance is present and explicit but framed as a confirmation gate rather than a tidy 'Use when...' clause.

Suggestions

Add a concise 'Use when the user asks for a presentation, pitch deck, or interactive deck (or to convert a page into one)' clause to make the trigger fully explicit.

Surface the natural trigger terms earlier in the first sentence rather than embedding them mid-description.

Dimension	Reasoning	Score
Specificity	Names multiple concrete capabilities — 'fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes' plus 'converts an existing page into a deck' — giving comprehensive coverage of what the skill does.	5 / 5
Completeness	Clearly states what the skill authors and gives explicit 'when' guidance ('If the user didn't explicitly ask for a slideshow, confirm before authoring'), but the 'when' is framed as a confirmation gate rather than a clean 'Use when...' trigger list, leaving it slightly less explicit than the 5 anchor.	4 / 5
Trigger Term Quality	Covers the natural terms a user would say — 'presentation', 'pitch deck', 'interactive deck', 'slideshow' — alongside the source-page conversion phrasing, giving broad synonym coverage.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (HyperFrames navigable deck, explicitly 'not a rendered MP4') with distinct triggers, minimizing overlap with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (531 lines); consider splitting into references/ and linking	Warning
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	14 / 16 Passed

Repository: heygen-com/hyperframes
Path: skills/slideshow/SKILL.md
Commit: 0f8eb89

Reviewed: 6 days ago

Table of Contents

Discovery Implementation Validation

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.