docs(skills): explain update names and local YAML repair (#7196)

This commit is contained in:
James Russo
2026-11-05 01:01:31 +00:00
committed by GitHub
parent a6e6717f2a
commit bd6cff8157
+41
View File
@@ -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)