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

Theme, controlling idea, premise, moral argument

Theme craft

by danjdewhurst · MIT license · ★ 241 on GitHub · updated Sep 22

Theme craft cover

This skill should be used when the user asks to "theme", "controlling idea", "premise", "moral argument", "character arc", "flat arc", "negative arc", "the lie", "antagonist design", "motif", "symbolism", "theme audit", or wants to…

---
name: theme-craft
description: This skill should be used when the user asks to "theme", "controlling idea", "premise", "moral argument", "character arc", "flat arc", "negative arc", "the lie", "antagonist design", "motif", "symbolism", "theme audit", or wants to plan, track, or revise the thematic layer of a story.
---

# Theme Craft

## Overview

Plan and audit theme as a working mechanism, not decoration. Covers the
controlling idea (value + cause, in McKee's sense), the lie/truth machinery
and the three canonical arc types, antagonist design as the embodied
counter-argument, motif tracking, and a revision-time theme audit. Use at
story start (working premise), during character design (lie/truth/arc-type),
and after a complete draft (theme audit).

## Prerequisites

Overview

Plan and audit theme as a working mechanism, not decoration. Covers the controlling idea (value + cause, in McKee's sense), the lie/truth machinery and the three canonical arc types, antagonist design as the embodied counter-argument, motif tracking, and a revision-time theme audit. Use at story start (working premise), during character design (lie/truth/arc-type), and after a complete draft (theme audit).

The SKILL.md below is the copy AgentAlley read and checked. The repo has changed it since; the other files are from commit 28817a2.

Manual install (npx, ZIP)
Claude Codenpx skills add danjdewhurst/story-skills --skill theme-craft -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/danjdewhurst/story-skills/tar.gz/28817a272657 \ | tar -xz -C ~/.claude/skills --strip-components=2 story-skills-28817a272657/skills/theme-craft
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/fa7bef2eb3cbed5fbc8a/theme-craft.zip" -OutFile "$env:TEMP\theme-craft.zip"; Expand-Archive "$env:TEMP\theme-craft.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP 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.md5.6 KB
  • references/5 files · 16.2 KB
Read the files here
danjdewhurst/28817a26 files
Shared references2SKILL.md reads these from elsewhere in the repo. Not in the ZIP.Get them on GitHub ↗
SKILL.md
Show the full text113 lines

Theme Craft

Overview

Plan and audit theme as a working mechanism, not decoration. Covers the controlling idea (value + cause, in McKee's sense), the lie/truth machinery and the three canonical arc types, antagonist design as the embodied counter-argument, motif tracking, and a revision-time theme audit. Use at story start (working premise), during character design (lie/truth/arc-type), and after a complete draft (theme audit).

Prerequisites

A story project must already exist (created via the story-init skill). Character files (character-management) and a plot structure (plot-structure) should exist or be in progress.

Workflow

  1. Draft the working premise. Read story.md for genre and themes. Consult references/controlling-idea.md and write a one-sentence premise (value + cause) and counter-premise. Store them in story.md frontmatter:

    premise: "{Value} triumphs because {cause}."
    counter-premise: "{Opposing value} triumphs because {opposing cause}."
    

    If the user prefers discovering theme in the draft, record premise: tbd-discovery and skip to step 3.

  2. Build the lie/truth machinery. For the protagonist and antagonist (and any significant supporting character whose arc touches the theme), consult references/lie-truth.md and add to their character files:

    arc-type is one of change-positive, change-negative, or flat. Do not put that list in an inline comment. The frontmatter parser keeps the comment as part of the value.

    arc-type: change-positive
    lie: "{The false belief}"
    truth: "{The belief that resolves it}"
    ghost-wound: "{The specific backstory event that planted the lie}"
    

    Check the character's turning points against the arc-type guidance: flat arcs need escalating tests of steadfastness, not growth beats; negative arcs need the truth visibly refused.

  3. Design the antagonist as the counter-argument. Consult references/antagonist-design.md: give the antagonist an edge, a defensible belief in the counter-premise, a want/wound/plan, and scenes they win. When the opposition is institutional, personify it.

  4. Plant motifs. Consult references/motif-symbolism.md; choose two or three concrete motifs, plant them literally, and track plantings, variations, and ending resonance in the motif ledger.

  5. Use the premise while drafting. When a scene decision is unclear, ask which choice engages the value continuum and costs the protagonist something. Feed the lie into scene sequels (see the scene-craft skill): the sequel is where the lie gets examined.

  6. Run the theme audit in revision. After a complete draft, consult references/theme-audit.md: trace the value through the draft, check the ending against the opening's value-question, verify theme is dramatized through consequence not commentary, and confirm motifs are paid off. Record findings in continuity/theme-audit.md with a theme-holds / theme-broken verdict. Hand structural findings to the revision-continuity skill as a developmental revision plan.

Conventions

  • premise: / counter-premise: live in story.md frontmatter and are the single source of truth for the story's theme; plot/_index.md theme tracking maps themes to arcs and chapters as before.
  • Character arc-type values are kebab-case from the fixed set (change-positive, change-negative, flat); lie, truth, and ghost-wound are one-line strings.
  • Motif ids are kebab-case and tracked in the motif ledger with planned / planted / paid-off status.
  • Theme is dramatized through choices and consequences. Never add a character speech, narration summary, or mentor lecture explaining the theme to satisfy an audit finding — rework the choices instead.

CLI Maintenance

Use the Story CLI when it is available. If story is not installed, use bun run story -- from the Story Skills repository checkout or the bundled fallback node ../story-maintenance/scripts/story.js with the same arguments, resolving the path relative to this skill folder. If no CLI is available, perform the registry, backlink, and word-count checks manually.

After adding or changing premise fields, character arc fields, or the theme audit:

story reindex .
story links .
story validate .

The motif ledger (continuity/motifs.md or the motif table in an arc file) and continuity/theme-audit.md are prose revision notes: the CLI does not scan, validate, link-check, or reindex them. Audit motif payoff and the theme verdict manually per references/theme-audit.md.

Reference Files

  • references/controlling-idea.md - The controlling idea as value + cause (McKee), counter-premise, working-premise workflow
  • references/lie-truth.md - Lie, truth, ghost wound, and the three arc types (change-positive, change-negative, flat)
  • references/antagonist-design.md - Worthy opponent, antagonist as counter-argument, plan-the-antagonist-as-protagonist, personified institutions
  • references/motif-symbolism.md - Plant-and-vary, object-symbol resonance with the ending, motif ledger
  • references/theme-audit.md - Revision audit: ending vs. opening value-question, consequence vs. commentary, motif payoff
1---
2name: theme-craft
3description: This skill should be used when the user asks to "theme", "controlling idea", "premise", "moral argument", "character arc", "flat arc", "negative arc", "the lie", "antagonist design", "motif", "symbolism", "theme audit", or wants to plan, track, or revise the thematic layer of a story.
4---
5 
6# Theme Craft
7 
8## Overview
9 
10Plan and audit theme as a working mechanism, not decoration. Covers the
11controlling idea (value + cause, in McKee's sense), the lie/truth machinery
12and the three canonical arc types, antagonist design as the embodied
13counter-argument, motif tracking, and a revision-time theme audit. Use at
14story start (working premise), during character design (lie/truth/arc-type),
15and after a complete draft (theme audit).
16 
17## Prerequisites
18 
19A story project must already exist (created via the story-init skill).
20Character files (character-management) and a plot structure
21(plot-structure) should exist or be in progress.
22 
23## Workflow
24 
251. **Draft the working premise.** Read `story.md` for genre and themes.
26 Consult `references/controlling-idea.md` and write a one-sentence
27 premise (value + cause) and counter-premise. Store them in `story.md`
28 frontmatter:
29 
30 ```yaml
31 premise: "{Value} triumphs because {cause}."
32 counter-premise: "{Opposing value} triumphs because {opposing cause}."
33 ```
34 
35 If the user prefers discovering theme in the draft, record
36 `premise: tbd-discovery` and skip to step 3.
372. **Build the lie/truth machinery.** For the protagonist and antagonist
38 (and any significant supporting character whose arc touches the theme),
39 consult `references/lie-truth.md` and add to their character files:
40 
41 `arc-type` is one of `change-positive`, `change-negative`, or `flat`.
42 Do not put that list in an inline comment. The frontmatter parser keeps
43 the comment as part of the value.
44 
45 ```yaml
46 arc-type: change-positive
47 lie: "{The false belief}"
48 truth: "{The belief that resolves it}"
49 ghost-wound: "{The specific backstory event that planted the lie}"
50 ```
51 
52 Check the character's turning points against the arc-type guidance:
53 flat arcs need escalating tests of steadfastness, not growth beats;
54 negative arcs need the truth visibly refused.
553. **Design the antagonist as the counter-argument.** Consult
56 `references/antagonist-design.md`: give the antagonist an edge, a
57 defensible belief in the counter-premise, a want/wound/plan, and
58 scenes they win. When the opposition is institutional, personify it.
594. **Plant motifs.** Consult `references/motif-symbolism.md`; choose two or
60 three concrete motifs, plant them literally, and track plantings,
61 variations, and ending resonance in the motif ledger.
625. **Use the premise while drafting.** When a scene decision is unclear, ask
63 which choice engages the value continuum and costs the protagonist
64 something. Feed the lie into scene sequels (see the `scene-craft`
65 skill): the sequel is where the lie gets examined.
666. **Run the theme audit in revision.** After a complete draft, consult
67 `references/theme-audit.md`: trace the value through the draft, check
68 the ending against the opening's value-question, verify theme is
69 dramatized through consequence not commentary, and confirm motifs are
70 paid off. Record findings in `continuity/theme-audit.md` with a
71 `theme-holds` / `theme-broken` verdict. Hand structural findings to the
72 `revision-continuity` skill as a developmental revision plan.
73 
74## Conventions
75 
76- `premise:` / `counter-premise:` live in `story.md` frontmatter and are the
77 single source of truth for the story's theme; `plot/_index.md` theme
78 tracking maps themes to arcs and chapters as before.
79- Character `arc-type` values are kebab-case from the fixed set
80 (`change-positive`, `change-negative`, `flat`); `lie`, `truth`, and
81 `ghost-wound` are one-line strings.
82- Motif ids are kebab-case and tracked in the motif ledger with
83 `planned` / `planted` / `paid-off` status.
84- Theme is dramatized through choices and consequences. Never add a
85 character speech, narration summary, or mentor lecture *explaining* the
86 theme to satisfy an audit finding — rework the choices instead.
87 
88## CLI Maintenance
89 
90Use the Story CLI when it is available. If `story` is not installed, use `bun run story --` from the Story Skills repository checkout or the bundled fallback `node ../story-maintenance/scripts/story.js` with the same arguments, resolving the path relative to this skill folder. If no CLI is available, perform the registry, backlink, and word-count checks manually.
91 
92After adding or changing premise fields, character arc fields, or the theme
93audit:
94 
95```shell
96story reindex .
97story links .
98story validate .
99```
100 
101The motif ledger (`continuity/motifs.md` or the motif table in an arc file)
102and `continuity/theme-audit.md` are prose revision notes: the CLI does not
103scan, validate, link-check, or reindex them. Audit motif payoff and the
104theme verdict manually per `references/theme-audit.md`.
105 
106## Reference Files
107 
108- **`references/controlling-idea.md`** - The controlling idea as value + cause (McKee), counter-premise, working-premise workflow
109- **`references/lie-truth.md`** - Lie, truth, ghost wound, and the three arc types (change-positive, change-negative, flat)
110- **`references/antagonist-design.md`** - Worthy opponent, antagonist as counter-argument, plan-the-antagonist-as-protagonist, personified institutions
111- **`references/motif-symbolism.md`** - Plant-and-vary, object-symbol resonance with the ending, motif ledger
112- **`references/theme-audit.md`** - Revision audit: ending vs. opening value-question, consequence vs. commentary, motif payoff
113 
View all files on GitHub →

Details

Updated
Sep 22, 2026
License
MIT
Stars on the repo
★ 241
Checked
Source
danjdewhurst/story-skills ↗
Creator
danjdewhurst · 13 listings
View creator

Similar skills

See all →
SkillReverse engineer native, managed, Electron/JavaScriptREAmorluto/rea · by morlutoReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.★ 316k GitHub starsSkillBrainstorms ideas into designs before any creative workBrainstorming Ideas Into Designsobra/superpowers · by obraYou MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.★ 290k GitHub starsSkillRequires technical rigor and verificationCode Review Receptionobra/superpowers · by obraUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation★ 290k GitHub starsSkillDiagnosis loop for hard bugs and performance regressionsDiagnosing bugsmattpocock/skills · by mattpocockDiagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.★ 267k GitHub starsSkillImplement the result of /to-spec and /to-tickets in codeImplement specmattpocock/skills · by mattpocockImplement the result of /to-spec and /to-tickets in code.★ 267k GitHub starsSkillWriting a PR bodymattpocock/skills · by mattpocockUse when writing a PR body.★ 267k GitHub stars

More from danjdewhurst

SkillWrite a chapter, next chapter, chapter outlineChapter writingdanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "write a chapter", "next chapter", "chapter outline", "draft chapter", "continue the story", "write a scene", "outline a chapter", or wants to write prose for a story project.★ 241 GitHub starsSkillCreate a character, update a character, add a characterCharacter managementdanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "create a character", "update a character", "add a character", "build a family tree", "character relationships", "character timeline", "character arc", "character profile", or needs to manage characters in a story project.★ 241 GitHub starsSkillPantsing, discovery write, write without an outlineDiscovery draftingdanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "pantsing", "discovery write", "write without an outline", "discovery draft", "write into the dark", "story kernel", "reconcile a chapter", "reverse outline", "cut a subplot", "dead end", "drafting sprint", "writing cadence", or wants to draft a story by discovery with retrospective bible reconciliation.★ 241 GitHub starsSkillProcess beta reader feedback, alpha reader feedbackFeedback triagedanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "process beta reader feedback", "alpha reader feedback", "feedback round", "synthesize reader feedback", "reader notes", "beta feedback", "readiness check", or wants to collect, reconcile, and act on external reader feedback for a story project.★ 241 GitHub starsSkillMystery, fair play, clue, red herring, romance beats, HEAGenre craftdanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "mystery", "fair play", "clue", "red herring", "romance beats", "HEA", "thriller", "ticking clock", "horror", "dread", "MG", "YA", "middle grade", "young adult", "science fiction", "sci-fi", "serial", "episodic", "web serial", "genre conventions", or wants genre-specific structural craft for a story project.★ 241 GitHub starsSkillCreate a plot arc, story structure, add a plot pointPlot structuredanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "create a plot arc", "story structure", "add a plot point", "story timeline", "track foreshadowing", "pacing", "act structure", "story arc", "plot outline", or wants to plan and manage the narrative structure of a story.★ 241 GitHub stars