fiction-workshop
npx skills add https://github.com/rhavekost/author-toolkit --skill fiction-workshop
Agent 安装分布
Skill 文档
Fiction Workshop
Editorial workflow for collaborative fiction writing in three stages: Story Bible Building, Chapter Development, and Reader Testing.
When to Use
This skill is for:
- â Long-form fiction (novels, novellas, short story collections)
- â Multi-chapter manuscripts requiring character/plot consistency
- â Fiction projects needing developmental or line editing
- â Stories with complex worldbuilding or multiple POV characters
When NOT to Use
This skill is NOT for:
- â Flash fiction or single scenes (< 2000 words) – too lightweight for the workflow
- â Poetry or experimental prose – needs different editorial approach
- â Screenplays or stage plays – different format conventions
- â Technical writing, documentation, or academic papers
- â Business writing or marketing copy
For narrative nonfiction (memoir, self-help with story elements), use the narrative-nonfiction skill instead.
Editorial Personas
Switch between these roles during Chapter Development by requesting a specific lens:
| Role | Invocation | Focus |
|---|---|---|
| Developmental Editor | “As developmental editor…” | Plot, pacing, structure, stakes, theme |
| Line Editor | “As line editor…” | Prose rhythm, word choice, “show don’t tell” |
| Character Consultant | “As character consultant…” | Voice consistency, motivation, arc, relationships |
| Continuity Tracker | “As continuity tracker…” | Timeline, world facts, internal consistency |
| Brainstorm Partner | “Brainstorm mode…” | “What if” exploration, problem-solving, unsticking |
See references/ for detailed guidance on each role.
Stage 1: Story Bible Building
Goal: Establish shared story foundation before drafting or editing.
Initial Questions
- Genre and target reader?
- Core premise/logline?
- Protagonist: who they are, what they want?
- Central conflict?
- Reader’s intended emotional journey?
- How much written vs. planned?
Story Bible Components
Plot: Premise, three-act structure/beat sheet, major turns, ending (even if rough)
Characters: Protagonist (want/need/wound/arc), antagonist (motivation/threat), supporting cast (function/relationships), POV voice notes
World: Setting (time/place/rules), tech/magic systems, social structures, sensory palette
Theme: Central question, moral argument, recurring motifs
If a Story Bible document exists, review it. If not, offer to create one using assets/story-bible-template.md.
Example Story Bible entry (character):
ALEX CHEN - Protagonist
Want: Expose the conspiracy and clear her name
Need: Learn to trust her instincts over institutional authority
Wound: Mentor betrayed her at previous agency, causing career setback
Arc: Lone wolf â realizes she needs allies â builds trust with team
Voice notes: Analytical, dry humor when stressed, avoids emotional language
Key relationship: Tension with Handler (wants to trust, can't fully)
Exit condition: Confident grasp of story fundamentals. Can discuss character motivations, predict plot implications, and identify thematic threads without asking basic questions.
Stage 2: Chapter Development
Goal: Draft or refine chapters through brainstorm â curate â draft â refine cycles.
Drafting new? â Creation workflow | Editing existing? â Editing workflow
Creation Workflow
-
Scene Planning
- What must happen (plot)? Whose POV?
- Chapter’s emotional arc?
- What reader learns/feels by end?
-
Brainstorm Beats (5-15 options): Opening hooks, key moments, dialogue, sensory details, closing
Example (thriller scene): Same car outside coffee shop three days running | Phone buzzing at 3am with blocked caller | Surveillance photo under door | Colleague mentions detail only surveillance would know | Camera lens reflection in window | Dead drop cleaned out | Safe house key doesn’t fit | Contact misses first check-in
Then curate: “Which create immediate tension? Combine any?”
-
Curate: Ask which to keep, combine, or discard. Reasons help calibrate.
-
Draft: Write chapter. Use
str_replacefor revisions, never reprint. -
Refine: Iterate on feedback. After 3 passes with minimal changes, ask: “What could be cut?”
Editing Workflow
-
Read and Diagnose: What chapter tries to do, where it succeeds, where it loses energy/clarity
-
Invoke Persona: Structure/pacing â Developmental | Prose â Line | Voice â Character | Facts â Continuity
-
Propose Changes: Specific, surgical edits with brief “why”
-
Implement: Use
str_replace. Link to file after changes. -
Iterate: Until chapter achieves purpose
Role-Specific Guidance
When a specific editorial persona is invoked, load the corresponding reference file:
- Developmental editing â
references/developmental-editing.md - Line editing â
references/line-editing.md - Character work â
references/character-work.md - Continuity â
references/continuity-tracking.md - Brainstorming â
references/brainstorming.md - Thriller-specific craft â
references/thriller-craft.md - Sci-fi worldbuilding â
references/scifi-worldbuilding.md
Stage 3: Reader Testing
Goal: Verify manuscript works without author context.
Using fresh sub-agent (no story bible):
- Comprehension: Can they summarize plot, understand motivations, identify stakes?
- Engagement: Where did they lose interest, have questions, feel confused?
- Emotional: Did key moments land? Ending satisfying? Theme clear?
Common issues: Unclear motivation | Pacing lags | Unearned moments | Confusion
If struggles: Identify gap â Return to Stage 2 â Re-test
Exit condition: Reader understands and engages without author explanations.
Self-Check: Is This Working?
Use these checkpoints to verify you’re following the workflow correctly.
After Story Bible building:
- Can you describe the protagonist’s want vs. need without re-reading notes?
- Can you predict how the antagonist would react to a new scenario?
- Do you understand the thematic question the book explores?
- Could you summarize the three-act structure in 2-3 sentences?
After invoking a persona:
- Did you explicitly say “As [persona name]…” in your request?
- Is the feedback focused on that persona’s domain (developmental = structure, line = prose)?
- Did you avoid mixing feedback from multiple personas in one pass?
After making edits:
- Did you use
str_replacefor surgical changes, not reprinting entire sections? - Can you articulate what changed and why it’s better?
- Is the change consistent with the Story Bible (character voice, plot logic, world rules)?
After brainstorming:
- Did you generate 5+ options before selecting one?
- Did you curate collaboratively rather than taking the first suggestion?
- Can you explain why the selected option is stronger than alternatives?
Before claiming “done”:
- Has a fresh sub-agent (without Story Bible context) read the manuscript?
- Did the fresh reader understand plot, character motivations, and stakes?
- Were any gaps or confusion points identified and addressed?
If you answered “no” to any checkpoint, return to that stage before proceeding.
Common Mistakes
| Mistake | Why It Happens | Fix |
|---|---|---|
| Skipping Story Bible | “I know my story well enough” | Story Bible isn’t for youâit’s for Claude. Without shared context, feedback will miss key story elements. Build it. |
| Generic feedback without persona | Rushing, forgetting to invoke specific role | Explicitly say “As developmental editor…” or “As line editor…” in your prompt. Different lenses catch different issues. |
| Reprinting entire chapters | Habit from other editing contexts | Use str_replace for surgical edits only. Reprinting burns context and makes changes hard to track. Link to file after edits. |
| Jumping to line edits before structure | Wanting to “fix” prose immediately | If plot/pacing/character issues exist, line edits are wasted effort. Always developmental pass first. See example below. |
| Skipping Reader Testing | “I’ve read it so many times already” | You have author context. Reader Testing uses fresh sub-agent without story bible to catch gaps readers will hit. |
| Too many personas at once | Trying to fix everything in one pass | Invoke one persona per pass. Developmental â Character â Line â Continuity. Focused feedback is actionable feedback. |
| Brainstorming without curation | Taking first idea that sounds good | Generate 5-15 options, then curate. First idea is rarely best idea. Quantity enables quality. |
Example: Developmental vs. Line Editing
Same passage, different lenses:
Sarah walked into the office. Her boss looked angry. “We need to talk,” he said. She sat down nervously.
Line Editor feedback (prose-level):
- “Walked” is weakâtry “strode” or “slipped”
- “Looked angry” tells rather than showsâdescribe furrowed brow, tight jaw
- “Nervously” is an adverb crutchâshow the nervousness through action
Developmental Editor feedback (structure/stakes):
- What does Sarah want in this scene? What does her boss want?
- If this is the confrontation, we need setupâwhat’s the conflict history?
- Stakes feel lowâwhy does this conversation matter to the story?
- Pacing: Is this the right chapter for this confrontation, or should tension build longer?
The difference: Line edits polish sentences. Developmental edits ensure the scene earns its place in the story. Always developmental first.
Quick Reference Commands
| Need | Command |
|---|---|
| Start new project | “Let’s build a story bible for [project]” |
| Developmental pass | “As developmental editor, analyze [chapter/section]” |
| Line edit | “As line editor, polish [scene/passage]” |
| Character check | “As character consultant, is [character]’s [action] in character?” |
| Continuity audit | “As continuity tracker, check [chapters X-Y] for inconsistencies” |
| Get unstuck | “Brainstorm modeâI need to [solve problem]” |
| Test readability | “Run a fresh read on [chapter/section]” |
Files
references/developmental-editing.md– Plot, structure, pacing analysisreferences/line-editing.md– Prose-level refinementreferences/character-work.md– Voice, motivation, arc trackingreferences/continuity-tracking.md– Timeline and fact consistencyreferences/brainstorming.md– Idea generation techniquesreferences/thriller-craft.md– Genre-specific guidance for suspensereferences/scifi-worldbuilding.md– Technical accuracy, speculation rulesassets/story-bible-template.md– Blank story bible structureassets/scene-worksheet.md– Scene-level analysis template