Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it.

MITAuto-check passedMedia & Creative

Install Ig Reel

skills CLI
$ npx skills add Jakeschincariol/instagram-agent-skill --skill ig-reel -a claude-code

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

GitHub CLI
$ gh skill install Jakeschincariol/instagram-agent-skill ig-reel --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/Jakeschincariol/instagram-agent-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ig-reel .claude/skills/ig-reel && 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
ig-reel
GitHub stars
760
Token cost
~1.6k tokens
SKILL.md length
779 words
Files
4
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it.

  • Works in 4 steps: Read ~/.claude/instagram/voice.md if it… → Read hooks.json in this folder. 26… → If the idea is thin, do not pad it. Ask… → …
  • The user wants a Reel
  • SKILL.md covers Before you write, The shape, The loop and On-screen text is a separate…, plus 2 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Ig Reel is an agent skill from Jakeschincariol/instagram-agent-skill. Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it. Use whenever the user wants a Reel, a short-form video script, a hook, a voiceover, "make a reel about X", "what should I say in this video", or is about to record and does not have the first line yet.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `beats.py`, `hooks.json` and `hookscore.py`).

It sits in Media & Creative, covering Video production and Text to speech and voice. It works with Instagram. The repository describes itself as: Thirteen Claude skills that run an Instagram account: Reels off 26 scored hook formulas, a viral research skill, a caption linter, and a humanizer. Free, MIT. The licence is MIT.

When your agent uses it

  • The user wants a Reel
  • A short-form video script
  • Make a reel about X
  • What should I say in this video

Example prompts

  • “make a reel about X”
  • “what should I say in this video”
  • “/ig-reel”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read ~/.claude/instagram/voice.md if it exists. That is the user's voice
  2. Read hooks.json in this folder. 26 formulas, each with a template, a filled
  3. If the idea is thin, do not pad it. Ask one batched question: what happened,
  4. If ~/.claude/instagram/swipe.md exists, read it. /ig-viral writes that

What it can do on your machine

Read from SKILL.md and the folder at commit d03c56b. 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

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Ig Reel loads about 1.6k tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 779 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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 Jakeschincariol/instagram-agent-skill at commit d03c56b, republished under its MIT licence (© Jakeschincariol). 779 words, ~1,637 tokens.

Download SKILL.mdSave it as .claude/skills/ig-reel/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
ig-reel
description
Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it. Use whenever the user wants a Reel, a short-form video script, a hook, a voiceover, "make a reel about X", "what should I say in this video", or is about to record and does not have the first line yet.

ig-reel

Turns one raw idea into a Reel that somebody finishes.

Two tools live in this folder and they both actually run. Use them. Do not eyeball the hook and do not guess at the length.

bash
python3 hookscore.py hooks.txt              # rank your hook options
python3 hookscore.py --hook "one line"      # score a single one
python3 beats.py script.txt --target 30     # timed beat sheet before you shoot

Before you write

  1. Read ~/.claude/instagram/voice.md if it exists. That is the user's voice profile: how they talk on camera, what they never say, who they are talking to. If it does not exist, ask for three of their own reels, transcribe or read them, infer the voice, and write the file. A script in the wrong voice is unusable, because they have to say it out loud.
  2. Read hooks.json in this folder. 26 formulas, each with a template, a filled example, the on-screen version, what it is for, and how it gets ruined. Four of them are in there because they kept turning up in real hooks, not because they completed a pattern.
  3. If the idea is thin, do not pad it. Ask one batched question: what happened, to whom, and what did it cost or return. A Reel needs one specific true thing. Get it before writing.
  4. If ~/.claude/instagram/swipe.md exists, read it. /ig-viral writes that file, and it is the user's own evidence about which formulas are working in their niche right now. It beats the defaults in this file.

The shape

A Reel is decided in the first two seconds and kept by the next five.

0:00 - 0:02   HOOK        the claim. Spoken line and on-screen line, written
                          separately. Motion in the first frame, not a static face.
0:02 - 0:07   THE STAKE   why this matters to the person watching. One line.
0:07 - ...    THE BODY    one idea per beat, and the frame changes every beat.
LAST 3s       THE PAYOFF  deliver what the hook promised, then the single ask.
LAST LINE     THE LOOP    echo one word from the hook so the replay lands clean.

Length: 15 to 45 seconds is the working range. Reels run to 3 minutes and almost nobody should use it. Under 7 seconds the loop counts inflate and nothing else does.

The loop

1. Pick three hooks, not one. Run the idea through hooks.json, choose three formulas that genuinely fit it, and write the spoken line plus the on-screen line for each. Different formulas, not three rewrites of one.

2. Score them. Put the three spoken lines in a file, one per line, and run hookscore.py. Show the user the ranking. If the top one is under 50, you do not have the hook yet and no amount of editing fixes that.

3. Write the script on the winning hook. Plain spoken language, the way the user actually talks. Contractions. Short lines. No sentence they would have to rehearse.

4. Time it. Run beats.py script.txt --target {length}. Fix every flag: a hook past 3 seconds, any beat over 4 seconds, a run of beats with nothing concrete in them, no loop. Re-run until it is clean.

5. Humanize it. Run the script through /ig-human before showing it. A written-sounding line is obvious the moment someone says it out loud.

6. Print the block. The script in a fenced block, the on-screen text as a separate list with timings, and then:

REEL READY
hook:       #3 Nobody Tells You, scored 86 STRONG
length:     28.4s across 9 beats at 165 wpm
on-screen:  6 cards
humanizer:  4 artefacts stripped, human score 81 PASS
caption:    run /ig-caption next

Reply "yes" to log it, or tell me what to change.

7. Never publish. This skill produces a script. The user shoots it and posts it. On "yes", append to ~/.claude/instagram/log.md with the date, the hook formula used and the first line, so /ig-audit has a history later.

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

On-screen text is a separate script

Write it separately, every time. It is read before it is heard.

  • Six words or fewer per card. It is being read at arm's length by someone who is not listening yet.
  • The hook card is up at frame 1, not after a beat of silence.
  • Keep it inside the safe zone. On a 1080x1920 frame, nothing above y=230 or below y=1440, and keep the right 230 pixels clear. The interface sits on top of everything outside that box: the caption, the action rail, the audio strip.
  • Never put the hook where the caption sits. That is the bottom of the frame and it is covered.
  • Burn in captions for the body. Most people watch muted first.

Rules that make the difference

  • One idea per Reel. If the script has two, you have two Reels. Say so.
  • Numbers over adjectives. "$4,200" beats "a lot". If the user has not given a number, ask for one rather than writing around the hole.
  • Cut the intro. No greeting, no "in this video", no name, no logo sting. The video starts at the sentence you would normally reach at second six.
  • Change the frame every beat. A static shot for 8 seconds is where people leave, and beats.py will flag it.
  • One ask at the end. Comment a keyword, save it, or follow. One.
  • Never fabricate. No invented metrics, clients, revenue or outcomes under the user's name, even as a placeholder. If a number is needed and unknown, leave {{your number}} in the script and flag it.
  • Do not write a script around a trending audio the user cannot use. If the idea needs the user's own voice, say so.

Example

/ig-reel we cut proposal time from 5 hours to 20 minutes with one template
HOOKS  (scored)
  86  STRONG  #5  Time Collapse   "Proposals used to take me five hours. Twenty minutes now."
                                  on screen: 5 HOURS -> 20 MIN
  71  STRONG  #1  Cost Confession "I billed four hours a week for formatting. For two years."
                                  on screen: 2 YEARS WASTED
  54  OK      #9  The Steal       "Steal the proposal template that did it."
                                  on screen: STEAL THIS

Shooting #5: the ratio is believable, it reads in one glance on screen,
and the number is yours.

© Jakeschincariol, 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 3 other files in skills/ig-reel of Jakeschincariol/instagram-agent-skill.

  • SKILL.md
  • beats.py
  • hooks.json
  • hookscore.py

Open the folder on GitHubat commit d03c56b

Compare with similar skills

Ig Reel 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.

Ig Reel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ig Reel this skillJakeschincariol/instagram-agent-skill760—~1.6kAutomated safety check: PassMIT
Motion Adfabricioctelles/skills106—~4.1kAutomated safety check: PassApache-2.0
Render Ig Live Gallerygooseworks-ai/goose-skills1.2k—~1kAutomated safety check: PassMIT
DaVinci AutoEdit Agentliuluhaixiu/DaVinci-AutoEdit-Agent484—~2.8kAutomated safety check: NotesMIT
Ergo Remotion Videoitwanger/toBeBetterJavaer18k—~1.1kAutomated safety check: PassNone
Taisly Social Media Postingtaisly/agent2171 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Motion Ad

    fabricioctelles/skills

    Produce a short motion-graphics video ad — a 15s Facebook/Instagram/TikTok spot — as a rendered MP4.

    106 GitHub stars~4.1k tokensUpdated today
    Media & CreativeAuto-check passed
  • Render Ig Live Gallery

    gooseworks-ai/goose-skills

    Render an 'Instagram-Live social-proof gallery' video from a config — ~5 real brand product stills each framed as an Instagram-LIVE card (IG gradient-ring avatar, username, verified check, red LIVE…

    1.2k GitHub stars~1k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • DaVinci AutoEdit Agent

    liuluhaixiu/DaVinci-AutoEdit-Agent

    Guides an approval-gated video editing pipeline from raw footage to an audited DaVinci Resolve timeline, with scripting, optional TTS and a blueprint at each stage.

    484 GitHub stars~2.8k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: notes
  • Ergo Remotion Video

    itwanger/toBeBetterJavaer

    把口播稿做成二哥风格的 Remotion 视频,包括整理视频用稿、火山 TTS 配音、音画对齐、逐章动画预览和导出带配音的 MP4。用户说“做视频”“口播稿转视频”“Remotion”“继续做下一章”“出片”“渲染”“改读音”“配音读错了”,或给出 docs/src/ai/video/ 下的稿子要做成视频时使用。共享工具、配置和素材在…

    18k GitHub stars~1.1k tokensUpdated yesterday
    Media & CreativeAuto-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
  • Agent Video Pipeline

    JayceHuang/agent-video-pipeline

    Orchestrate a configurable, debuggable local pipeline from approved narration packages to timed audio, captions, visual assets, semantic motion, rendered video, optional avatar compositing…

    105 GitHub stars~1.8k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed

More from Jakeschincariol/instagram-agent-skill

All 13 skills in this repo
  • Ig Audit

    Jakeschincariol/instagram-agent-skill

    Post-mortem on what the user has already posted - which reels actually worked, why, and what to stop making.

    760 GitHub stars~1.1k tokensUpdated 27 days ago
    Auto-check passed
  • Ig Caption

    Jakeschincariol/instagram-agent-skill

    Write the Instagram caption - the line that survives the "...

    760 GitHub stars~1.2k tokensUpdated 27 days ago
    Auto-check passed
  • Ig Carousel

    Jakeschincariol/instagram-agent-skill

    Build an Instagram carousel - the cover that earns the swipe, slide-by-slide copy, and the 1080x1350 files to upload.

    760 GitHub stars~1k tokensUpdated 27 days ago
    Auto-check passed
  • Ig Comment

    Jakeschincariol/instagram-agent-skill

    Write comments on other people's Instagram posts and reels that read as a person with an opinion, not a bot.

    760 GitHub stars~1.1k tokensUpdated 27 days ago
    Auto-check passed
  • Ig Dm

    Jakeschincariol/instagram-agent-skill

    Write Instagram DMs that get replies - the keyword delivery, the first message to someone who engaged, the collab pitch, and the two follow-ups.

    760 GitHub stars~1.2k tokensUpdated 27 days ago
    Auto-check passed
  • Ig Human

    Jakeschincariol/instagram-agent-skill

    Strip the machine fingerprint out of any draft - em dashes, AI slop words, invisible watermark characters - and score it against a five-check detection panel before it goes out.

    760 GitHub stars~1.3k tokensUpdated 27 days ago
    Auto-check passed

Works with

Questions about Ig Reel

What does Ig Reel do?

Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it. Ig Reel is an agent skill from Jakeschincariol/instagram-agent-skill. Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken script, the on-screen text, and a timed beat sheet - in the user's own voice and scored before they shoot it.

When should I use Ig Reel?

Ig Reel fits situations like: the user wants a Reel; A short-form video script; make a reel about X; what should I say in this video.

How do I install Ig Reel in Claude Code?

Run `npx skills add Jakeschincariol/instagram-agent-skill --skill ig-reel -a claude-code`. Or copy the skill folder (skills/ig-reel in Jakeschincariol/instagram-agent-skill) into .claude/skills/ig-reel in your project. Claude Code loads it when a task matches its description.

How do I install Ig Reel in Codex?

Run `npx skills add Jakeschincariol/instagram-agent-skill --skill ig-reel -a codex`. Or copy the skill folder (skills/ig-reel in Jakeschincariol/instagram-agent-skill) into .agents/skills/ig-reel in your project. Codex loads it when a task matches its description.

Can I use Ig Reel 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 Jakeschincariol/instagram-agent-skill --skill ig-reel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ig-reel, .gemini/skills/ig-reel, .github/skills/ig-reel and .opencode/skills/ig-reel in your project.

What does Ig Reel need to run?

Going by SKILL.md and its folder, Ig Reel needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Ig Reel 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 Ig Reel 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 Ig Reel use?

Ig Reel is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ig Reel use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ig Reel?

Skills that share tags, products or a category with Ig Reel: Motion Ad (fabricioctelles/skills, 106 stars), Render Ig Live Gallery (gooseworks-ai/goose-skills, 1.2k stars), DaVinci AutoEdit Agent (liuluhaixiu/DaVinci-AutoEdit-Agent, 484 stars) and Ergo Remotion Video (itwanger/toBeBetterJavaer, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ig Reel?

Jakeschincariol (a GitHub user) maintains it in Jakeschincariol/instagram-agent-skill, which has 760 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 13, 2026.

Source: Jakeschincariol/instagram-agent-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.