# Ig Reel

Write an Instagram Reel from a raw idea - hook options off 26 formulas, the spoken...

- Repository: https://github.com/Jakeschincariol/instagram-agent-skill (4342 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-09-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Jakeschincariol/instagram-agent-skill --skill ig-reel -g -a claude-code -y`
Codex: `npx skills add Jakeschincariol/instagram-agent-skill --skill ig-reel -g -a codex -y`
Cursor: `npx skills add Jakeschincariol/instagram-agent-skill --skill ig-reel -g -a cursor -y`
Gemini CLI: `npx skills add Jakeschincariol/instagram-agent-skill --skill ig-reel -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Jakeschincariol/instagram-agent-skill`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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.

The rest: https://github.com/Jakeschincariol/instagram-agent-skill/blob/HEAD/skills/ig-reel/SKILL.md