Repository navigation
docs(skills): explain update names and local YAML repair - #7196
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
![heygengenesis[bot]](https://avatars.githubusercontent.com/in/2913576?s=60&v=4){kind=small}
There was a problem hiding this comment.
Verdict: APPROVE · 0 blocker · 0 important · 0 nits · head e048240
Scope
Read docs/guides/skills.mdx in full. Checked each claim against the source at this head. npx hyperframes skills update refreshes the core set plus the skills already installed (updateSkills({ refreshInstalled: true }) in packages/cli/src/commands/skills.ts). seam-craft is metadata.internal: true under .claude/skills and .agents/skills, so it is not in the published skills/ set, and its current frontmatter parses. The skills@1.7.6 update --help output confirms that update [skills...] takes skill names and accepts -g. CI, Docs, and CodeQL are green on this head; one superseded PR-captures run was cancelled, and its rerun passed.
Ports: heygen-com#7165 (font preflight and system TTC names), heygen-com#7166 (font shorthand var(), weight-suffixed names, linked font sheets), heygen-com#7168 (render lock and --wait, effect-scan/session watchdog without the heygen-com#7104 retry, font_face_local_only lint), heygen-com#6972, heygen-com#7183 (adapted), heygen-com#7184; docs heygen-com#7132, heygen-com#7196; prerequisites heygen-com#6665, heygen-com#6697, heygen-com#6716 (cache-dir helper only). Deferred heygen-com#7182, heygen-com#7176. Package size budgets follow upstream's heygen-com#7168 increments. Watermarks: commit 15b1de4, PR 7189; monitored 92. Co-authored-by: Miguel Ángel <miguel.sierra@heygen.com> Co-authored-by: WaterrrForever <miao.yang@heygen.com> Co-authored-by: Ular Kimsanov <ularkimsanov7@gmail.com> Co-authored-by: James Russo <james.russo@heygen.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
What
Explain recovery from two independent skill-update errors:
No installed skills found matching: heygen-com/hyperframesand a YAML parse warning naming an installedSKILL.md.Why
skills@1.7.6treats update arguments as installed skill names, so passing the repository never selects the installed HyperFrames skills. A stale, separately installedseam-craftcopy also had unindented description continuation lines. The current shared skill source already parses correctly; that local repair does not require a source change.Related work
Self-contained documentation correction following a reproduced local installation failure. No runtime changes or additional install behavior.
How
Document
npx hyperframes skills updatefor the managed global set, the standalone updater's skill-name syntax, and a folded YAML description example. Tell readers to back up the named installed file and preserve its wording/body. Clarify that refreshing published core skills does not repair a separately installed internal skill.Test plan
skills@1.7.6CLI. After the local YAML repair,skills list --globaldiscoversseam-craftwithout parse warnings; the incorrect repository-name update still reports no match, confirming the independent causes.mint broken-links: no broken links.mint validate: build validation passed.git diff --checkand normal commit hooks passed.