feat(short-video): port generate-music-video workflow from docs to a skill

[sidneyswift]

Summary

Ports the short-form-music-video pipeline from the docs site (/workflows/generate-music-video on developers.recoupable.com) into a proper SKILL.md. Any agent that's installed recoupable/skills can now find and follow this from disk instead of fetching the workflow page as markdown at request time.

Same content, two delivery modes:

• Skill (now): installed locally via npx skills add recoupable/skills, loaded when the description trigger matches.
• Workflow (deprecated once this lands): docs page at a fetchable URL.

What's in the skill

Two execution paths, agent picks based on shell environment:

1. Async pipeline (POST /api/content/create + poll /api/tasks/runs) — for short-shell agents (Claude Cowork, OpenAI tool calls) that can't wait 60–180s on a synchronous POST /api/content/video. Survives session restarts.
2. Manual walkthrough (template → image → video → caption → ffmpeg compose) — for humans or when you want to swap a single stage.

Plus a section on resolving $ARTIST_ACCOUNT_ID and a "Where the song lives" fallback chain for sourcing audio (sandbox repo first, then ask the user — never fall back to a placeholder).

Frontmatter trigger description

Optimized for the agent loader. Catches phrases like:

• "make a video"
• "generate content for"
• "create a TikTok"
• "produce a music-video clip"
• "short-form video"
• "music video for X"

Tested with

npx skills add 'https://github.com/recoupable/skills.git#feat/short-video-skill' --list
# expect: short-video appears in the list

npx skills add 'https://github.com/recoupable/skills.git#feat/short-video-skill' --skill short-video --copy
# expect: skills/short-video/SKILL.md lands at .agents/skills/short-video/SKILL.md

After merge

Follow-up docs PR (recoupable/docs#189) deletes /workflows/generate-music-video.mdx in favor of this skill, addresses sweetmantech's "delete workflows in favor of skills" review thread.

Coordination with PR #23 (unified marketplace)

This skill is independent of #23. When #23 merges, it'll need to add a short-video entry to marketplace.source.json — straightforward, no conflict expected. Happy to do that as a follow-up commit on either branch, whichever merges first.

---

Summary by cubic

Ports the short-form music-video workflow from the docs into a first-class skill so agents can run it from disk without fetching at request time. Adds a short-video skill with an async API pipeline and a manual 5-step recipe for human overrides.

• New Features

  • Adds skills/short-video/SKILL.md to generate a 9:16 music video from an artist and song.
  • Async path: POST /api/content/create + poll GET /api/tasks/runs for short-shell agents; survives session restarts.
  • Manual path: template → image → video → caption → local ffmpeg compose; optional upscaling and caption styling included.
  • Frontmatter trigger phrases catch “make a video”, “create a TikTok”, “short-form video”, etc.
  • Includes guidance for resolving $ARTIST_ACCOUNT_ID and fetching audio from the artist’s sandbox repo; never uses placeholder tracks.

• Migration

  • Install via npx skills add recoupable/skills and load the short-video skill by trigger.
  • Stop fetching /workflows/generate-music-video from docs; this skill replaces it.
  • After the unified marketplace lands, add short-video to marketplace.source.json (no breaking changes).

^{Written for commit 436db38. Summary will update on new commits.}

[coderabbitai]

Warning

Rate limit exceeded

@sidneyswift has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 3 minutes and 21 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2f3da0ea-6862-4b99-83c1-7029eb64880e

📥 Commits

Reviewing files that changed from the base of the PR and between 7993be6 and 436db38.

📒 Files selected for processing (1)

• skills/short-video/SKILL.md

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/short-video-skill

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}