Agent skill

Shortform Idea Grill

by ericosiu in ericosiu/ai-marketing-skills

Interview a founder or senior marketer one question at a time, mine current work and owned proof for net-new short-form video ideas, and return a ranked table with one five-second overlay hook…

MITAuto-check passedMedia & Creative

Install Shortform Idea Grill

skills CLI
$ npx skills add ericosiu/ai-marketing-skills --skill shortform-idea-grill -a claude-code

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

GitHub CLI
$ gh skill install ericosiu/ai-marketing-skills shortform-idea-grill --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/ericosiu/ai-marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/shortform-idea-grill .claude/skills/shortform-idea-grill && 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
shortform-idea-grill
GitHub stars
3.6k
Token cost
~1.2k tokens
SKILL.md length
579 words
Files
8 (incl. scripts, references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Interview a founder or senior marketer one question at a time, mine current work and owned proof for net-new short-form video ideas, and return a ranked table with one five-second overlay hook…

  • Works in 7 steps: desired outcome; → target viewer and relevant moment; → owned proof and measurable results; → …
  • Instagram Reels
  • SKILL.md covers Load the right context, Interview one question at a time, Generate net-new candidates and Write hooks that can be repaid, plus 4 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Shortform Idea Grill is an agent skill from ericosiu/ai-marketing-skills. Interview a founder or senior marketer one question at a time, mine current work and owned proof for net-new short-form video ideas, and return a ranked table with one five-second overlay hook, virality and three-second-hook scores, exactly three talking bullets, a complete payoff, and a mapped CTA. Use for Instagram Reels, TikTok, YouTube Shorts, LinkedIn video, founder-led content planning, hook development, content-day production queues, or turning active AI, marketing, and operating work into credible…

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/ideas-schema.md` and `references/intake-schema.md`).

It sits in Media & Creative, covering Video production, Hooks and plugins and Content strategy. It works with Instagram, LinkedIn and TikTok. The repository describes itself as: Open-source AI marketing skills — growth experiments, sales pipeline, content ops, outbound, SEO, and finance automation. The licence is MIT.

When your agent uses it

  • Instagram Reels
  • Founder-led content planning
  • Hook development
  • Content-day production queues

Example prompts

  • “/shortform-idea-grill”

Requirements

  • Python 3

Workflow steps

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

  1. desired outcome;
  2. target viewer and relevant moment;
  3. owned proof and measurable results;
  4. current builds, experiments, opinions, and predictions;
  5. claim boundaries;
  6. CTA and destination;
  7. available screens, artifacts, and recording constraints.

What it can do on your machine

Read from SKILL.md and the folder at commit 8088e1a. 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 1 file in scripts/ (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

Shortform Idea Grill loads about 1.2k tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 138 tokens; SKILL.md has 579 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~138
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.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); the scripts in this folder are not scanned.

SKILL.md

The full file from ericosiu/ai-marketing-skills at commit 8088e1a, republished under its MIT licence (© ericosiu). 579 words, ~1,228 tokens.

Download SKILL.mdSave it as .claude/skills/shortform-idea-grill/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
shortform-idea-grill
description
Interview a founder or senior marketer one question at a time, mine current work and owned proof for net-new short-form video ideas, and return a ranked table with one five-second overlay hook, virality and three-second-hook scores, exactly three talking bullets, a complete payoff, and a mapped CTA. Use for Instagram Reels, TikTok, YouTube Shorts, LinkedIn video, founder-led content planning, hook development, content-day production queues, or turning active AI, marketing, and operating work into credible short-form concepts.

Shortform Idea Grill

Turn current work into success-led videos that earn attention quickly and fully repay the opening promise.

Load the right context

Inspect supplied chats, briefs, transcripts, analytics, creator research, offers, and prior content before asking questions. Prefer work from the current week and ideas not already published.

Read:

  • references/intake-schema.md before interviewing.
  • references/output-contract.md before drafting.
  • references/scoring-rubric.md before scoring.
  • references/ideas-schema.md when saving machine-readable output.

Do not ask for information already present. Distinguish live evidence from remembered context.

Interview one question at a time

Resolve these items in order:

  1. desired outcome;
  2. target viewer and relevant moment;
  3. owned proof and measurable results;
  4. current builds, experiments, opinions, and predictions;
  5. claim boundaries;
  6. CTA and destination;
  7. available screens, artifacts, and recording constraints.

Ask only the single question most likely to improve the queue. Let the user answer freely, then press for numbers, mechanisms, examples, or proof. Stop when further interviewing would not materially change the ranking.

If essential context is missing, return needs_intake with the next question and a recommended answer. A provisional slate may continue only when labeled.

Generate net-new candidates

Mine active work rather than recycling old videos. Cover at least five evidence-supported lanes:

  • money created;
  • money saved;
  • productive capacity created;
  • proof-led workflow demonstration;
  • contrarian operating belief;
  • timely prediction;
  • founder lesson or corrected failure;
  • teardown, comparison, or myth correction.

Reject any idea without a specific viewer, credible proof path, useful payoff, or filmable treatment.

Prefer success language. A failure may establish tension, but the video must resolve into a useful mechanism, result, or decision.

Write hooks that can be repaid

Write one strongest five-second overlay per idea. It must:

  • communicate the premise in the first three seconds;
  • use a number, result, contrast, or consequential verdict when justified;
  • remain visible for roughly five seconds;
  • avoid unsupported certainty;
  • lead directly to the promised demonstration or explanation.

For number hooks, specify the evidence behind the number. For “how I” hooks, show the workflow. For predictions, separate observed evidence from the forecast.

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

Produce the exact table

Return the table defined in references/output-contract.md. Unless the user asks otherwise, do not add extra strategy sections before it.

Every row must include exactly three concise yap bullets. Make them a natural spoken sequence:

  1. context or stakes;
  2. mechanism or tactic;
  3. result, lesson, or application.

Put the proof requirement, source link, and claim caveat inside Complete payoff / proof so the visible table remains stable.

Score and rank

Score virality and three-second hook independently from 1.0–10.0 using references/scoring-rubric.md. Scores are production-priority judgments, not view forecasts.

Rank by expected usefulness to the target viewer, evidence strength, hook clarity, and business relevance. Break close ties with the user’s stated outcome hierarchy. Preserve topic variety when the top scores are nearly identical.

When saving JSON, run:

bash
python3 scripts/score_ideas.py ideas.json --output ideas-scored.json
python3 scripts/score_ideas.py ideas-scored.json --validate-only

CTA rules

Map each idea to the narrowest natural next step. Use the user’s configured keyword and destination when available. Do not force a lead magnet onto a topic whose payoff is broader education.

Final checks

Before handoff, verify:

  • every idea is net-new or explicitly marked as a refreshed angle;
  • every hook has a complete payoff;
  • every row has exactly three bullets;
  • every numerical claim has a proof path or verification caveat;
  • every source link points to the real basis, not a search result;
  • CTAs use the configured keyword and destination;
  • the table is sorted by recording priority;
  • public output contains no private names, metrics, paths, customer data, or connector details unless the user supplied them for that output.

© ericosiu, 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 7 other files (scripts, references) in shortform-idea-grill of ericosiu/ai-marketing-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/ideas-schema.md
  • references/intake-schema.md
  • references/output-contract.md
  • references/scoring-rubric.md
  • scripts/score_ideas.py
  • tests/test_score_ideas.py

Open the folder on GitHubat commit 8088e1a

Compare with similar skills

Shortform Idea Grill 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.

Shortform Idea Grill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shortform Idea Grill this skillericosiu/ai-marketing-skills3.6k—~1.2kAutomated safety check: PassMIT
Viral Short Form Ideasvyralcontent/content-skills1341 repos~2.9kAutomated safety check: PassMIT
ShortsAgriciDaniel/claude-shorts219—~3.2kAutomated safety check: NotesMIT
Taisly Social Media Postingtaisly/agent2171 repos~1.5kAutomated safety check: PassMIT
AutoshortsUpload-Post/skill-autoshorts151—~5.3kAutomated safety check: NotesMIT
Seedance Viral Hookrediumvex/ai-video-generator-claude409—~4.6kAutomated safety check: PassMIT

Similar skills

  • Viral Short Form Ideas

    vyralcontent/content-skills

    Generate short-form video ideas at volume and stop the blank-page problem for good.

    134 GitHub starsUsed in 1 repo~2.9k tokens
    Media & CreativeAuto-check passed
  • Shorts

    AgriciDaniel/claude-shorts

    Interactive longform-to-shortform video creator. An agent skill from AgriciDaniel/claude-shorts.

    219 GitHub stars~3.2k tokensUpdated 3 mo ago
    Media & CreativeAuto-check: notes
  • 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
  • Autoshorts

    Upload-Post/skill-autoshorts

    Daily pipeline that picks one long video from a folder, transcribes it with Whisper, uses Gemini 3 Flash multimodal to find every viral short-form moment, cuts each candidate with FFmpeg, adds a…

    151 GitHub stars~5.3k tokensUpdated 5 mo ago
    Media & CreativeAuto-check: notes
  • 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 1 mo ago
    Media & CreativeAuto-check passed
  • Short Format Video

    TheOrcDev/skills

    Write short-format video scripts (TikTok, Instagram Reels, YouTube Shorts) as one package with two halves, the spoken script and an editor-ready beat-by-beat shot list (camera angle, captions…

    106 GitHub stars~4.3k tokensUpdated 11 days ago
    Media & CreativeAuto-check passed

More from ericosiu/ai-marketing-skills

All 21 skills in this repo
  • Expert Panel

    ericosiu/ai-marketing-skills

    Score, evaluate, and iteratively improve any content or strategy using an auto-assembled panel of domain experts.

    3.6k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed
  • Cold Outbound Optimizer

    ericosiu/ai-marketing-skills

    Design, analyze, and optimize cold outbound email campaigns for Instantly.

    3.6k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Finance Ops

    ericosiu/ai-marketing-skills

    AI-powered financial analysis suite. An agent skill from ericosiu/ai-marketing-skills.

    3.6k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Leveling Up Content Engine

    ericosiu/ai-marketing-skills

    Diagnose and transform any authorized video URL, upload, recording, transcript, podcast, interview, presentation, screen recording, webinar, ad, or published video into the strongest justified…

    3.6k GitHub stars~2.3k tokensUpdated 17 days ago
    Auto-check passed
  • Net New Video Editor

    ericosiu/ai-marketing-skills

    Turn newly recorded talking-head footage into review-ready vertical video drafts with an explicit edit plan, deterministic FFmpeg rendering, captions, hook cards, audio normalization, and visual QA.

    3.6k GitHub stars~1.1k tokensUpdated 17 days ago
    Auto-check passed
  • Packaging Youtube Thumbnails

    ericosiu/ai-marketing-skills

    A skill your agent uses when a user supplies new video content or a channel and wants on-brand YouTube titles, thumbnail concepts, rendered variants, A/B packaging, identity profiling, precise…

    3.6k GitHub stars~3.8k tokensUpdated 17 days ago
    Auto-check passed

Questions about Shortform Idea Grill

What does Shortform Idea Grill do?

Interview a founder or senior marketer one question at a time, mine current work and owned proof for net-new short-form video ideas, and return a ranked table with one five-second overlay hook…. Shortform Idea Grill is an agent skill from ericosiu/ai-marketing-skills. Interview a founder or senior marketer one question at a time, mine current work and owned proof for net-new short-form video ideas, and return a ranked table with one five-second overlay hook, virality and three-second-hook scores, exactly three talking bullets, a complete payoff, and a mapped CTA.

When should I use Shortform Idea Grill?

Shortform Idea Grill fits situations like: instagram Reels; founder-led content planning; hook development; content-day production queues.

How do I install Shortform Idea Grill in Claude Code?

Run `npx skills add ericosiu/ai-marketing-skills --skill shortform-idea-grill -a claude-code`. Or copy the skill folder (shortform-idea-grill in ericosiu/ai-marketing-skills) into .claude/skills/shortform-idea-grill in your project. Claude Code loads it when a task matches its description.

How do I install Shortform Idea Grill in Codex?

Run `npx skills add ericosiu/ai-marketing-skills --skill shortform-idea-grill -a codex`. Or copy the skill folder (shortform-idea-grill in ericosiu/ai-marketing-skills) into .agents/skills/shortform-idea-grill in your project. Codex loads it when a task matches its description.

Can I use Shortform Idea Grill 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 ericosiu/ai-marketing-skills --skill shortform-idea-grill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shortform-idea-grill, .gemini/skills/shortform-idea-grill, .github/skills/shortform-idea-grill and .opencode/skills/shortform-idea-grill in your project.

What does Shortform Idea Grill need to run?

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

Does Shortform Idea Grill 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 Shortform Idea Grill 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Shortform Idea Grill use?

Shortform Idea Grill 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 Shortform Idea Grill use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 997 tokens, read only when the agent opens those files.

What are the alternatives to Shortform Idea Grill?

Skills that share tags, products or a category with Shortform Idea Grill: Viral Short Form Ideas (vyralcontent/content-skills, 134 stars), Shorts (AgriciDaniel/claude-shorts, 219 stars), Taisly Social Media Posting (taisly/agent, 217 stars) and Autoshorts (Upload-Post/skill-autoshorts, 151 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shortform Idea Grill?

ericosiu (a GitHub user) maintains it in ericosiu/ai-marketing-skills, which has 3,620 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on September 22, 2026.

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