cycle-atlas/.agents/skills/hyperframes/references/skill-lifecycle.md

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.

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.