mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 07:50:13 +00:00
docs(skills): explain update names and local YAML repair (#7196)
This commit is contained in:
@@ -167,6 +167,47 @@ Use the full set for an environment that must work across many HyperFrames tasks
|
||||
The individual skill definitions remain the source of truth for agents and are
|
||||
available in the [HyperFrames repository](https://github.com/heygen-com/hyperframes/tree/main/skills).
|
||||
|
||||
## If an update says no installed skills match
|
||||
|
||||
With `skills@1.7.x`, `npx skills update heygen-com/hyperframes` treats
|
||||
`heygen-com/hyperframes` as an installed skill name. It reports
|
||||
`No installed skills found matching` even when HyperFrames skills are installed.
|
||||
Use the HyperFrames updater to refresh the core set and the HyperFrames skills
|
||||
already installed globally:
|
||||
|
||||
```bash
|
||||
npx hyperframes skills update
|
||||
```
|
||||
|
||||
The standalone `skills update` command accepts skill names, such as
|
||||
`npx skills update hyperframes -g` to update only the global `/hyperframes` skill.
|
||||
The repository name belongs in `skills add`, as shown in the install steps above.
|
||||
|
||||
## If an installed skill has a YAML parse error
|
||||
|
||||
A `Skipped .../SKILL.md — YAML parse error` warning names the installed file that
|
||||
cannot be read. Back up that file before editing it, especially if it contains
|
||||
custom instructions. A multiline description needs indented continuation lines;
|
||||
for example:
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: seam-craft
|
||||
description: >-
|
||||
Render-correctness doctrine for scene-to-scene seams.
|
||||
Load when assembling the master timeline.
|
||||
---
|
||||
```
|
||||
|
||||
Keep the file's existing description text and skill body; the example shows only
|
||||
the YAML format. Run `npx skills list -g` afterwards to verify global discovery,
|
||||
or `npx skills list` for a project install.
|
||||
|
||||
Repo-internal skills such as `seam-craft` are excluded from the published set.
|
||||
Refreshing the core skills does not repair an old, separately installed copy of
|
||||
an internal skill. A YAML warning and a name-matching error can occur in the same
|
||||
run and need these separate fixes.
|
||||
|
||||
## Related topics
|
||||
|
||||
- [Make your first video](/quickstart)
|
||||
|
||||
Reference in New Issue
Block a user