Plot Twist Structure Tool skill for Claude and Codex
Maps a twist across setup, misdirection, reveal, and aftermath so every surprise is earned by cause and effect, with clue placement noted.
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when a writer has a twist idea and needs it structured into setup, misdirection, reveal, and aftermath with clue placement. Do not use for inventing a twist from scratch in two sentences or writing the scene itself. Related topics: writing, creative, plot.
What it will ask you for
- Genre (choose one: Fantasy, Science Fiction, Mystery, Thriller, Romance, Historical)
- Protagonist goal (free text, e.g. "What the hero wants")
- Central conflict (longer free text)
- Twist type (choose any: Character betrayal, Hidden lineage, False reality, Secret agenda, Unexpected death)
- Reveal point (choose one: Act 2 climax, Act 3 opening, Final chapter, Midpoint)
- Tone (choose one: Dark, Light, Satirical, Grim, Hopeful)
How it works
- Define what the reader must believe just before the reveal and what the truth is.
- List the facts to plant in Setup so the reveal is fair, and mark where each clue goes.
- Design Misdirection as an honest competing explanation that fits the genre and tone.
- Write the Twist Reveal beats at the chosen reveal point, showing the cause that triggers it.
- Write the Aftermath beats showing how the goal or conflict changes, keeping every bullet under 20 words.
What you get
A markdown document with sections Setup, Misdirection, Twist Reveal, and Aftermath, each with 3 to 5 hyphen bullets under 20 words, including clue placement.
What it watches out for
- Planting no clues, so the reveal feels like a cheat.
- Misdirection built on a character lying for no reason, which breaks trust.
- Aftermath that restores the status quo instead of changing the protagonist's goal.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.