CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hyperframes-cli

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an exemplar of dense, executable CLI guidance: commands by job, a gated write-check-snapshot-preview-render loop with real validation checkpoints, and a symptom→fix failure table. Progressive disclosure is well handled via a command-to-reference table whose targets all exist, docked only for cross-bundle references that don't resolve here.

Suggestions

Make the three cross-skill references (`../hyperframes/references/plugin-installation.md`, `format.md`, `motion.md`) resolve within this bundle, or inline the few sentences they carry so no path leaves the skill directory.

Clarify what to do when the referenced sibling HyperFrames plugin is absent, since the plugin-installation note is the first instruction in the body but unverifiable from this bundle.

DimensionReasoningScore

Conciseness

Lean and dense throughout: command tables, one-line requirements ("It needs Node.js 22+ and FFmpeg"), targeted pitfalls ("never `pgrep -f`, which matches its own loop"), and deprecated aliases quarantined in a single note. Assumes Claude's competence with no concept explanations; every token earns its place.

5 / 5

Actionability

Fully executable, copy-paste-ready commands everywhere: `npx hyperframes check --json`, `render --quality looks --output out.mp4`, `timeline apply plan.json --json`, and a concrete wait loop `until grep -qE 'Render (complete|failed)' render.log; do sleep 5; done`. Specific examples cover the common cases, including failure recovery commands.

5 / 5

Workflow Clarity

"The loop" is a clearly sequenced 5-step process with explicit validation checkpoints: lint after structural changes, `check --json` as the gate, reading snapshot PNGs, confirming the preview URL answers 200, and verifying the render is non-empty with `ffprobe` duration matching `data-duration`. Error recovery is strong: a symptom→fix table, `--plan` previews, edit receipts, and `timeline undo`/`history undo` feedback loops.

5 / 5

Progressive Disclosure

Good structure: the body is a concise overview and the "Read the row before running its command" table maps commands to all 12 real, one-level-deep `references/*.md` files, all of which exist. Not 5 because three referenced paths (`../hyperframes/references/plugin-installation.md`, `format.md`, `motion.md`) point outside this bundle and do not resolve in the actual file structure, leaving minor navigation gaps.

4 / 5

Total

19

/

20

Passed

Description

75%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 is specific, action-dense, and clearly anchored to a named product niche, giving it low conflict risk. Its main weakness is the missing "when to use" trigger clause, which caps completeness and leaves invocation guidance implicit. Adding a "Use when..." sentence with natural trigger phrases and file extensions would lift it to top marks.

Suggestions

Add an explicit trigger clause, e.g. "Use when working in a HyperFrames video project — creating, editing, rendering, or publishing it."

Include natural synonyms and artifacts users would mention, such as "video", "animation", or ".mp4 output", to strengthen trigger-term coverage.

State the artifact that identifies a project (e.g., a .hyperframes directory) so the skill triggers unambiguously when one is present.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history" plus "reading its JSON and recovering from build or render failures" — covering the full project lifecycle comprehensively. Not 4 because there are no meaningful coverage gaps; the actions span start-to-ship plus failure recovery.

5 / 5

Completeness

The "what" is explicit and concrete (scaffold, check, render, publish, history, failure recovery), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guideline. Not 4 because the "when" is entirely absent rather than merely implicit-but-present.

3 / 5

Trigger Term Quality

Contains natural terms a user of this tool would say ("scaffold", "edit the timeline", "render", "publish", "preview") with good coverage. Not 5 because it lacks synonyms and file extensions (e.g., video, animation, .mp4); not 3 because the keyword set is relevant and natural rather than missing common variations.

4 / 5

Distinctiveness Conflict Risk

"The HyperFrames CLI" names a specific product with a clear niche; its triggers (render, timeline, publish in the HyperFrames context) are distinct and unlikely to fire for unrelated skills. Not 4 because no overlap risk with closely related skills is identifiable.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

heygen-com/hyperframes

Path

skills/hyperframes-cli/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.