skills/digitalsamba__claude-code-video-toolkit

mirror of https://github.com/digitalsamba/claude-code-video-toolkit.git synced 2026-09-18 19:41:13 +08:00

Files

T

Conal Mullan e2e51f914e Update CLAUDE.md skills table and add sync documentation

- Add remotion-official to skills reference table
- Clarify remotion skill now covers toolkit-specific content only
- Add docs/remotion-skills-sync.md explaining the split and sync process

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-27 23:44:29 +00:00

2.3 KiB

Raw Permalink Blame History

Remotion Skills: Official + Toolkit Split

Why Two Skills?

The toolkit maintains two complementary Remotion skills:

Skill	Path	Source	Content
`remotion-official`	`.claude/skills/remotion-official/`	remotion-dev/skills	Core framework knowledge (hooks, animations, rendering, media, etc.)
`remotion`	`.claude/skills/remotion/`	This toolkit	Custom transitions, shared components, project conventions

Before the split, our remotion/SKILL.md duplicated core Remotion documentation that quickly became outdated. The official skill repo is maintained by the Remotion team and stays current with framework releases.

What Lives Where

remotion-official (upstream-managed)

Animation APIs (interpolate, spring, easing)
Composition registration and config
Sequencing (Sequence, Series, Loop, Freeze)
Media components (Video, Audio, Img, OffthreadVideo)
Static files and assets
Input props and async data loading
CLI and programmatic rendering
Lambda deployment
Player component
Captions, charts, 3D, fonts, Tailwind, etc.

remotion (toolkit-managed)

Custom transition library (lib/transitions/)
Shared component catalog (lib/components/)
Toolkit best practices and conventions
Project timing guidelines
Transition duration guidelines

Automatic Sync

A GitHub Actions workflow (.github/workflows/sync-remotion-skills.yml) runs weekly to check for upstream changes:

Clones remotion-dev/skills (shallow)
Compares skills/remotion/ against our .claude/skills/remotion-official/
Opens a PR if files have changed

Manual Sync

To sync manually:

# Clone upstream
git clone --depth 1 https://github.com/remotion-dev/skills.git /tmp/remotion-skills

# Copy into toolkit
rm -rf .claude/skills/remotion-official
cp -r /tmp/remotion-skills/skills/remotion .claude/skills/remotion-official

# Commit
git add .claude/skills/remotion-official
git commit -m "Sync official Remotion skills ($(git -C /tmp/remotion-skills rev-parse --short HEAD))"

Handling Sync PRs

When the automated PR arrives:

Skim the diff for any breaking changes
Check if new rules overlap with our toolkit skill (unlikely but possible)
Merge if everything looks good

2.3 KiB Raw Permalink Blame History