Agent skill

Reels Script

by social-media-skills in social-media-skills/skills

A skill your agent uses to write an Instagram Reels script — a native, sound-off-first short-video script optimized for Instagram's discovery engine, built around a 3-second hook, watch-through, and…

MITAuto-check passedMedia & Creative

Install Reels Script

skills CLI
$ npx skills add social-media-skills/skills --skill reels-script -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install social-media-skills/skills reels-script --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/reels-script .claude/skills/reels-script && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reels-script
GitHub stars
134
Token cost
~2.1k tokens
SKILL.md length
937 words
Files
7 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses to write an Instagram Reels script — a native, sound-off-first short-video script optimized for Instagram's discovery engine, built around a 3-second hook, watch-through, and…

  • Works in 9 steps: Read the foundation first → Lock the concept, goal, and length tier → Decide the audio (and write sound-off… → …
  • Write an Instagram Reels script — a native
  • SKILL.md covers Step 0 — Read the foundation…, Step 1 — Lock the concept,…, Step 2 — Decide the audio (and… and Step 3 — Write the 3-second hook, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reels Script is an agent skill from social-media-skills/skills. Use to write an Instagram Reels script — a native, sound-off-first short-video script optimized for Instagram's discovery engine, built around a 3-second hook, watch-through, and sends (DM shares). Run when the user says "Reels script," "Instagram Reel," "make a Reel," "Reel hook," "trial reel," or wants short-form video for Instagram specifically. Reads brand-profile and voice first; writes the muted version first; structures for watch-through + sends; places IG-search keywords; picks original vs trending audio…

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `evals/evals.json`, `references/examples.md` and `references/formats-and-audio.md`).

It sits in Media & Creative, covering Video scripts and shorts and AI video generation. It works with Instagram and TikTok. The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Write an Instagram Reels script — a native
  • Sound-off-first short-video script optimized for Instagrams discovery engine
  • Built around a 3-second hook
  • Sends (DM shares)

Example prompts

  • “Reels script,”
  • “Instagram Reel,”
  • “make a Reel,”
  • “/reels-script”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Read the foundation first
  2. Lock the concept, goal, and length tier
  3. Decide the audio (and write sound-off anyway)
  4. Write the 3-second hook
  5. Structure for watch-through and sends
  6. Write the production doc + cover brief
  7. Instagram SEO + caption + hashtags
  8. Test with Trial Reels; produce film-first or with the Veo pack
  9. Hand off

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30eeb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reels Script loads about 2.1k tokens when it runs, and up to ~7.2k if it reads all its reference files. Until then it costs about 246 tokens; SKILL.md has 937 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~246
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 937 words, ~2,059 tokens.

Download SKILL.mdSave it as .claude/skills/reels-script/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
reels-script
description
Use to write an Instagram Reels script — a native, sound-off-first short-video script optimized for Instagram's discovery engine, built around a 3-second hook, watch-through, and sends (DM shares). Run when the user says "Reels script," "Instagram Reel," "make a Reel," "Reel hook," "trial reel," or wants short-form video for Instagram specifically. Reads brand-profile and voice first; writes the muted version first; structures for watch-through + sends; places IG-search keywords; picks original vs trending audio (trending audio is added natively in-app — not via WoopSocial); briefs the cover frame; outputs a production doc (shot - on-screen text - spoken - audio - timing) plus a Veo prompt pack for faceless/b-roll shots. The generic scripting craft lives in short-form-video-script; for TikTok use tiktok-script; for Shorts use youtube-shorts; hands the caption to caption-writer, publishing to instagram-reels-publishing, and scheduling to scheduling-and-queue.
metadata.version
1.0.0
license
MIT

Reels Script

Reels are Instagram's discovery engine: most Reel reach comes from non-followers, decided by how viewers respond — not by follower count. But Reels are not TikToks with a different logo:

  1. The hook window is ~3 seconds — they decide whether a Reel is pushed wider or throttled. Layer it: verbal + on-screen text + visual.
  2. Watch-through and sends rule. Watch time is the top signal; sends-per-reach (DM shares) are weighted roughly 3–5× more than likes for reaching new people. Script for both.
  3. Write the muted version first. Most Reels viewers watch on mute — if the on-screen text doesn't carry the story, the script fails before the audio matters.
  4. Eligibility gates come before ranking: original, no TikTok/CapCut watermarks, has audio, under the length cap, clear niche. A watermarked reupload is throttled at the gate.
  5. The Reel also lives on your grid — plan the cover frame; it can't be edited after publish.

(Full mechanics in references/reels-mechanics.md.)

Step 0 — Read the foundation first

Load brand-profile.md and voice.md. Voice carries into the spoken script, on-screen text, and caption. Carry guardrails and compliance rules.

Step 1 — Lock the concept, goal, and length tier

  • One idea — a Reel does one thing.
  • Goal — reach, sends, saves, follows, or comments (shapes the close/CTA).
  • Length tier — ~15–35s is the reach sweet spot; up to ~90s for tutorials/storytelling that earns it; up to ~3 min stays recommendation-eligible. Let the idea pick the length; never pad. See references/reels-mechanics.md.

Step 2 — Decide the audio (and write sound-off anyway)

Original audio (your voice) for most founder/brand content; a trending audio where it genuinely fits — but Instagram's licensed library is native-only: the script names the audio direction, the human adds the track in-app (WoopSocial can't attach trending audio). Either way, the Reel must work on mute. Live trend research → trend-jacking. See references/formats-and-audio.md.

Step 3 — Write the 3-second hook

Use hook-writer. Fire on all three channels at once — verbal + bold on-screen text + a striking first frame — with no intro, no logo, no "hey guys." The on-screen text hook must work silently, and the hook must be true: a bait-and-switch creates a mid-video retention cliff the algorithm punishes. See references/hooks-and-retention.md.

Step 4 — Structure for watch-through and sends

Front-load value, open a loop early, change the visual every ~2–4 seconds, cut all dead air, and engineer a loop or rewatch trigger so the ending feeds the start. Then ask the sends question: who would DM this to whom, and why? Relatable, useful-reference, or conversation-starting beats travel; generic tips don't. See references/hooks-and-retention.md.

Step 5 — Write the production doc + cover brief

Output a shootable doc — a row per beat with shot · on-screen text · spoken · audio · timing — plus a one-line cover-frame brief (which frame, or a custom cover with bold text in the grid-safe center). Keep hook text, faces, and CTAs inside the safe zone — exact zones live in instagram-reels-publishing.

Step 6 — Instagram SEO + caption + hashtags

Instagram search is keyword-based now: put the target keyword in the first ~3 seconds spoken, the on-screen text, and the caption's first sentence — and the visual must match the caption. Keyword research + the search-first caption → instagram-seo; caption craft → caption-writer; 3–5 topic-label hashtags, not thirty.

Step 7 — Test with Trial Reels; produce film-first or with the Veo pack

For unproven hooks/formats, recommend a Trial Reel (shown to non-followers first — a free test that doesn't touch follower-facing stats). Default to native filming for faces and voices. For faceless niches, b-roll, or unfilmable shots, use the bundled Veo prompt pack (references/veo-prompt-pack.md; API layer in tools/integrations/veo.md) — and follow Meta's AI-labeling rules for generated media (disclosure on Instagram is native/manual, not automatic).

Show full SKILL.md (341 more words)Show less

Step 8 — Hand off

  • Caption → caption-writer (keyworded via instagram-seo).
  • Publish (specs, safe zone, cover, settings) → instagram-reels-publishing.
  • Schedule → scheduling-and-queue (upload the video to WoopSocial Media, then schedule).

Quality bar — self-check

  • Does the hook land in ~3 seconds on all three channels, with no intro tax?
  • Does the script work on mute (on-screen text carries the story)?
  • Is it built for watch-through (fast, no dead air) with a loop/rewatch trigger?
  • Can I name who sends this to whom, and why?
  • Is the audio choice intentional — and flagged as native add-in-app if trending?
  • Does it clear the eligibility gates (original, watermark-free, niche-clear)?
  • Keywords in spoken + on-screen + caption; a cover-frame brief included?
  • Is the output a shootable production doc — on-voice, truthful hook, no fabricated stats?

Edge cases & pushback

  • "Just repost my TikToks" → the watermark + originality gates throttle reach; re-cut a clean native version → cross-platform-repurposing.
  • "Add the trending audio for me" → the script names the audio direction; the human adds IG's licensed audio in-app. Never claim WoopSocial attaches it.
  • "Make it a polished brand ad" → authentic, person-first content out-travels glossy spots; deliver a native version that still hits the goal.
  • "Guarantee this goes viral" → no guarantees; a strong hook + send-worthy idea stacks the odds, and a Trial Reel tests it risk-free.
  • Thin concept → shape the one idea; don't pad to fill a length tier.
  • Regulated/sensitive → carry guardrails; only verifiable claims; required disclaimers.
  • short-form-video-script — the master scripting craft this specializes for Instagram.
  • brand-profile, voice-builder — voice + guardrails; hook-writer — the 3-second hook.
  • instagram-seo — keywords + the search-first caption; caption-writer — caption craft.
  • trend-jacking — live trend/audio research; instagram-growth — the growth strategy above this.
  • tiktok-script — TikTok; youtube-shorts — Shorts; cross-platform-repurposing — adapt across.
  • instagram-reels-publishing — specs/safe zone/cover/publish; scheduling-and-queue — schedule (via WoopSocial); tools/integrations/veo.md — the Veo API/connection layer.

References

  • references/reels-mechanics.md — the Reels discovery engine, signals, gates, length tiers, Trial Reels, the grid.
  • references/hooks-and-retention.md — the 3-second hook, sound-off design, watch-through tactics, the sends lever.
  • references/formats-and-audio.md — Reels formats + original vs trending audio (and the native-only limit).
  • references/veo-prompt-pack.md — AI-video pack for faceless/b-roll, with disclosure and film-first caveats.
  • references/examples.md — worked production docs with cover briefs, sends design, and IG keywords.

© social-media-skills, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in skills/reels-script of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/examples.md
  • references/formats-and-audio.md
  • references/hooks-and-retention.md
  • references/reels-mechanics.md
  • references/veo-prompt-pack.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Reels Script next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reels Script compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reels Script this skillsocial-media-skills/skills134—~2.1kAutomated safety check: PassMIT
Seedance Viral Hookrediumvex/ai-video-generator-claude409—~4.6kAutomated safety check: PassMIT
Seedance Social Hookbeshuaxian/higgsfield-seedance2-jineng952—~21kAutomated safety check: PassNone
Seedance Social Hookbeshuaxian/higgsfield-seedance2-jineng952—~20kAutomated safety check: PassNone
AI Social Media ContentNeverSight/learn-skills.dev2171 repos~1.8kAutomated safety check: PassNone
Taisly Social Media Postingtaisly/agent2171 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Seedance Viral Hook

    rediumvex/ai-video-generator-claude

    Generate scroll-stopping viral hook video prompts for Seedance 2.0 on Higgsfield.

    409 GitHub stars~4.6k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Seedance Social Hook

    beshuaxian/higgsfield-seedance2-jineng

    Generate viral social media hook video prompts for TikTok, Instagram Reels, and YouTube Shorts using Seedance 2.0 on Higgsfield.

    952 GitHub stars~21k tokensUpdated 6 mo ago
    Media & CreativeAuto-check passed
  • Seedance Social Hook

    beshuaxian/higgsfield-seedance2-jineng

    使用 Seedance 2.0(Higgsfield)为 TikTok、Instagram Reels 和 YouTube Shorts 生成病毒式社交媒体钩子视频提示。在用户想要创建令人停下滚动的钩子、病毒式短视频、引人注目的开场白、TikTok 内容、Reels 内容、Shorts 内容或任何社交媒体优化视频时使用。在以下情况下触发:社交媒体视频、TikTok、Instagram…

    952 GitHub stars~20k tokensUpdated 6 mo ago
    Media & CreativeAuto-check passed
  • AI Social Media Content

    NeverSight/learn-skills.dev

    Create AI-powered social media content for TikTok, Instagram, YouTube, Twitter/X.

    217 GitHub starsUsed in 1 repo~1.8k tokens
    Writing & ContentAuto-check passed
  • Free AI-first short-form video publishing to TikTok, Instagram Reels, YouTube Shorts, X, and Facebook from AI agents through Taisly.

    217 GitHub starsUsed in 1 repo~1.5k tokens
    Media & CreativeAuto-check passed
  • Seedance Before After

    rediumvex/ai-video-generator-claude

    Generate before-and-after transformation video prompts for Seedance 2.0 on Higgsfield.

    409 GitHub stars~4.8k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo
  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Works with

Questions about Reels Script

What does Reels Script do?

A skill your agent uses to write an Instagram Reels script — a native, sound-off-first short-video script optimized for Instagram's discovery engine, built around a 3-second hook, watch-through, and…. Reels Script is an agent skill from social-media-skills/skills. Use to write an Instagram Reels script — a native, sound-off-first short-video script optimized for Instagram's discovery engine, built around a 3-second hook, watch-through, and sends (DM shares).

When should I use Reels Script?

Reels Script fits situations like: write an Instagram Reels script — a native; sound-off-first short-video script optimized for Instagrams discovery engine; built around a 3-second hook; sends (DM shares).

How do I install Reels Script in Claude Code?

Run `npx skills add social-media-skills/skills --skill reels-script -a claude-code`. Or copy the skill folder (skills/reels-script in social-media-skills/skills) into .claude/skills/reels-script in your project. Claude Code loads it when a task matches its description.

How do I install Reels Script in Codex?

Run `npx skills add social-media-skills/skills --skill reels-script -a codex`. Or copy the skill folder (skills/reels-script in social-media-skills/skills) into .agents/skills/reels-script in your project. Codex loads it when a task matches its description.

Can I use Reels Script in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add social-media-skills/skills --skill reels-script -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reels-script, .gemini/skills/reels-script, .github/skills/reels-script and .opencode/skills/reels-script in your project.

What does Reels Script need to run?

SKILL.md names no scripts, command-line tools or credentials: Reels Script is instructions for the agent only.

Does Reels Script access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reels Script safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reels Script use?

Reels Script is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reels Script use?

About 2.1k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.2k tokens, read only when the agent opens those files.

What are the alternatives to Reels Script?

Skills that share tags, products or a category with Reels Script: Seedance Viral Hook (rediumvex/ai-video-generator-claude, 409 stars), Seedance Social Hook (beshuaxian/higgsfield-seedance2-jineng, 952 stars), Seedance Social Hook (beshuaxian/higgsfield-seedance2-jineng, 952 stars) and AI Social Media Content (NeverSight/learn-skills.dev, 217 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reels Script?

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

Source: social-media-skills/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.