35 lines
2.1 KiB
Markdown
35 lines
2.1 KiB
Markdown
|
# 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](plugin-installation.md); 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
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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.
|