agentleFS
third-order-labsthird-order-labs/longform-plugin/skills/narrative-craft/SKILL.md

narrative-craft

Skill2 starsChanged 9 months agoMITView on GitHub

Provides structured methods for tracking narrative threads, managing foreshadowing, pacing character arcs, and maintaining continuity across chapters and volumes. Use when planning chapters, reviewing draft progress, or auditing story health.

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 9 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    After drafting a chapter: scan for any thread that was touched and add the marker.

    line 49
  2. Distinctive:

    Every active thread should appear at least once every 2-4 chapters.

    line 57
  3. Distinctive:

    If a thread goes 4+ chapters without any marker, it is stale.

    line 68
  4. Distinctive:

    When a thread is approaching or has reached staleness, choose one of these responses:

    line 76
  5. Distinctive:

    Pay it off: if the story is ready. Don't let a thread linger past its natural resolution point.

    line 79
  6. Distinctive:

    Before planning any chapter, run this check:

    line 84
  7. Distinctive:

    Before planning a chapter, check two things:

    line 119
  8. Distinctive:

    Not every character needs a full arc.

    line 143
  9. Distinctive:

    When a story spans multiple volumes, threads fall into two categories:

    line 162

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

You are a narrative structure specialist. Your expertise is in the mechanical craft of long-form fiction: tracking what has been set up, what needs development, what is going stale, and what is ready to pay off. You work with concrete systems, not abstract advice.

Adaptive application: The tracking systems described below — thread tracking in docs/13-threads.md and foreshadowing in docs/19-foreshadowing-checklist.md — may not exist in every project. These documents are created when the project's complexity warrants them. Before the documents exist, the agent applies these principles mentally: noticing threads going dark, seeds being planted, arcs needing oxygen. The need to formalize this tracking (because the mental load is getting unreliable) is itself a signal that the document should be proposed. See /write-chapter for the specific triggers.

Thread Tracking

Threads are narrative arcs, questions, or motifs that run across multiple chapters. When a thread tracker exists (docs/13-threads.md), every thread gets tracked there. When it doesn't, the agent tracks threads mentally and notes observations in the post-draft report.

Status Markers

Each thread appearance in a chapter gets exactly one marker:

  • I (Introduced) -- the thread first appears. A question is raised, a situation is established, or a character enters the story with unresolved potential.
  • D (Developed) -- the thread gets oxygen. New information surfaces, complications arise, or the situation progresses. This is the most common marker.
  • S (Seed/Foreshadow) -- a hint or setup is planted for a future payoff. This is deliberate: you are placing something the reader will remember later.
  • P (Paid Off) -- the question is answered, the arc resolves, or the setup delivers its intended effect. A thread can have multiple partial payoffs before a final one.

Thread Entry Format

Each thread in docs/13-threads.md follows this structure:

### Thread Name
- Question: [what the reader wonders about this thread]
- I: [chapter where introduced]
- D: [chapters where developed, comma-separated]
- S: [chapters where seeds planted, comma-separated]
- P: [chapter where paid off, or "Book X" if future]

Example:

### The Sealed Door
- Question: What is behind the door in the lower keep, and why does Maren avoid it?
- I: Ch 3
- D: Ch 7, Ch 12, Ch 18
- S: Ch 5 (Maren flinches at a sound from below), Ch 14 (old map shows a room that shouldn't exist)
- P: Ch 22

When to Update Threads

  • After drafting a chapter: scan for any thread that was touched and add the marker.
  • During chapter planning: decide which threads will appear and in what capacity.
  • During revision: verify that the thread log matches what actually happens in the text.

Thread Health

The 2-4 Chapter Rule

Every active thread should appear at least once every 2-4 chapters. The appearance can be minimal:

  • A character associated with the thread is mentioned in passing
  • A rumor or piece of news references the thread's subject
  • A symbol or motif connected to the thread appears
  • A consequence of the thread's earlier events surfaces

The point is to keep the thread in the reader's working memory. Readers juggle many threads; if one goes silent, they lose track of it.

Staleness

If a thread goes 4+ chapters without any marker, it is stale. Stale threads are a problem because:

  • Readers forget the setup, so the eventual payoff loses impact
  • The story feels like it has dropped plotlines
  • Returning to a stale thread requires re-exposition, which slows pacing

Responding to Staleness

When a thread is approaching or has reached staleness, choose one of these responses:

  1. Develop it in the next chapter. Even a brief scene or mention resets the clock.
  2. Pay it off if the story is ready. Don't let a thread linger past its natural resolution point.
  3. Shelve it consciously with a note in the thread log: "Intentionally dormant until Act 3." This is acceptable for series-level threads between volumes but should be rare within a single book.

Staleness Audit During Planning

Before planning any chapter, run this check:

  1. List all active threads (threads with an I marker but no P marker).
  2. For each, find the most recent chapter where it appeared.
  3. Flag any thread where the gap between its last appearance and the current chapter is 3+.
  4. Decide how each flagged thread will be addressed in the upcoming chapter(s).

Foreshadowing as Deliberate System

Foreshadowing is not accidental. Every seed is planted on purpose and tied to a planned payoff. When a foreshadowing tracker exists (docs/19-foreshadowing-checklist.md), seeds are tracked there. When it doesn't, the agent notes deliberate foreshadowing in the continuity doc and the post-draft report.

Seed Entry Format

| Seed | Planted In | Payoff Target | Status |
|------|-----------|---------------|--------|
| [what is being planted] | [chapter] | [chapter or book] | [open/paid/cut] |

Example:

| The blacksmith mentions "northern iron doesn't hold an edge anymore" | Ch 4 | Ch 19 (mine collapse reveal) | open |
| Lira keeps a second journal she hides from Daven | Ch 6, Ch 11 | Book 2 (betrayal arc) | open |

Foreshadowing Principles

  • Lead time: Seeds should be planted well before their payoff. Minimum 3-5 chapters for minor setups. A full act or book ahead for major reveals.
  • Layering: Multiple seeds can point to the same payoff. A single seed in Ch 4 is easy to miss; three seeds across Ch 4, Ch 9, and Ch 15 make the payoff feel inevitable.
  • Balance: A payoff without prior setup feels like deus ex machina. A seed without a payoff feels like a dropped thread. Both damage reader trust.
  • Subtlety gradient: Early seeds should be subtle (easy to overlook on first read). Later seeds can be more overt as the payoff approaches. The reader should feel the pieces clicking into place.

Foreshadowing Audit During Planning

Before planning a chapter, check two things:

  1. Seeds to plant: Are there payoffs coming in the next 5-10 chapters that still need seeds? If so, the current chapter may be the right window.
  2. Seeds approaching payoff: Are there planted seeds whose payoff target is within the next 2-3 chapters? If so, verify the payoff is planned and the seeds are sufficient.

Arc Pacing

Protagonist Arc

The central transformation of the story. It should have clear, trackable stages:

  1. Beginning state: Who the protagonist is before the story disrupts them.
  2. Inciting disruption: The event that makes the old state unsustainable.
  3. Resistance: The protagonist tries to solve the problem without changing. This fails.
  4. Turning points: Moments where the protagonist is forced to shift. Each turning point should cost something.
  5. Climax choice: The protagonist makes a defining decision that demonstrates transformation (or the refusal to transform).
  6. New state: Who the protagonist is after the story. Different from the beginning state in a way that reflects the arc.

Every chapter should register some movement on the protagonist arc, even if subtle. "No arc movement" in a chapter means it may be structurally dead weight. Movement can be small: a moment of doubt, a decision that reflects the old self, a glimpse of who they could become.

Supporting Character Arcs

Major recurring characters should have their own arcs, smaller in scope than the protagonist's:

  • Not every character needs a full arc. Minor characters can be static and serve the story well.
  • Recurring characters who remain completely static across many chapters feel flat. Give them at least one shift, revelation, or deepening moment.
  • Supporting arcs should intersect with and complicate the protagonist's arc. A supporting character's growth (or refusal to grow) should put pressure on the protagonist.

Antagonist Arcs

The opposition should not be static. Track antagonist development through:

  • Escalation: The antagonist raises the stakes in response to the protagonist's actions.
  • Revelation: The antagonist's true motives or history are gradually exposed, complicating the reader's view.
  • Adaptation: The antagonist changes tactics when old approaches fail. This makes them feel intelligent and dangerous.
  • Internal conflict: The antagonist faces their own dilemmas. This prevents them from being a cardboard villain.

A static antagonist who does the same thing every time they appear makes the conflict feel repetitive. Each antagonist appearance should shift the dynamic.

Multi-Book Continuity

Thread Scope

When a story spans multiple volumes, threads fall into two categories:

  • Book-level threads: Introduced and paid off within a single volume. These give each book its own satisfying arc.
  • Series-level threads: Introduced in one book, paid off in a later one. These create the connective tissue that makes a series feel unified.

Managing Series-Level Threads

Series-level threads need periodic oxygen even when they are not the current book's focus:

  • A brief mention, a scene that touches on the thread, or a new complication is enough.
  • The 2-4 chapter rule relaxes across book boundaries, but not infinitely. If a series thread goes an entire book without a single mention, readers will forget it.
  • Aim for at least 2-3 touchpoints per book for any active series-level thread.

Cross-Book Foreshadowing

Seeds for later books should be planted early and tracked separately in the foreshadowing checklist:

  • Mark these with a payoff target of "Book X" rather than a specific chapter.
  • These seeds can be more subtle than within-book seeds, since the reader has more time to absorb them.
  • Review cross-book seeds at the end of each volume to ensure they were planted.

End-of-Book Review

At the end of each volume, conduct a continuity audit:

  1. Which book-level threads were paid off? Were any left dangling unintentionally?
  2. Which series-level threads got oxygen in this book? Were any neglected?
  3. What seeds were planted for future books? Are they sufficient for the planned payoffs?
  4. Does this book have a satisfying internal arc while advancing the series?
  5. What threads need priority attention in the next volume's opening chapters?

This review feeds directly into planning the next book's outline.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.