Skip to content

refactor: remove custom skill install, delegate to vercel-labs/skills - #188

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

refactor: remove custom skill install, delegate to vercel-labs/skills#188
vanceingalls wants to merge 7 commits into
feature/caption-designerfrom
vance/skill-system-cleanup

Conversation

@vanceingalls

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 tsx packages/cli/src/cli.ts skills → "Unknown command skills"
  • npx tsx packages/cli/src/cli.ts 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 and others added 7 commits April 1, 2026 21:10
The single-quote replacement regex ran after key-quoting, causing it
to match apostrophes inside already-double-quoted strings like
"didn't". Moving it before key-quoting fixes the issue since it only
matches actual single-quoted string values at that point.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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>
@vanceingalls

Copy link
Copy Markdown
Collaborator Author

Resubmitting via Graphite stack

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