Skip to content

Open-source design agent: on-brand stills, decks, diagrams, charts and motion graphics from a chat thread, built on Deep Agents.

2.2 KB
Raw Blame

Skill installation and freshness

Read this reference when installing or updating skills, diagnosing unexpected workflow behavior, or running HyperFrames setup in CI.

For a plugin installation, follow plugin execution rules; the plugin manager owns updates and all workflows are bundled. The commands below apply only to standalone skills.

HyperFrames installs the core set eagerly and workflow skills lazily.

  • Core set: /hyperframes, the hyperframes-* domain skills, and /media-use.
  • Workflow skills: installed when routing selects them through npx hyperframes skills update <workflow-name>.

What init does

npx hyperframes init checks GitHub and refreshes the core set plus other skills already installed. It does not install workflows that have never been used. A current install is a no-op. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.

The --skip-skills CLI flag is temporarily ignored. CI and tests may opt out with HYPERFRAMES_SKIP_SKILLS=1.

HYPERFRAMES_SKIP_SKILLS=1 also makes skills update (bare or named) and bare skills exit 0 without installing or pruning, so an install pinned to one commit stays pinned.

Diagnose and update

npx hyperframes skills check
npx hyperframes skills check --json
npx hyperframes skills update
npx hyperframes skills update <workflow-name>
npx hyperframes skills
  • skills check exits non-zero when an installed skill is stale or the core set is incomplete. Workflows available on demand but not installed are not failures.
  • Bare skills update refreshes the core set and everything already installed, prunes unpublished skills, and does not expand the workflow set.
  • Named skills update <name...> also installs those named workflows or domain skills.
  • Bare skills installs the full published set explicitly.

If the HyperFrames CLI is unavailable, use npx skills add heygen-com/hyperframes --skill <workflow-name> for one workflow or npx skills add heygen-com/hyperframes --all for the full published set.

The CLI may print a one-line stale-skill reminder during render, lint, or check. Treat a failed update as a visible tool failure; do not continue from a remembered workflow contract.