Skip to content

All six sub-skill links in the best-practices hub are dead after npx skills add (install-time rename/rewrite misses them) #24

Description

@echo719

What happens

Installed the pack with the skills CLI:

npx skills add remotion-dev/skills -a claude-code -s '*' -y

In the installed layout, remotion-best-practices/SKILL.md still routes every sub-skill load to <skill>/REFERENCE.md:

$ grep -n "REFERENCE.md" .claude/skills/remotion-best-practices/SKILL.md
10: ...load [Create a new Remotion project](remotion-create/REFERENCE.md)
14: ...load [Remotion Markup Best Practices](remotion-markup/REFERENCE.md)
   (6 link lines total: create, markup, mediabunny, interactivity, render, captions)

…but no REFERENCE.md exists anywhere in the installed layout — the installer renames each sub-skill's REFERENCE.md to SKILL.md. An agent following the hub's routing loads nothing, silently.

Best guess at root cause

The install step also rewrites cross-links: the installed remotion-create/SKILL.md correctly says ../remotion-markup/SKILL.md where the repo source (skills/remotion-best-practices/remotion-create/REFERENCE.md) says ../remotion-markup/REFERENCE.md. So ../-prefixed links get rewritten — the hub's six links are the only prefix-less ones (remotion-create/REFERENCE.md), and they appear to escape the rewrite.

If that rewrite lives in the skills CLI rather than in this repo's packaging, happy to refile there — but a belt-and-braces fix here (making the hub's link paths match the pattern the rewriter catches) would unbreak every existing consumer immediately.

Environment

skills CLI via npx, 2026-07-25, Linux arm64, commit 0dd76fa. Found while writing a side-by-side comparison of this pack vs a community video skill; full write-up with the repro: https://skillstested.com/compare/video-shotcraft-vs-remotion-skills/

PS — smaller and related: the README says "internal package, no documentation", but the repo has 4k+ stars and a first-class skills-CLI install path. Ten lines listing the ten skills and routing to remotion.dev/docs would fix first contact. Can open separately if useful.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions