AGENTS.md git:20261106.f977c6fA

Immutable. This exact content never changes and is served at /api/v1/blob/7d52a57518e33e37.

# AGENTS.md

vargHQ/skills is a library of Agent Skills for AI video, image, voice and music. Each top-level folder with a `SKILL.md` is one skill.

## Use a skill

1. Find the person's task in the index below (or in [catalog.json](catalog.json)). If nothing fits, search the keyless varg how to MCP (`https://api.varg.ai/v2/skills/mcp`: `search_how_to`, then `get_how_to`) or read [`how-to-make-ai-video/SKILL.md`](how-to-make-ai-video/SKILL.md).
2. Read `<skill>/SKILL.md` before anything else. It lists the inputs to ask for, the choices to put to the person, the steps, the prompts and the checks. Load its `references/` only when the SKILL.md points there.
3. Ask the two to four choices the skill names, in the person's language, before spending anything.
4. Skills that generate spend varg credits (1 credit = $0.01, provider price). Approve stills before video, call `estimate_cost` before a batch, a long video or a render, and wait for the person's yes. Never clear a cache.
5. Check the output the way the skill says (frames, loudness, text in the safe zone, faces and product unchanged) before handing over files.

Generate with the varg MCP (`https://mcp.varg.ai/mcp`, OAuth) or `VARG_API_KEY` against `https://api.varg.ai/v2`. Current model ids, inputs and limits: https://varg.ai/models/llms.txt.

<!-- index:start -->
## Which skill for which task (73 skills)

| The person wants | Install and read first | Then | Guide |
|---|---|---|---|
| AI UGC ads: Turn a product photo into a phone-real UGC ad: an AI creator holds your real product, the label stays exact and the script stays FTC-safe. | `ai-ugc-ad-video` | `product-video-hooks`, `video-script`, `varg-product-lock`, `caption-styles`, `social-overlays`, `ai-ad-compliance-check` | [how-to/make-ai-ugc-ads](how-to/make-ai-ugc-ads/README.md) |
| AI music video: Turn your song into a beat-synced AI music video: measured beat grid, approved stills, Seedance shots, lip sync and lyrics drawn in code. | `varg-music-video` | `kinetic-type-art`, `caption-styles`, `motion-formats`, `kling-4-keyframe-film`, `media-judge` | [how-to/make-an-ai-music-video](how-to/make-an-ai-music-video/README.md) |
| Lyric video: Turn a song and its lyrics into a lyric video with every word on the vocal: free kinetic type in code, or lyrics over AI footage. | `motion-formats` | `kinetic-type-art`, `caption-styles`, `varg-music-video` | [how-to/make-a-lyric-video](how-to/make-a-lyric-video/README.md) |
| Agent video editing: Turn raw talking-head or podcast footage into a clean cut and vertical Shorts: word-level transcript, silence cuts, captions, FFmpeg. | `edit-footage-with-code` | `varg-video-editing`, `short-form-ffmpeg-cookbook`, `caption-styles`, `varg-video-edit-library`, `video-asset-sources`, `media-judge`, `video-project-github` | [how-to/edit-video-with-claude-code](how-to/edit-video-with-claude-code/README.md) |
| Launch & explainer video: Turn your app and a few lines of copy into a code-made launch, demo or explainer video: UI mockups, motion, charts, sound, no footage. | `app-ui-mockups` | `video-script`, `kinetic-type-art`, `maps-and-data-motion`, `title-design`, `transition-craft`, `video-sound`, `media-judge` | [how-to/make-a-product-launch-video](how-to/make-a-product-launch-video/README.md) |
| Talking avatar: Turn a photo and a script into a lip-synced talking avatar, a keynote speaker clip or a two-host AI podcast with steady faces. | `varg-ai` | `varg-character-design`, `video-sound`, `varg-character-keynote`, `varg-podcast-video` | [how-to/make-an-ai-talking-avatar-video](how-to/make-an-ai-talking-avatar-video/README.md) |
| Image to video: Turn any photo into a moving clip on Seedance 2.5, Kling 4, Veo 3.1 or Wan 3 with one varg key, or into a looping GIF. | `varg-ai` | `varg-video-prompting`, `kling-4-prompting`, `gpt-image-gif`, `varg-occasion-video` | [how-to/image-to-video-ai](how-to/image-to-video-ai/README.md) |
| Product photo to video: Turn 1-3 product photos into a TikTok, Reels or listing video (unboxing, ASMR, 360 loop, in-hand demo) with the label locked. | `product-photo-to-video` | `varg-product-lock`, `varg-unboxing-video`, `varg-product-hook` | [how-to/product-photo-to-video](how-to/product-photo-to-video/README.md) |
| Faceless video: Turn a topic into a faceless Short or YouTube video: script, a voice that doesn't sound fake, licensed or generated B-roll, captions, QA. | `video-script` | `video-sound`, `video-asset-sources`, `varg-ai`, `caption-styles`, `varg-dropship-reel`, `media-judge` | [how-to/make-a-faceless-youtube-video](how-to/make-a-faceless-youtube-video/README.md) |
| Video captions: Turn a video into one with burned-in, word-timed captions: 17 animated styles or plain SRT, rendered locally with FFmpeg or HyperFrames. | `caption-styles` | `edit-footage-with-code`, `short-form-ffmpeg-cookbook`, `varg-video-editing` | [how-to/add-captions-to-video](how-to/add-captions-to-video/README.md) |
| AI short film: Turn an idea into an AI short film: script, real references, moodboard, cast passports, approved stills, animated shots, sound and QA. | `video-script` | `find-references`, `video-moodboard`, `character-passport`, `varg-mockups`, `video-animate`, `video-sound`, `media-judge`, `video-project-github` | [how-to/make-an-ai-movie](how-to/make-an-ai-movie/README.md) |
| AI influencer & characters: Turn an idea into an AI influencer or character with a locked look: premise, details, styling, a character sheet, then reuse in video. | `varg-character-design` | `varg-character-beautiful-woman`, `varg-character-fitness`, `varg-character-cringe`, `varg-character-grandma`, `varg-character-big-guy`, `varg-character-cartoon`, `varg-character-absurd`, `character-passport` | [how-to/make-an-ai-influencer](how-to/make-an-ai-influencer/README.md) |
| Consistent characters: Turn actor photos or a generated character into multi-scene video where the face, outfit and location stay the same in every shot. | `varg-consistent-characters` | `character-passport`, `varg-character-design`, `varg-video-prompting`, `media-judge` | [how-to/consistent-character-ai-video](how-to/consistent-character-ai-video/README.md) |
| Motion graphics: Turn text, a logo or numbers into kinetic type, titles, transitions, overlays, maps or shader stings, rendered locally for free. | `kinetic-type-art` | `title-design`, `transition-craft`, `social-overlays`, `paper-shaders`, `motion-formats`, `maps-and-data-motion`, `varg-video-edit-library` | [how-to/claude-code-motion-graphics](how-to/claude-code-motion-graphics/README.md) |
| Ecommerce video ads: Turn a product and four answers into ad creatives that sell: angle, hook, format, script, compliant AI shots, variants and a final cut. | `ecommerce-video-ads` | `product-video-hooks`, `varg-product-hook`, `varg-mascot-jingle-ad`, `varg-dropship-reel`, `ecommerce-video-edit`, `social-overlays`, `ai-ad-compliance-check` | [how-to/make-ecommerce-video-ads](how-to/make-ecommerce-video-ads/README.md) |
| Kling & Seedance prompts: Turn an idea into shots that come out right in one or two takes: pick Kling 4 or Seedance 2.5 per shot, then prompt it from approved stills. | `varg-video-prompting` | `video-animate`, `kling-4-prompting`, `kling-4-keyframe-film`, `kling-4-action-montage`, `media-judge` | [how-to/kling-4-and-seedance-prompt-guide](how-to/kling-4-and-seedance-prompt-guide/README.md) |
| Voiceover & sound: Turn a script and a cut into a finished soundtrack: an auditioned AI voice, SFX on the right frame, music with a quiet part, a measured mix. | `video-sound` | `video-script`, `video-asset-sources`, `varg-ai` | [how-to/add-ai-voiceover-to-video](how-to/add-ai-voiceover-to-video/README.md) |
| GPT Image 2.6: Turn a prompt or photo into GPT Image 2.6 posters and infographics, precise spot edits, looping GIFs, sticker packs or game sprite sheets. | `gpt-image-2-6` | `gpt-image-markup-edit`, `gpt-image-gif`, `gpt-image-sticker-pack`, `gpt-image-sprite-sheet`, `make-a-woke-profile-with-chatgpt` | [how-to/gpt-image-2-6](how-to/gpt-image-2-6/README.md) |
| Game sprite sheets: Turn a character still into a 16-frame run, walk, idle or attack cycle, sliced into a GIF, an atlas PNG and a JSON atlas for Phaser. | `gpt-image-sprite-sheet` | `varg-character-design`, `gpt-image-2-6`, `gpt-image-gif` | [how-to/make-game-sprite-sheets-with-ai](how-to/make-game-sprite-sheets-with-ai/README.md) |
| FFmpeg vertical video: Turn any footage into a 1080x1920 MP4 for Reels, TikTok and Shorts with copyable FFmpeg commands tested on real media, free and local. | `short-form-ffmpeg-cookbook` | `ecommerce-video-edit`, `footage-effects`, `varg-video-edit-library` | [how-to/ffmpeg-vertical-video](how-to/ffmpeg-vertical-video/README.md) |
| Virtual try-on: Turn a flat-lay photo of clothing into a model wearing it and fit-check clips (turn, walk, mirror selfie) with the garment kept intact. | `varg-tryon-video` | `varg-character-design`, `product-photo-to-video`, `ai-ad-compliance-check` | [how-to/ai-virtual-try-on-video](how-to/ai-virtual-try-on-video/README.md) |
| Translate & dub ads: Turn one video ad into versions for 8+ markets: transcreated script, same voice on ElevenLabs v4, lip sync on talking shots, new captions. | `varg-ad-localize` | `caption-styles`, `varg-video-editing` | [how-to/translate-and-dub-video-ads](how-to/translate-and-dub-video-ads/README.md) |
| TikTok Shop videos: Turn a product link into a TikTok Shop script and shot list that sells and passes Shop rules: a real presenter, AI only for b-roll. | `tiktok-shop-video` | `product-video-hooks`, `ecommerce-video-edit`, `ai-ad-compliance-check` | [how-to/make-tiktok-shop-videos](how-to/make-tiktok-shop-videos/README.md) |
| Birthday & occasion videos: Turn a name, an age and a few photos into a birthday video with a song that sings their name, or an invitation or holiday greeting. | `varg-birthday-video` | `varg-occasion-video` | [how-to/make-an-ai-birthday-video](how-to/make-an-ai-birthday-video/README.md) |
| Ad variants & testing: Turn one winning ad into 20 variants Meta and TikTok treat as different, plus file names, a test plan and when to kill or scale. | `varg-ad-variants` | `varg-ad-library-remix`, `ad-creative-testing`, `product-video-hooks`, `ecommerce-video-edit` | [how-to/make-ad-variations-for-testing](how-to/make-ad-variations-for-testing/README.md) |
| Storyboard & previz: Turn a script into an approved storyboard and a 3D previz with real cameras, then the reference for Seedance 2.5 video-to-video. | `varg-previz` | `varg-mockups`, `threejs-animatic`, `code-to-video-previz`, `video-animate` | [how-to/ai-storyboard-to-video](how-to/ai-storyboard-to-video/README.md) |
| Download videos: Turn a link from X, YouTube, Instagram, TikTok or 1,800+ other sites into a local MP4 or MP3, or a Pinterest board into reference images. | `media-download` | `find-references`, `video-asset-sources` | [how-to/download-videos-from-x-youtube-tiktok](how-to/download-videos-from-x-youtube-tiktok/README.md) |
| Find video skills: Turn a video request in any language into the best-matching agent skill, its install command and the options to offer, with no key. | `how-to-make-ai-video` | `video-skills`, `varg-ai`, `varg-publish-skill` | [how-to/claude-code-video-skills](how-to/claude-code-video-skills/README.md) |

No key needed: `ad-creative-testing`, `app-ui-mockups`, `caption-styles`, `code-to-video-previz`, `ecommerce-video-edit`, `edit-footage-with-code`, `find-references`, `footage-effects`, `how-to-make-ai-video`, `kinetic-type-art`, `maps-and-data-motion`, `media-download`, `media-judge`, `motion-formats`, `paper-shaders`, `product-video-hooks`, `short-form-ffmpeg-cookbook`, `social-overlays`, `threejs-animatic`, `tiktok-shop-video`, `title-design`, `transition-craft`, `varg-video-edit-library`, `varg-video-editing`, `video-asset-sources`, `video-moodboard`, `video-project-github`, `video-script`, `video-skills`.
<!-- index:end -->

## Work on this repo

- Skill folders are lowercase-hyphen and match the `name` in their `SKILL.md` frontmatter. Keep `SKILL.md` under 500 lines; put detail in `references/`.
- `README.md`, `how-to/**/README.md`, every `<skill>/README.md`, `llms.txt`, `catalog.json`, `context7.json` and the index block above are generated. Edit `SKILL.md`, `.github/readme/skills.json` (title, tagline, category, example requests, preview) or `.github/readme/use-cases.json` (one guide per task), then run `bun .github/readme/build.ts`. CI runs it with `--check`.
- A new skill also goes into `.claude-plugin/plugin.json` → `skills`, and into at least one use case. The build fails until it is.
- Never commit media (mp4, mov, webm, gif, mp3, wav, large png/jpg). Upload previews to s3.varg.ai and link them.
- English only. No real people's names or faces in examples unless they are the skill's credited author. Credit third-party work to its author.
- Never commit `.env`, keys or tokens.