mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-01 19:42:03 +00:00
* docs(skills): make the core set the default install on every surface A field test showed an agent with a real 'make videos' intent installing all 19 skills: at install time, every surface it could read pointed at the full set, while the core-eager / workflow-on-demand design only exists inside hyperframes/SKILL.md - unreadable until after the install decision. Two traps made full-install the documented default: - The README Quick Start used 'skills add --yes': skills.sh force-detects agent environments into non-interactive mode, and a non-interactive run without --skill installs all 19. Dropping --yes fixes the human path (the picker opens with nothing pre-selected), but not the agent path. - marketplace.json listed the full 'hyperframes' bundle first, under the name an agent installing 'hyperframes' matches; core-skills sat second. Changes, each behavior verified by an isolated run: - README Quick Start drops --yes (humans get the picker; verified via a pty capture that nothing is pre-selected) and points agents and non-interactive runs at 'npx hyperframes skills update', which from a clean HOME installs exactly the 8 core skills, refreshes stale ones and prunes unpublished ones on an existing machine, and is idempotent. - CLAUDE.md and the docs install guide lead with the same one-liner; --all is reworded to explicit-request-only at every surface. - marketplace.json puts core-skills first and both descriptions steer the default choice; the full entry keeps auto-discovery (no allowlist), per the skillsManifest core-pin test (56/56 pass). * docs(skills): close the same install trap in AGENTS.md Review follow-up on the core-default change: AGENTS.md still carried a bare 'npx skills add heygen-com/hyperframes' - no --full-depth, and the same non-interactive-installs-everything trap the README fix closed. AGENTS.md is the first file Codex/Cursor-family agents read for repo intent, so it leaked the full-set default to exactly the readers the core-default policy targets. It now leads with the same core-set one-liner and policy line as CLAUDE.md.