Agent skill

Shortform Ideation

by ericrisco in ericrisco/rsc-harness

A skill your agent uses when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so…

MITAuto-check passedMedia & Creative

Install Shortform Ideation

skills CLI
$ npx skills add ericrisco/rsc-harness --skill shortform-ideation -a claude-code

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

GitHub CLI
$ gh skill install ericrisco/rsc-harness shortform-ideation --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/ericrisco/rsc-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/shortform-ideation .claude/skills/shortform-ideation && 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-ideation
GitHub stars
174
Token cost
~3.1k tokens
SKILL.md length
1,573 words
Files
6 (incl. scripts, references)
Skills in repo
233
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so…

  • Works in 4 steps: Ground in 02-DOCS → Source trends (legally) → Generate + score → …
  • A Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog
  • SKILL.md covers Decision gate — are you even…, The loop — four phases, in order, Phase 1 — Ground in 02-DOCS and Phase 2 — Source trends…, plus 4 more sections
  • Runs Shell scripts from its folder; calls bash

What it does

Shortform Ideation is an agent skill from ericrisco/rsc-harness. Use when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch. NOT scripting a chosen idea (that is video-shorts), NOT pillars or cadence (that is shortform-strategy), NOT packaging a finished cut (that is shortform-packaging).

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `evals/README.md`, `evals/cases.yaml` and `references/experiment-ledger.md`).

It sits in Media & Creative, covering Brainstorming and Video scripts and shorts. It works with TikTok and YouTube. The repository describes itself as: Your agent invents things because it has no memory, and can't touch your database because it has no arms. rsc is the meta-harness that gives it both, plus the trade to know the… The licence is MIT.

When your agent uses it

  • A Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog
  • Grounded in its own performance log plus dated trending sounds
  • Each bet logged so its outcome feeds the next batch

Example prompts

  • “/shortform-ideation”

Requirements

  • A Bash shell

Workflow steps

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

  1. Ground in 02-DOCS
  2. Source trends (legally)
  3. Generate + score
  4. Log the bet

What it can do on your machine

Read from SKILL.md and the folder at commit e3d5b33. 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/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

    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 Ideation loads about 3.1k tokens when it runs, and up to ~4.8k if it reads all its reference files. Until then it costs about 101 tokens; SKILL.md has 1,573 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
~3.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.8k

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 ericrisco/rsc-harness at commit e3d5b33, republished under its MIT licence (© ericrisco). 1,573 words, ~3,069 tokens.

Download SKILL.mdSave it as .claude/skills/shortform-ideation/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
shortform-ideation
description
Use when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch. NOT scripting a chosen idea (that is `video-shorts`), NOT pillars or cadence (that is `shortform-strategy`), NOT packaging a finished cut (that is `shortform-packaging`).
tags
shortform, reels, tiktok, ideation, content-ideas, trend-jacking, experiment-log
recommends
video-shorts, shortform-strategy, shortform-packaging, analytics, content-engine
origin
risco

Shortform Ideation — The Idea Engine and the Bet Ledger

You run the closed loop for a Reels/TikTok/Shorts account: hypothesis → bet → measured outcome → a better next batch. You own the idea list, the priority score, and the experiment ledger.

Your output stops at a ranked, evidenced idea carrying a chosen trend hook and a written hypothesis. The moment you start writing spoken lines or beat timecodes you have crossed into video-shorts — hand off, do not squat.

An idea you cannot defend with (a) this account's own performance log and (b) a dated trend signal is a brainstorm, not a bet. This skill refuses to emit a brainstorm dump.

Decision gate — are you even in ideation?

Read the ask against this table before you generate anything, and hand off by the same table when a request lands outside your column. Why: half the misfires here are scope creep into a sibling that owns the real deliverable.

The askOwnerWhy it is not you
"Give me N ranked ideas / which do we shoot first"yougenerating + scoring + ranking is the core loop
"Fold this week's trending sounds into ideas"youtrend-grounded ideation is the signature move
"Why did the bets we made flop?"youthe outcome ledger ties bet → result; that is yours
"Write the shot-by-shot script / edit sheet for this idea"video-shortsyou stop at the idea + hook angle + chosen sound
"What should our pillars / cadence / positioning be?"shortform-strategyyou consume pillars as input, you do not set them
"Write the caption + hashtags + cover for this finished cut"shortform-packagingyou may suggest a hashtag as a trend signal, not finalize one
"YouTube ideas with thumbnail-first packaging"youtube-ideationthat pipeline is packaging-led and decays slower
"Run the cross-channel calendar across blog/email/social"content-engineyou feed ranked ideas into a calendar, you don't run it
"Build me a metrics dashboard"analyticsyou read the perf log to score ideas, you don't build reporting

The loop — four phases, in order

text
Phase 1 GROUND        Phase 2 SOURCE TRENDS     Phase 3 GENERATE+SCORE   Phase 4 LOG THE BET
read 02-DOCS perf  ─▶ capture dated trend    ─▶ idea = topic × format ─▶ write hypothesis to
log; pull winning     signals (legally, no       × trend-hook × pacing    02-DOCS/shortform/
hooks/formats and     scraping); flag stale      → score → rank backlog   experiments/, leave
proven flops          signals                                             result fields pending

Never skip Phase 1. Ideas not grounded in this account's own data are guesses dressed as a plan. Grounding is what makes the score mean something. Why: a hook that won on a cooking account can die on a B2B SaaS account; only the log tells you which one you are.

Phase 1 — Ground in 02-DOCS

The account's performance log lives at 02-DOCS/shortform/performance.md (or performance.csv). Read it first, every cycle.

Extract four things and keep them in working memory for scoring:

  1. Winning hooks — the opening 1–3s patterns that earned >60% 3s-hold.
  2. Winning formats — talking-head, faceless voiceover, screen-record, skit, listicle — whichever over-indexed.
  3. Dead topics/formats — what under-indexed twice or more. These are negative evidence; do not re-pitch them with a fresh coat of paint.
  4. Best 3s-hold patterns — the specific first-frame moves that held viewers, because the 3s-hold is the metric the whole batch is optimizing for (see Metrics).

If no log exists, bootstrap a minimal one at 02-DOCS/shortform/performance.md with columns date | url | format | hook line | 3s-hold | shares | saves | views | note, seed it with whatever the user can recall, and mark every idea this cycle as unvalidated so the next cycle knows the score was a prior, not a posterior. Why: a missing log is not a reason to guess silently — it is a reason to start measuring.

Capture trending sounds, formats, and hashtags and date every single signal, because short-form trend windows are short and a stale signal is worse than no signal.

Hard rule: never scrape. TikTok Creative Center has no public trends API and automated harvesting violates its ToS (reinforced by the April 2026 rule updates). Trend Discovery (trending songs/hashtags/Top Ads) is browsable in-app without login by switching the region to United States; programmatic access requires the sanctioned Research API or Commercial Content API on developers.tiktok.com. You instruct manual or assisted capture — ask the user to paste the Creative Center view, or read from a sanctioned API — and you bake zero scraping commands into any artifact you emit. Why: a scraper is both a ToS violation and a brittle dependency that breaks the loop.

Four capture lanes, summarized here, with the per-source recipes in references/trend-sources.md:

  • TikTok Creative Center — region-switch to US, and compare 7-day vs 30-day movement. Data refreshes every 24–48h. A sound that only moves on the 30-day view may already be dying; weight 7-day-rising signals higher.
  • Instagram trending audio — the native Trending Audio list is gated to US Professional accounts; a trending sound shows an upward-arrow indicator next to its name in-app. Non-US/non-pro accounts lean on Explore, niche-creator repeat-use, and cross-platform origin tracking.
  • TikTok → Reels lead window — Reels trends often lag TikTok by 3–7 days. A sound viral on TikTok with <5,000 Reels using it on Instagram is a documented head-start window; flag it as early and prioritize it.
  • Niche-creator repeat-use — when 3+ creators in the account's niche reuse the same sound/format inside a week, treat it as a niche-validated signal even before it shows on a global list.

Tag each captured signal: signal | platform | first-seen date | 7d trend | 30d trend | freshness(early|peaking|stale). A signal with no date does not enter Phase 3.

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

Phase 3 — Generate + score

An idea is a product, not a topic:

text
idea = topic × format × trend-hook × pacing-archetype
  • topic — drawn from the account's pillars and winning topics (Phase 1).
  • format — a winning format from the log, or one deliberate experiment.
  • trend-hook — a dated, non-stale signal from Phase 2, or "evergreen" if none fits.
  • pacing-archetype — and a target length, because watch-time-per-length beats raw length: education tolerates +5–10s and proof, entertainment wants 1–2s cuts. Attach a target length so the bet is testable.

Score every idea on a weighted 1–5 rubric. The weights encode what actually drives short-form reach — hook strength and shareability, not topic interest.

CriterionWeightWhat 5 looks like
Hook strength×3first 3s opens a loop / pattern-break that matches a proven winning hook
On-account fit×2topic+format both over-indexed in this account's log; never a proven flop
Trend freshness×27-day-rising sound, or TikTok→Reels early (<5k Reels) window
Shareability / save×2viewer has a clear reason to send or save it (utility, status, "this is so us")
Effort (inverse)×1low production lift; score 5 = shoot today with what you have

weighted_score = 3·hook + 2·fit + 2·fresh + 2·share + 1·(6−effort) → max 50. Rank descending into the backlog.

Backlog table schema (this is the checkable artifact — 02-DOCS/shortform/backlog.md):

idideahook linetrend signal + dateformattarget lenscorestatus
SF-001……… (2026-06-01, 7d↑)……42planned

status ∈ {planned, shooting, posted, killed}.

Bad → Good idea:

  • Bad: "Do a video about our espresso machine." — a topic with no hook, no format, no trend, no score. Unrankable.
  • Good: SF-007 | "The €4 latte lie" cost-breakdown | hook: pour shot + on-screen "your café charges 900% markup" | trend: voiceover-receipt format, TikTok 7d↑, 3k Reels (early) 2026-06-01 | faceless voiceover | 18s | score 45 | planned — a defensible bet with a loop-opening hook, a fresh dated signal, and a save reason (people screenshot the math).

Phase 4 — Log the bet

Every idea you advance to shooting/posted gets a hypothesis file at 02-DOCS/shortform/experiments/<YYYY-MM-DD>-<slug>.md. Schema and a worked before/after example are in references/experiment-ledger.md.

The hypothesis is one falsifiable sentence:

Hypothesis: trend voiceover-receipt + hook "900% markup" will lift 3s-hold above 60% for topic café pricing.

Then leave the result fields pending — result: pending | 3s-hold: __ | hook-rate: __ | shares: __ | saves: __ | verdict: __ — to be filled after the video runs. The next cycle reads these verdicts in Phase 1: a confirmed hypothesis becomes a winning pattern; a falsified one becomes a dead pattern. Why: logging the bet but never the outcome turns the ledger into a graveyard of guesses — the loop only learns if the result loop closes.

To structurally lint an emitted backlog or experiment file, point scripts/verify.sh at it (read-only): bash scripts/verify.sh 02-DOCS/shortform/.

Metrics that matter

Score and judge on these, not on raw views. Why: views are lagging and gameable; these are the levers the algorithm actually rewards.

MetricReadSource fact
3s-hold>60% = strong; <40% = kill the patternup to ~50% drop in first 3s; >60%-hold Reels can out-reach <40% ones by 5–10×
Hook rate~28% is the Meta short-form average; beat ita hook/jump-cut in the first 3s correlates ~72% higher viral likelihood
Shares + savesthe discovery currency — weight in scoringthe algorithm rewards watch-time and shares for distribution
Watch-time-per-lengtha 10s @ 80% beats a 60s @ 30%optimize retention-for-length, not duration

Anti-patterns

Anti-patternWhy it failsDo instead
Brainstorm dump with no scoresunrankable; the user can't decide what to shoot firstalways emit the ranked backlog table with a score per idea
Chasing a 30-day-only trending sound30-day-only movement often means the sound is already dyingweight 7-day-rising; flag 30d-only as stale
Re-pitching a topic the log proved deadignores the account's own negative evidencecheck Phase-1 flops before scoring; never pitch a proven flop
Scraping Creative Center for trendsviolates ToS, breaks the loop, ships brittle codemanual/assisted capture or sanctioned API; zero scrape commands in artifacts
Scoring by topic interest, not hook strengtha fascinating topic with a dead first 3s still flopshook strength carries ×3 weight; score the first frame first
Logging the bet but never the outcomethe loop never learns; next batch re-guessesleave result fields and fill them; Phase 1 reads the verdicts
Writing the full script/timecodes herecrosses into video-shorts; muddies the idea ledgerstop at hook line + chosen sound; hand off
Capturing a trend signal with no datefreshness is unscorable; you may brief a dead soundevery signal carries a first-seen date or it doesn't enter Phase 3

© ericrisco, 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 5 other files (scripts, references) in skills/shortform-ideation of ericrisco/rsc-harness.

  • SKILL.md
  • evals/README.md
  • evals/cases.yaml
  • references/experiment-ledger.md
  • references/trend-sources.md
  • scripts/verify.sh

Open the folder on GitHubat commit e3d5b33

Compare with similar skills

Shortform Ideation 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 Ideation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shortform Ideation this skillericrisco/rsc-harness174—~3.1kAutomated safety check: PassMIT
Viral Short Form Ideasvyralcontent/content-skills1331 repos~2.9kAutomated safety check: PassMIT
Short Publishgug007/lpm152—~3.1kAutomated safety check: PassMIT
Lesson Publishgug007/lpm152—~1.8kAutomated safety check: PassMIT
Analyze Socialccplugins/awesome-claude-code-plugins970—~1.1kAutomated safety check: WarnApache-2.0
Memstack Content Youtube Scriptcwinvestments/memstack423—~3.5kAutomated safety check: PassProprietary

Similar skills

  • Viral Short Form Ideas

    vyralcontent/content-skills

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

    133 GitHub starsUsed in 1 repo~2.9k tokens
    Media & CreativeAuto-check passed
  • Short Publish

    gug007/lpm

    Post a finished vertical lesson from ~/Movies/lpm-lessons/tiktok/<slug/ to YouTube Shorts (LPM channel, through Chrome) and TikTok (@lpm06557, from the user's iPhone through iPhone Mirroring) in…

    152 GitHub stars~3.1k tokensUpdated today
    Media & CreativeAuto-check passed
  • Lesson Publish

    gug007/lpm

    Publish a finished lesson MP4 from ~/Movies/lpm-lessons/<slug/ to the lpm YouTube channel through Chrome (YouTube Studio): search-optimized title and description with chapters, tags, category, the…

    152 GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed
  • Analyze Social

    ccplugins/awesome-claude-code-plugins

    A skill your agent uses when the user shares a social video/post link or local video and wants it understood — an Instagram (instagram.com), TikTok (tiktok.com), YouTube or YouTube Shorts…

    970 GitHub stars~1.1k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: warnings
  • Memstack Content Youtube Script

    cwinvestments/memstack

    A skill your agent uses when the user says 'YouTube script', 'video script', 'write script for YouTube', 'YouTube video outline', or is creating scripted content for a YouTube video with hooks…

    423 GitHub stars~3.5k tokensUpdated 12 days ago
    Media & CreativeAuto-check passed
  • Title Craft

    TheCraigHewitt/skills

    When the user wants to write YouTube video titles, optimize existing titles, A/B test title variants, or improve click-through rate.

    157 GitHub stars~2.1k tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed

More from ericrisco/rsc-harness

All 233 skills in this repo
  • Ab Testing

    ericrisco/rsc-harness

    A skill your agent uses when designing or analyzing a controlled experiment — falsifiable hypothesis, sample size from an MDE, reading significance/CI/power, CUPED, or rescuing tests that won't go…

    174 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Accessibility

    ericrisco/rsc-harness

    A skill your agent uses when making a web UI conform to WCAG 2.2 Level AA — axe-core or Lighthouse a11y violations, keyboard operability, focus management, ARIA roles/names/live regions, contrast…

    174 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • Ads

    ericrisco/rsc-harness

    A skill your agent uses when running or fixing paid acquisition on Google or Meta — campaign structure (Performance Max, Demand Gen, Search, Advantage+), platform-fit creative, budget/scaling rules…

    174 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Agent Eval

    ericrisco/rsc-harness

    A skill your agent uses when measuring whether an LLM or agent system actually got better and gating merges on it: golden sets, fixing an inflated LLM-as-judge, scoring RAG (faithfulness, contextual…

    174 GitHub stars~3.2k tokensUpdated yesterday
    Auto-check passed
  • AI Media

    ericrisco/rsc-harness

    A skill your agent uses when a creative goal must become a finished media file: pick and order generative-media models per modality — AI voiceover, image-to-video clips, score — then glue them with…

    174 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check passed
  • Analytics

    ericrisco/rsc-harness

    A skill your agent uses when instrumenting product or web analytics — GA4/PostHog SDK wiring, event taxonomy, funnels, double-counted events, consent gating, PII scrubbing.

    174 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Shortform Ideation

What does Shortform Ideation do?

A skill your agent uses when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so…. Shortform Ideation is an agent skill from ericrisco/rsc-harness. Use when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch.

When should I use Shortform Ideation?

Shortform Ideation fits situations like: A Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog; grounded in its own performance log plus dated trending sounds; each bet logged so its outcome feeds the next batch.

How do I install Shortform Ideation in Claude Code?

Run `npx skills add ericrisco/rsc-harness --skill shortform-ideation -a claude-code`. Or copy the skill folder (skills/shortform-ideation in ericrisco/rsc-harness) into .claude/skills/shortform-ideation in your project. Claude Code loads it when a task matches its description.

How do I install Shortform Ideation in Codex?

Run `npx skills add ericrisco/rsc-harness --skill shortform-ideation -a codex`. Or copy the skill folder (skills/shortform-ideation in ericrisco/rsc-harness) into .agents/skills/shortform-ideation in your project. Codex loads it when a task matches its description.

Can I use Shortform Ideation 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 ericrisco/rsc-harness --skill shortform-ideation -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-ideation, .gemini/skills/shortform-ideation, .github/skills/shortform-ideation and .opencode/skills/shortform-ideation in your project.

What does Shortform Ideation need to run?

Going by SKILL.md and its folder, Shortform Ideation needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell.

Does Shortform Ideation 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 Ideation 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 Ideation use?

Shortform Ideation 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 Ideation use?

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

What are the alternatives to Shortform Ideation?

Skills that share tags, products or a category with Shortform Ideation: Viral Short Form Ideas (vyralcontent/content-skills, 133 stars), Short Publish (gug007/lpm, 152 stars), Lesson Publish (gug007/lpm, 152 stars) and Analyze Social (ccplugins/awesome-claude-code-plugins, 970 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shortform Ideation?

ericrisco (a GitHub user) maintains it in ericrisco/rsc-harness, which has 174 GitHub stars. The repository holds 233 skills in this directory. The repository was last updated on October 7, 2026.

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