New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Short Video Idea Miner

Shortform idea grill

by ericosiu · MIT license · ★ 3,615 on GitHub

Shortform idea grill cover

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,…

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

Overview

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

Manual install (npx, ZIP)
Claude Codenpx skills add ericosiu/ai-marketing-skills --skill shortform-idea-grill -g -a claude-code
Claude Code (degit)npx degit ericosiu/ai-marketing-skills/shortform-idea-grill#main ~/.claude/skills/shortform-idea-grill
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md4.8 KB
Read SKILL.md here
ericosiu/main1 file shown
SKILL.md
Show the full text109 lines

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.

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:

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.
1---
2name: shortform-idea-grill
3description: 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.
4---
5 
6# Shortform Idea Grill
7 
8Turn current work into success-led videos that earn attention quickly and fully repay the opening promise.
9 
10## Load the right context
11 
12Inspect 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.
13 
14Read:
15 
16- `references/intake-schema.md` before interviewing.
17- `references/output-contract.md` before drafting.
18- `references/scoring-rubric.md` before scoring.
19- `references/ideas-schema.md` when saving machine-readable output.
20 
21Do not ask for information already present. Distinguish live evidence from remembered context.
22 
23## Interview one question at a time
24 
25Resolve these items in order:
26 
271. desired outcome;
282. target viewer and relevant moment;
293. owned proof and measurable results;
304. current builds, experiments, opinions, and predictions;
315. claim boundaries;
326. CTA and destination;
337. available screens, artifacts, and recording constraints.
34 
35Ask 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.
36 
37If essential context is missing, return `needs_intake` with the next question and a recommended answer. A provisional slate may continue only when labeled.
38 
39## Generate net-new candidates
40 
41Mine active work rather than recycling old videos. Cover at least five evidence-supported lanes:
42 
43- money created;
44- money saved;
45- productive capacity created;
46- proof-led workflow demonstration;
47- contrarian operating belief;
48- timely prediction;
49- founder lesson or corrected failure;
50- teardown, comparison, or myth correction.
51 
52Reject any idea without a specific viewer, credible proof path, useful payoff, or filmable treatment.
53 
54Prefer success language. A failure may establish tension, but the video must resolve into a useful mechanism, result, or decision.
55 
56## Write hooks that can be repaid
57 
58Write one strongest five-second overlay per idea. It must:
59 
60- communicate the premise in the first three seconds;
61- use a number, result, contrast, or consequential verdict when justified;
62- remain visible for roughly five seconds;
63- avoid unsupported certainty;
64- lead directly to the promised demonstration or explanation.
65 
66For number hooks, specify the evidence behind the number. For “how I” hooks, show the workflow. For predictions, separate observed evidence from the forecast.
67 
68## Produce the exact table
69 
70Return the table defined in `references/output-contract.md`. Unless the user asks otherwise, do not add extra strategy sections before it.
71 
72Every row must include exactly three concise yap bullets. Make them a natural spoken sequence:
73 
741. context or stakes;
752. mechanism or tactic;
763. result, lesson, or application.
77 
78Put the proof requirement, source link, and claim caveat inside **Complete payoff / proof** so the visible table remains stable.
79 
80## Score and rank
81 
82Score virality and three-second hook independently from 1.0–10.0 using `references/scoring-rubric.md`. Scores are production-priority judgments, not view forecasts.
83 
84Rank 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.
85 
86When saving JSON, run:
87 
88```bash
89python3 scripts/score_ideas.py ideas.json --output ideas-scored.json
90python3 scripts/score_ideas.py ideas-scored.json --validate-only
91```
92 
93## CTA rules
94 
95Map 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.
96 
97## Final checks
98 
99Before handoff, verify:
100 
101- every idea is net-new or explicitly marked as a refreshed angle;
102- every hook has a complete payoff;
103- every row has exactly three bullets;
104- every numerical claim has a proof path or verification caveat;
105- every source link points to the real basis, not a search result;
106- CTAs use the configured keyword and destination;
107- the table is sorted by recording priority;
108- public output contains no private names, metrics, paths, customer data, or connector details unless the user supplied them for that output.
109 
View all files on GitHub →

Details

License
MIT
Stars on the repo
★ 3,615
Checked
Source
ericosiu/ai-marketing-skills ↗
Creator
ericosiu · 34 listings
View creator

Similar skills

See all →
AI Video Clipping ToolSamurAIGPT/Generative-Media-Skills · by SamurAIGPTTurn a long video into N viral-ready short clips with a single managed API call. Wraps muapi.ai's `/ai-clipping` endpoint, which handles transcription, highlight ranking through a virality framework (hook / emotional peak / opinion bomb / revelation / conflict / quotable / story peak / practical value), overlap dedupe, and vertical face-tracking auto-crop server-side. No local Whisper, no local LLM, no GPU.★ 4.3k GitHub starsYouTube Shorts GeneratorSamurAIGPT/Generative-Media-Skills · by SamurAIGPTAuto-generate viral 9:16 YouTube Shorts (or TikTok / Reels clips) from a long-form video. Thin platform-aware wrapper around the AI Clipping skill — picks sensible defaults for short-form social platforms (9:16, 30–60s sweet spot) and delegates the actual highlight extraction + crop to muapi.ai's `/ai-clipping` endpoint.★ 4.3k GitHub starsVertical Video Editorericosiu/ai-marketing-skills · by ericosiuTurn 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. Use for original Instagram Reels, TikTok videos, YouTube Shorts, LinkedIn videos, founder-led recordings, multiple takes of a new script or idea card, or requests to automate the first video-editing pass. Do not use to mine clips from long-form source videos.★ 3.6k GitHub starsShort Form Video Pipelineericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub starsShort Video Script Writeraaron-he-zhu/aaron-marketing-skills · by aaron-he-zhuUse when the user asks to "script this short video", "write a TikTok / Reels / Shorts script", "给这条抖音或视频号视频写脚本", or "fix the hook — viewers drop off in the first seconds"; produces timestamped beat-sheet scripts on the retention-gate model (0-2s hook / 2-5s confirmation / 5-15s payoff / loop-or-CTA) with per-scene script lines, on-screen text for muted viewing, asset keywords, and 9:16 format-param rows per platform norm card for TikTok, Reels, Shorts, 抖音, and 视频号 — plus 2-3 hook options from named hook families and an AI-content disclosure line by default on realistic synthetic media. Spec-only: rendering, TTS, and publishing stay with the user''s own tools — no pipelines, no upload automation. Not for creator video briefs — use brief-generator; long-form video SEO belongs to content-writer. 短视频脚本/抖音分镜/开头钩子/竖屏9:16★ 2.9k GitHub starsProduct Reel Generatorgooseworks-ai/goose-skills · by gooseworks-aiGenerates Instagram-ready product reels from any e-commerce product page URL. Scrapes product images, classifies by type, generates AI-animated clips via Higgsfield API, creates text overlays with style presets, and composes a 15-20 second reel with music. Supports model-based and product-only reels.★ 1.2k GitHub stars

More from ericosiu

Video Moment Extraction Agentericosiu/ai-marketing-skills · by ericosiuUse when an agent must extract moments, quotes, objections, hooks, or evidence from long video or audio cheaper than full-frame ingest — sales calls, podcasts, YouTube episodes, Loom trials, discovery recordings. Goal-directed watch via Gemini agentic video understanding (frames, audio, or transcript). Not for cutting, overlays, rendering, scheduling, or publishing.★ 3.6k GitHub starsConversion Operationsericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub starsFinance Operationsericosiu/ai-marketing-skills · by ericosiuAI-powered financial analysis suite. Generates executive CFO briefings from QuickBooks exports (P&L, Balance Sheet, General Ledger, Cash Flow, etc.) with anomaly detection, burn rate, runway analysis, and scenario modeling. Also estimates codebase development costs with organizational overhead and AI ROI analysis. Triggers on: 'CFO briefing', 'financial analysis', 'cost briefing', 'expense review', 'runway analysis', 'burn rate', 'cost estimate', 'how much would this cost to build', 'development cost', 'Claude ROI'.★ 3.6k GitHub starsRevenue Intelligence Dashboardericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub starsSales Pipeline Managerericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub starsValue-Based Sales Playbookericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub stars