github-repo-promo
Generate 1080x1920 Instagram Reels video promos for GitHub repositories using HyperFrames. 7-beat structure with fullscreen scrolling phone mockup, GSAP animations, dark GitHub theme, repo stats, ElevenLabs AI voiceover synced to scroll duration, and follow CTA. Depends on the website-to-hyperframes skill for HyperFrames composition patterns.
Profile →npx skills add cosmicstack-labs/mercury-agent-skills --skill github-repo-promo --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# GitHub Repo Promo Video > **Depends on:** [website-to-hyperframes](https://github.com/heygen-com/hyperframes/blob/main/skills/website-to-hyperframes/SKILL.md) — load it before starting. Its 6-step workflow (capture → brand → brief → storyboard → build → validate) and all reference files apply here. This skill specializes that workflow for GitHub repository promos. --- ## Core Decisions | Decision | Value | Why | |----------|-------|-----| | **Dimensions** | **1080x1920** (Instagram Reels) | Instagram Reels is the primary distribution format. Landscape is secondary. | | **Phone mockup viewport** | **Full-screen of available viewport** | The phone mockup fills the entire 1080x1920 canvas — no letterboxing, no sidebars. The scrolling screenshot occupies every pixel. | | **Narration priority** | **Narration drives timing** | Beat durations are computed FROM the narration audio, not the other way around. The narrator always knows the scroll state. | | **Output folder** | `github-promos/<repo-name>/` | All promo projects live under a parent `github-promos/` directory for organization. | | **Follow CTA** | `@githubprojects` (or user-specified) | Final beat shows "Follow @githubprojects
- Core Decisions
- Directory Structure
- Workflow
- Step 0: Capture Repo Info
- Step 1: Brand Identity
- Step 2: Strategy & Brief 💬
- Step 3: Storyboard + Script 💬
- Step 4: Voiceover Generation 💬
- Step 5: Build Compositions
- Step 6: Validate & Deliver
- Seven Beats — Detailed Specifications
- Beat 1: Hero (0s → ~4s)
- Beat 2: Fullscreen Scrollable Phone (~4s → ~15s)
- Beat 3: Stats (~15s → ~19s)
sips -g pixelHeight github-promos/{repo}/assets/repo-page.png
sips -g pixelWidth github-promos/{repo}/assets/repo-page.png
curl -s -X POST "https://api.elevenlabs.io/v1/text-to-speech/AZnzlk1XvdvUeBnXmlld" \
cd github-promos/{repo}
npx hyperframes lint
npx hyperframes validate
npx hyperframes snapshot
npx hyperframes render --quality draft
npx hyperframes render --quality standardWhat does the github-repo-promo skill do?
Generate 1080x1920 Instagram Reels video promos for GitHub repositories using HyperFrames. 7-beat structure with fullscreen scrolling phone mockup, GSAP animations, dark GitHub theme, repo stats, ElevenLabs AI voiceover synced to scroll duration, and follow CTA. Depends on the website-to-hyperframes skill for HyperFrames composition patterns.
How do I install it?
Run `npx skills add cosmicstack-labs/mercury-agent-skills --skill github-repo-promo --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From cosmicstack-labs/mercury-agent-skills, a repository with 364 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.