Genre craft
This 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.
How to use it
Claude Code
- Run the line below. It pulls the whole folder into
~/.claude/skills/genre-craft, including the files SKILL.md points to. - Describe your job in plain words. Claude Code follows the skill from there.
npx degit danjdewhurst/story-skills/skills/genre-craft#main ~/.claude/skills/genre-craftFor one project only, change the path to .claude/skills/genre-craft. This skill also uses story.md, _index.md — copying SKILL.md alone won't be enough. See the folder on GitHub.
Claude (web or desktop app)
- On this page open ⋯ → Download .md.
- Save it as SKILL.md in a folder, zip the folder, then Customize → Skills → + → Create skill → Upload a skill.
- Pick the file and Save. Claude shows the name and description and runs a security scan.
- Check the skill is switched on.
- Start a new chat and describe your job in plain words. The AI follows the skill from there.
ChatGPT or another app
- ChatGPT: make a Project and paste it into Instructions.
- Neither? Paste it at the top of a new chat — it works for that chat.
Not working?
- Check which app you pasted it into — the steps above name the right one.
- Some skills need the paid tier of Claude or ChatGPT.
Paste into Claude, ChatGPT or Cursor.
Source of Genre craft
Show the full text112 lines
| name | description |
|---|---|
| genre-craft | This 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. |
Genre Craft
Overview
Genre-specific structural packs: the codified craft each genre expects, as checkable rules, ledgers, and audits. Packs cover mystery (fair play + clue ledger), romance (beats + HEA contract), thriller (ticking clock, power imbalance, set pieces), horror (dread/terror ordering, monster rules), MG/YA (category constraints), science fiction (load-bearing speculative elements), and serial/episodic structure. Use at story-init (pick the pack, set the constraints) and in revision (run the pack's audit).
Prerequisites
A story project must already exist (created via the story-init skill) with
its genre recorded in story.md. A plot structure (plot-structure) should
exist or be in progress.
When to Use
- Starting or re-categorizing a story in one of the covered genres
- Planning genre load-bearing elements (clues, clocks, season goals)
- Auditing a draft against its genre's contract
- NOT for line-level genre voice (that belongs to the
better-writingskill's genre work); these packs are structural - NOT for literary fiction as a pack — its conventions resist deterministic encoding by design
Workflow
- Pick the pack. Read
story.mdfor genre/sub-genre and load the matching reference:- Mystery / crime / detective →
references/mystery-fair-play.md - Romance →
references/romance-beats.md - Thriller / action / suspense →
references/thriller.md - Horror →
references/horror.md - Middle grade / young adult →
references/mg-ya.md - Science fiction →
references/scifi-pipeline.md - Serial / episodic / web serial →
references/serial-episodic.md - Multi-genre stories: load each applicable pack; where packs conflict
(e.g. horror's slow dread vs. thriller's cliffhangers), decide with
the user which genre's contract dominates per section and record the
decision in
story.mdnotes.
- Mystery / crime / detective →
- Set the constraints up front. Apply the pack's structural
requirements during planning:
- Mystery: create
continuity/clues/and ledger every clue and red herring viastory add clue "..." --planted chapter-NN --payoff chapter-NN, withsignificance-delayedfrontmatter where the reader sees the clue before understanding it. - Thriller: log every promised deadline in
continuity/promises/and track story-time inplot/timeline.md. - Serial: record
season-goal:instory.mdandepisode-question:in each installment's frontmatter. - MG/YA: record
target-words:instory.mdand check the category constraints (protagonist age, minimized adult involvement). - Sci-fi: write the speculative element's rules, costs, and limits in
worldbuilding/systems/before the climax exploits them.
- Mystery: create
- Draft against the pack. Use the pack's beat concepts and rules
alongside the
chapter-writingworkflow and thescene-craftscene-grain tools. Cross-link thriller pacing to the Fichtean curve note inreferences/thriller.md; cross-link serial book-level canon to theseries-continuityskill. - Run the pack audit in revision. Each reference ends with an audit
checklist. Run it as part of a developmental revision pass (see the
revision-continuityskill) and record findings in the revision plan. - Record genre decisions. Any deliberate deviation from the pack (a
romance without a black moment, a mystery that withholds) is a story
decision: note it in
story.mdwith the reason, so later audits don't "fix" it.
Conventions
- Pack-specific entities use the project conventions: kebab-case ids,
YAML frontmatter,
_index.mdregistries where a collection exists (continuity/clues/follows thecontinuity/promises/pattern). - Clue
plantedmust precedepayoff(story continuityflags payoff-before- plant as an error); deadline promises follow the same ordering logic as promise/question ordering. - Bidirectional links apply: clues link suspects and chapters; suspects' character files link back to the clue ids that implicate or clear them.
- Genre audits live in the revision plan or
continuity/audit files — never only in chat.
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 genre entities (clues, deadlines, season goals, episode questions):
story reindex .
story links .
story validate .
story continuity .
Reference Files
references/mystery-fair-play.md- Fair-play doctrine, clue-planting techniques, red-herring discipline, gather-suspects reveal, clue ledger conventionreferences/romance-beats.md- Widely-published romance beat concepts (paraphrased), HEA/HFN reader contract, the black momentreferences/thriller.md- Ticking clock honored once promised, power imbalance, set pieces, mini-cliffhanger endings, Fichtean curve pairingreferences/horror.md- Dread vs. terror vs. gross-out ordering, the uncanny, monster rules stated early, recovery periodsreferences/mg-ya.md- Word-count norms, age-appropriate voice/stakes, minimized adult involvement, content boundariesreferences/scifi-pipeline.md- Speculative element must be load-bearing, rules stated before exploited, worldbuilding→plot pipelinereferences/serial-episodic.md- Season/volume goal, per-episode dramatic question, a reward in every installment, recap discipline
| 1 | |
| 2 | name genre-craft |
| 3 | description This 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. |
| 4 | |
| 5 | |
| 6 | # Genre Craft |
| 7 | |
| 8 | ## Overview |
| 9 | |
| 10 | Genre-specific structural packs: the codified craft each genre expects, as |
| 11 | checkable rules, ledgers, and audits. Packs cover mystery (fair play + clue |
| 12 | ledger), romance (beats + HEA contract), thriller (ticking clock, power |
| 13 | imbalance, set pieces), horror (dread/terror ordering, monster rules), |
| 14 | MG/YA (category constraints), science fiction (load-bearing speculative |
| 15 | elements), and serial/episodic structure. Use at story-init (pick the pack, |
| 16 | set the constraints) and in revision (run the pack's audit). |
| 17 | |
| 18 | ## Prerequisites |
| 19 | |
| 20 | A story project must already exist (created via the story-init skill) with |
| 21 | its genre recorded in `story.md`. A plot structure (plot-structure) should |
| 22 | exist or be in progress. |
| 23 | |
| 24 | ## When to Use |
| 25 | |
| 26 | Starting or re-categorizing a story in one of the covered genres |
| 27 | Planning genre load-bearing elements (clues, clocks, season goals) |
| 28 | Auditing a draft against its genre's contract |
| 29 | NOT for line-level genre voice (that belongs to the `better-writing` |
| 30 | skill's genre work); these packs are structural |
| 31 | NOT for literary fiction as a pack — its conventions resist deterministic |
| 32 | encoding by design |
| 33 | |
| 34 | ## Workflow |
| 35 | |
| 36 | **Pick the pack.** Read `story.md` for genre/sub-genre and load the |
| 37 | matching reference: |
| 38 | Mystery / crime / detective → `references/mystery-fair-play.md` |
| 39 | Romance → `references/romance-beats.md` |
| 40 | Thriller / action / suspense → `references/thriller.md` |
| 41 | Horror → `references/horror.md` |
| 42 | Middle grade / young adult → `references/mg-ya.md` |
| 43 | Science fiction → `references/scifi-pipeline.md` |
| 44 | Serial / episodic / web serial → `references/serial-episodic.md` |
| 45 | Multi-genre stories: load each applicable pack; where packs conflict |
| 46 | (e.g. horror's slow dread vs. thriller's cliffhangers), decide with |
| 47 | the user which genre's contract dominates per section and record the |
| 48 | decision in `story.md` notes. |
| 49 | **Set the constraints up front.** Apply the pack's structural |
| 50 | requirements during planning: |
| 51 | Mystery: create `continuity/clues/` and ledger every clue and red |
| 52 | herring via `story add clue "..." --planted chapter-NN --payoff |
| 53 | chapter-NN`, with `significance-delayed` frontmatter where the reader |
| 54 | sees the clue before understanding it. |
| 55 | Thriller: log every promised deadline in `continuity/promises/` and |
| 56 | track story-time in `plot/timeline.md`. |
| 57 | Serial: record `season-goal:` in `story.md` and `episode-question:` |
| 58 | in each installment's frontmatter. |
| 59 | MG/YA: record `target-words:` in `story.md` and check the category |
| 60 | constraints (protagonist age, minimized adult involvement). |
| 61 | Sci-fi: write the speculative element's rules, costs, and limits in |
| 62 | `worldbuilding/systems/` before the climax exploits them. |
| 63 | **Draft against the pack.** Use the pack's beat concepts and rules |
| 64 | alongside the `chapter-writing` workflow and the `scene-craft` |
| 65 | scene-grain tools. Cross-link thriller pacing to the Fichtean curve |
| 66 | note in `references/thriller.md`; cross-link serial book-level canon |
| 67 | to the `series-continuity` skill. |
| 68 | **Run the pack audit in revision.** Each reference ends with an audit |
| 69 | checklist. Run it as part of a developmental revision pass (see the |
| 70 | `revision-continuity` skill) and record findings in the revision plan. |
| 71 | **Record genre decisions.** Any deliberate deviation from the pack (a |
| 72 | romance without a black moment, a mystery that withholds) is a story |
| 73 | decision: note it in `story.md` with the reason, so later audits don't |
| 74 | "fix" it. |
| 75 | |
| 76 | ## Conventions |
| 77 | |
| 78 | Pack-specific entities use the project conventions: kebab-case ids, |
| 79 | YAML frontmatter, `_index.md` registries where a collection exists |
| 80 | (`continuity/clues/` follows the `continuity/promises/` pattern). |
| 81 | Clue `planted` must precede `payoff` (`story continuity` flags payoff-before- |
| 82 | plant as an error); deadline promises follow the same ordering logic as |
| 83 | promise/question ordering. |
| 84 | Bidirectional links apply: clues link suspects and chapters; suspects' |
| 85 | character files link back to the clue ids that implicate or clear them. |
| 86 | Genre audits live in the revision plan or `continuity/` audit files — |
| 87 | never only in chat. |
| 88 | |
| 89 | ## CLI Maintenance |
| 90 | |
| 91 | 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. |
| 92 | |
| 93 | After adding or changing genre entities (clues, deadlines, season goals, |
| 94 | episode questions): |
| 95 | |
| 96 | |
| 97 | story reindex . |
| 98 | story links . |
| 99 | story validate . |
| 100 | story continuity . |
| 101 | |
| 102 | |
| 103 | ## Reference Files |
| 104 | |
| 105 | **`references/mystery-fair-play.md`** - Fair-play doctrine, clue-planting techniques, red-herring discipline, gather-suspects reveal, clue ledger convention |
| 106 | **`references/romance-beats.md`** - Widely-published romance beat concepts (paraphrased), HEA/HFN reader contract, the black moment |
| 107 | **`references/thriller.md`** - Ticking clock honored once promised, power imbalance, set pieces, mini-cliffhanger endings, Fichtean curve pairing |
| 108 | **`references/horror.md`** - Dread vs. terror vs. gross-out ordering, the uncanny, monster rules stated early, recovery periods |
| 109 | **`references/mg-ya.md`** - Word-count norms, age-appropriate voice/stakes, minimized adult involvement, content boundaries |
| 110 | **`references/scifi-pipeline.md`** - Speculative element must be load-bearing, rules stated before exploited, worldbuilding→plot pipeline |
| 111 | **`references/serial-episodic.md`** - Season/volume goal, per-episode dramatic question, a reward in every installment, recap discipline |
| 112 |
Discussion
Browse more free Claude skills.