diff --git a/docs/guides/skills.mdx b/docs/guides/skills.mdx index d97f64e93b..0714f26ecd 100644 --- a/docs/guides/skills.mdx +++ b/docs/guides/skills.mdx @@ -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)