Skip to content

refactor(cli): remove custom skill install, delegate to vercel-labs/skills - #189

Closed
vanceingalls wants to merge 7 commits into
feature/caption-designerfrom
vance/skill-system-cleanup
Closed

vanceingalls wants to merge 7 commits into
feature/caption-designerfrom
vance/skill-system-cleanup

Conversation

@vanceingalls

@vanceingalls vanceingalls commented Apr 2, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Delete install-skills.ts (~485 lines) — custom skill installation wrapper and git fallback removed entirely
  • Strip skill logic from init — no more project-level .claude/skills/ copies, no --skip-skills flag; replaced with post-scaffold message: npx skills add heygen-com/hyperframes
  • Front-load SKILL.md trigger words — all 5 skill descriptions rewritten so activation language comes first (~150 chars), improving Claude Code's skill discovery
  • Update CLAUDE.md — install instructions now point to vercel-labs/skills
  • Fix .claude/settings.json — pre-commit hook changed from pnpm to bun (matching actual workspace tooling)

Why

Reviewed the skill system against agentic harness patterns and found:

  • Staleness: project-level skill copies diverged from source with no sync mechanism
  • Deduplication: legacy skill names coexisted with current names
  • Listing budget: trigger words buried at end of descriptions, truncated by Claude Code
  • Unnecessary code: install-skills.ts was a thin wrapper around npx skills add

Delegating to the upstream skills CLI eliminates all four issues.

Test plan

  • npx hyperframes skills → "Unknown command skills"
  • npx hyperframes init test --template blank --non-interactive --skip-transcribe → prints npx skills add heygen-com/hyperframes in post-scaffold output
  • grep -r "install-skills" packages/cli/src/ → no results
  • All 5 skills/*/SKILL.md have front-loaded descriptions

🤖 Generated with Claude Code

vanceingalls commented Apr 2, 2026 •

Copy link
Copy Markdown
Collaborator Author

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

This stack of pull requests is managed by Graphite. Learn more about stacking.

@vanceingalls vanceingalls changed the title docs: add skill system cleanup design spec refactor(cli): remove custom skill install, delegate to vercel-labs/skills Apr 2, 2026
vanceingalls and others added 7 commits April 1, 2026 23:37
Remove custom skill installation from the CLI in favor of
vercel-labs/skills. Fixes staleness, deduplication, listing budget,
and completeness issues identified by agentic harness pattern review.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
6 tasks: delete install-skills, strip skills from init, front-load
SKILL.md descriptions, update CLAUDE.md, clean up my-video copies.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove installSkills(), getBundledSkillsDir(), project-level skill copying,
and the --skip-skills flag. Replace post-scaffold messaging with directions
to run `npx skills add heygen-com/hyperframes`.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Also fix .claude/settings.json pre-commit hook to use bun instead of pnpm.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vanceingalls
vanceingalls force-pushed the vance/skill-system-cleanup branch from 3184ed1 to cf7e782 Compare April 2, 2026 06:38
@vanceingalls
vanceingalls force-pushed the feature/caption-designer branch from 43d2277 to d3b3157 Compare April 2, 2026 06:38
@vanceingalls

Copy link
Copy Markdown
Collaborator Author

Folded into #177 (vance/skills-agent-support)

vanceingalls added a commit that referenced this pull request Apr 2, 2026
…vercel-labs/skills (#177)

## Summary

**Skill install targets (original):**
- Add project-level skill install targets: Windsurf, Cline, Roo Code, Trae (opt-in via flag)
- Split install logic into global vs project-level
- Fix lint false positive: timed tags with `data-composition-id` no longer flagged by media rule

**Skill system cleanup (folded from #189):**
- Delete `install-skills.ts` (~485 lines) — remove custom installation wrapper entirely
- Strip skill logic from `init` — no more project-level `.claude/skills/` copies, no `--skip-skills` flag; replaced with post-scaffold message: `npx skills add heygen-com/hyperframes`
- Front-load SKILL.md trigger words — all 5 skill descriptions rewritten so activation language comes first (~150 chars)
- Update CLAUDE.md — install instructions now point to [vercel-labs/skills](https://github.com/vercel-labs/skills)
- Fix `.claude/settings.json` — pre-commit hook changed from `pnpm` to `bun`

## Test plan

- [ ] `npx hyperframes skills` → "Unknown command skills"
- [ ] `npx hyperframes init test --template blank --non-interactive --skip-transcribe` → prints `npx skills add heygen-com/hyperframes`
- [ ] `grep -r "install-skills" packages/cli/src/` → no results
- [ ] All 5 `skills/*/SKILL.md` have front-loaded descriptions

🤖 Generated with [Claude Code](https://claude.com/claude-code)
dahans-msft2 pushed a commit to dahans-msft2/hyperframes that referenced this pull request Aug 6, 2026
…vercel-labs/skills (heygen-com#177)

## Summary

**Skill install targets (original):**
- Add project-level skill install targets: Windsurf, Cline, Roo Code, Trae (opt-in via flag)
- Split install logic into global vs project-level
- Fix lint false positive: timed tags with `data-composition-id` no longer flagged by media rule

**Skill system cleanup (folded from heygen-com#189):**
- Delete `install-skills.ts` (~485 lines) — remove custom installation wrapper entirely
- Strip skill logic from `init` — no more project-level `.claude/skills/` copies, no `--skip-skills` flag; replaced with post-scaffold message: `npx skills add heygen-com/hyperframes`
- Front-load SKILL.md trigger words — all 5 skill descriptions rewritten so activation language comes first (~150 chars)
- Update CLAUDE.md — install instructions now point to [vercel-labs/skills](https://github.com/vercel-labs/skills)
- Fix `.claude/settings.json` — pre-commit hook changed from `pnpm` to `bun`

## Test plan

- [ ] `npx hyperframes skills` → "Unknown command skills"
- [ ] `npx hyperframes init test --template blank --non-interactive --skip-transcribe` → prints `npx skills add heygen-com/hyperframes`
- [ ] `grep -r "install-skills" packages/cli/src/` → no results
- [ ] All 5 `skills/*/SKILL.md` have front-loaded descriptions

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant