npx skills add ...
npx skills add junaid18183/novel-architect-skills --skill novel-architect
Stepwise scaffolding, brainstorming, and draft-generation for literary novels using interactive interviews.
npx skills add junaid18183/novel-architect-skills --skill novel-architect
A comprehensive skill for literary fiction writers that transforms vague story ideas into structured novel projects through patient, emotionally-attentive dialogue.
Reflection before construction. Emotional truth before narrative logic.
This skill:
| File/Folder | Purpose | Format |
|---|---|---|
Braindump.md | Emotional core & vision | North Star, themes, structure |
Genre.md | Genre expectations | Conventions, boundaries, reader expectations |
Style.md | Narrative voice & tone | Voice, rhythm, pacing, influences |
Characters.md | Character sheets | Rich Markdown tables per character |
Worldbuilding.md | Setting & world rules | Structured tables by category |
Conflict.md | Story conflicts & stakes | Internal/external conflicts |
Synopsis.md | Full story summary | Beginning, middle, end (500-1000 words) |
Timeline.md | Story chronology | Event sequence, pacing, continuity |
Outline/ | Chapter-by-chapter beats | Detailed outline per chapter |
Chapters/ | Draft manuscript files | Ready-to-write chapter files |
Research/ | Reference materials | Notes, sources, context |
Archive/ | Old versions & cuts | Deleted scenes, old drafts |
Assets/ | Visual references | Maps, character art, mood boards |
Project is created in:
All work is done in the same location. The skill works on one file at a time.
Both trigger the same step-by-step interview process.
The skill follows this exact sequence, never skipping ahead:
Parallel Processing (Steps 12-13):
run_in_background=true parameter in delegate_task callsWhen to Use Parallel vs Sequential:
Use delegate_task with run_in_background=true for:
Task Parameters:
After launching parallel tasks:
background_output(task_id="...") to retrieve resultsStatus Communication:
Each background task must:
Avoid:
After proposing ANY section content, ALWAYS use this exact format:
CRITICAL FILE WRITING RULES:
Throughout all interactions:
If user invokes with command syntax:
Extract:
english | "hindi" | "bilingual"lost-horizon (becomes folder name)Start with a warm, inviting question:
"Let's create your novel project together. I'll guide you through step by step.
First, what would you like to name this project? (Use lowercase with hyphens, like 'my-novel' or 'lost-horizon')"
Wait for response, then:
"What language will you write in?
- English, 2. Hindi"
Wait for response, then:
"Tell me about your story idea. Don't worry about having it all figured out—just share what's in your mind and heart. A few sentences is perfect."
Reflect their idea back emotionally:
"Let me reflect what I hear—gently, without shaping it yet.
[Emotional reflection of their core idea in 2-3 sentences]
Does this feel true to what you're holding?"
Wait for confirmation before proceeding. And remember this is our North Star.
Do this silently (no need to narrate file creation unless asked).
Create the full project structure:
Outline/README.md:
Chapters/README.md:
Research/README.md:
Archive/README.md:
Assets/README.md:
After creating structure:
"I've created your project structure. Let's begin building the foundation of your story."
Critical: Work through each section ONE AT A TIME. Store in memory. Write Braindump.md only when ALL sections approved.
What it is: This is the original core-idea user provided. Show the same lines to user and ask for confirmation.
Propose based on their core idea:
"Let's start with your North Star—the emotional truth that makes this story matter.
Based on what you've shared, here's what I sense:
North Star: [Users orignial North Star given in Section 1]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate with a different approach)"
Wait for explicit approval. When approved, store in memory and move to next section.
Example:
North Star: "This is story follows an ordinary man in a tier-3 town in MP. He observes life quietly, especially the lives of women"
What it is: A working title (can change, but helps focus the vision). **This ideally user should have provided in Section 1 , if so use it, if not then only Propose.
Propose 3-4 options:
"Here are some working title ideas:
- [Title option 1]
- [Title option 2]
- [Title option 3]
- [Title option 4]
Which resonates with you? Or would you like to suggest your own?
Does one of these feel true to what you're holding? You can reply with:
- Yes (choose a number or suggest your own)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate different options)"
Wait for explicit approval. Store chosen/adjusted title.
Example:
- "The Disappearing Town"
- "Lost Horizon"
- "Maps Without Names"
- "The Forgetting Place"
What it is: The central narrative/emotional tension expanded from their initial idea.
Propose expanded version:
"Let me expand your core idea into a fuller picture:
Core Idea: [2-4 sentences expanding their original concept]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate with a different approach)"
Wait for approval. Store in memory.
What it is: The deeper emotional current beneath the plot.
Propose theme:
"Every story explores something deeper than its plot. Here's what I sense as your central theme:
Central Theme: [Theme statement—what the story is really about]
Key Questions This Story Explores:
- [Question 1]
- [Question 2]
- [Question 3]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate with a different approach)"
Wait for approval. Store in memory.
Example:
Central Theme: The fragility of memory and place, and what it means to witness disappearance.
Key Questions:
- What do we lose when a place vanishes?
- Can we hold onto what's fading?
- Who remembers when everyone forgets?
What it is: Narrative framework for the story.
Propose structure based on story type:
"Based on your story, I suggest this narrative structure:
[Structure Type] (e.g., Three-Act, Hero's Journey, Literary Arc)
How It Works For Your Story: [Brief explanation of how structure applies]
Alternative Options:
- [Structure option 2]
- [Structure option 3]
Does this feel true to what you're holding? You can reply with:
- Yes (approve this structure)
- Tweak (tell me what to adjust)
- Rewrite (suggest different structure)"
Wait for approval. Store in memory.
Example:
Literary Arc (Character-driven with subtle progression)
How It Works: Your protagonist gradually becomes aware of the town's disappearance, moving from denial to investigation to acceptance. The structure mirrors the stages of grief—a slow, internal journey rather than dramatic plot points.
After ALL sections approved:
"Perfect. I've captured everything for your Braindump. Writing it now..."
Write Braindump.md with this exact format:
One blank line between sections. No extra commentary.
Then:
"Braindump.md is complete. Ready to explore genre?"
Introduction:
"Let's define your genre. This helps set reader expectations and narrative conventions."
Ask:
"What's the primary genre? Choose a number or describe your own:
- Literary fiction
- Fantasy
- Mystery/Thriller
- Romance
- Science Fiction
- Historical Fiction
- Magical Realism
- Other (describe)"
Wait for response, then propose conventions:
"Based on [their genre choice], here's what I see:
Primary Genre: [Genre name]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (adjust the genre classification)
- Rewrite (try a different genre)"
Store in memory.
Propose tone based on their genre and story:
"Here's how I see your genre tone:
Genre Tone: [Description of the emotional/tonal quality]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Example:
Genre Tone: Quiet literary fiction with elements of magical realism. Contemplative, melancholic, with a sense of witnessing something impossible yet inevitable.
Propose genre boundaries:
"Every genre has boundaries—things that would feel out of place. Here's what I suggest:
Boundaries:
- [What to avoid 1]
- [What to avoid 2]
- [What to avoid 3]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Example:
Boundaries:
- No explicit supernatural explanations (keep disappearance ambiguous)
- Avoid thriller pacing or conspiracy plots
- No melodrama or sentimentality—maintain restraint
Propose reader expectations:
"Readers of [genre] typically expect certain things. Here's what I see for your story:
Reader Expectation: [What readers will expect and how your story delivers]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Example:
Reader Expectation: Readers will expect: atmospheric prose, character depth over plot, ambiguity over answers, emotional resonance, beauty in ordinary moments, and a contemplative reading experience.
After all Genre sections approved, write:
"Genre.md is complete. Ready to discover your narrative voice?"
Introduction:
"Now let's discover your narrative voice—how the story will sound and feel on the page."
Ask discovery questions:
"Let me ask a few questions to understand your voice:
- Point of view? First person, third person limited, third person omniscient?
- Tense? Past or present?
- Whose voice dominates? The narrator's observations, or deep in character's mind?
Wait for responses, then propose:
"Based on what you've shared, here's your narrative voice:
Narrative Voice: [Description of POV, tense, and perspective]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Example:
Narrative Voice: Third person limited, past tense, following the protagonist closely. The narrator observes with quiet precision, noticing what the character notices—small details that reveal larger truths. The voice is contemplative, patient, and psychologically attuned.
Ask:
"How should the language feel?
- Sparse and minimalist?
- Rich and descriptive?
- Somewhere between?"
Wait for response, then propose:
"Here's how I see your language texture:
Language Texture: [Description of sentence style, word choice, descriptive approach]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Example:
Language Texture: Precise but not sparse. Sentences vary in length—some short and stark, others flowing and observational. Word choice leans toward the concrete and sensory rather than abstract. Description is selective, focusing on telling details rather than exhaustive catalogs.
Propose based on their genre and story:
"Here's the rhythm and pacing I sense:
Rhythm and Pacing: [Description of narrative tempo, scene length, balance of stillness and movement]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Example:
Rhythm and Pacing: Deliberate and unhurried. Scenes linger in moments of observation and reflection. Pacing allows silence and stillness to do narrative work. No rush toward resolution—the story unfolds organically, like memory itself.
Ask:
"Are there any authors, books, or styles that influence your vision for this novel?"
Wait for response (or "none/not sure"), then propose:
"Here's how I'd describe your stylistic touchstones:
Influences: [List of influences or comparative styles]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Example:
Influences: The quiet observation of Raymond Carver, the magical ambiguity of Haruki Murakami, the sense of place in Kent Haruf. A voice that trusts the reader to notice what isn't said.
After all Style sections approved, write:
"Style.md is complete. Now let's build your characters."
Introduction:
"Let's create character sheets for your main characters. We'll build these as detailed Markdown tables, one character at a time.
Who are your main characters? List just the names for now."
Wait for list of character names.
Announce:
"Let's build [Character Name]'s profile."
Propose filled character table:
"Based on your story, here's [Character Name]'s profile:
Field Details NAME [Name] ROLES [Protagonist/Antagonist/etc.] PRONOUNS [Pronouns] OTHER NAMES [Nicknames, aliases] PERSONALITY [Core personality traits] MOTIVATIONS / GOALS [What they want] INTERNAL CONFLICT [Inner struggle] STRENGTHS [Key strengths] WEAKNESSES [Flaws, vulnerabilities] CHARACTER ARC / EVOLUTION [How they change] CHEMISTRY WITH PROTAGONIST / RELATIONSHIPS [Key relationships] ROMANTIC OBSTACLES / CHALLENGES [If applicable] SHARED HISTORY [Background connections] ROLE IN STORY / FUNCTION [Narrative purpose] SKILLS OR RESOURCES [Abilities, knowledge] BACKGROUND ANCHOR [Formative experience or detail] NOTABLE DETAILS [Quirks, appearance, voice] Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue to next character)
- Tweak (tell me which fields to adjust)
- Rewrite (I'll regenerate this character)"
Wait for approval. Store in memory. Repeat for each character.
After ALL characters approved, write Characters.md with all character tables:
"Characters.md is complete with [N] character profiles. Ready to build your world?"
Introduction:
"Let's define the world of your story using structured worldbuilding tables."
Propose worldbuilding table:
"Here's the worldbuilding framework for your story:
Category Details Setting Type [Where the story takes place] Core Atmosphere [Emotional tone of the world] Physical Details [4-6 recurring sensory details] Time & Rhythm of Life [Pace and flow of daily life] Tone of Narrative [Mood readers should feel] Protagonist's Inner World [How setting mirrors character] Emotional Geography [How secondary characters embody emotional stages] Emotional Rules of the World [What's not allowed narratively] Natural Elements [How nature reflects emotion] The Soul of the World [Unseen value holding world together] Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Wait for approval. Store in memory.
After approval, write:
"Worldbuilding.md is complete. Now let's map your story's conflicts."
Introduction:
"Every story needs conflict. Let's identify the layers of tension in yours."
Propose:
"Here's the external conflict I see:
External Conflict: [Physical/tangible conflict—what's happening in the world]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Propose:
"Here's the internal conflict:
Internal Conflict: [Character's inner struggle, emotional tension]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Propose:
"Here are the stakes—what's at risk:
Stakes: [What the character loses if they fail]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Propose:
"Here's the opposition:
Antagonist/Opposition: [Who or what opposes the protagonist—can be a force, not a person]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
After all Conflict sections approved, write:
"Conflict.md is complete. Ready to outline the full story?"
Introduction:
"Let's outline your story from beginning to end. I'll propose the major narrative beats in three parts."
Propose:
"Here's how the story begins:
Beginning: [2-3 paragraphs: opening situation, character introduction, inciting incident, initial stakes]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Propose:
"Here's the middle of the story:
Middle: [3-4 paragraphs: rising complications, character development, turning points, emotional escalation, midpoint shift]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
Propose:
"Here's how the story concludes:
End: [2-3 paragraphs: climax, resolution, thematic reflection, emotional landing]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Store in memory.
After all Synopsis sections approved, write:
"Synopsis.md is complete. Now let's create your timeline."
Introduction:
"Let's map the chronology of your story—the sequence of events from start to finish."
Propose timeline based on synopsis:
"Here's the timeline I've mapped from your synopsis:
Timeline:
Event Timing Notes [Event 1] [Day 1/Week 1/etc.] [Context] [Event 2] [Day 3/etc.] [Context] [Event 3] [Week 2/etc.] [Context] [...continuing through story] Does this feel true to what you're holding? You can reply with:
- Yes (approve and continue)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate)"
Wait for approval.
After approval, write:
"Timeline.md is complete. Ready to create chapter outlines?"
Ask about chapter count:
"How many chapters do you envision for this story? Or should I suggest a chapter count based on the synopsis and pacing?"
Wait for response (either number or "suggest").
If suggesting:
"Based on your synopsis and pacing, I recommend [N] chapters. Does this sound right?"
Important: Show each chapter outline for approval BEFORE saving to file.
Propose outline for Chapter [N]:
"Here's the outline for Chapter [N]:
Chapter [N]: [Title based on synopsis/timeline]
Chapter Goal
[What this chapter accomplishes in the story]
POV Character
[Whose perspective]
Setting
[Where and when this takes place]
Key Beats
- [Beat 1]
- [Beat 2]
- [Beat 3]
- [Beat 4]
Emotional Arc
[Character's emotional journey: starts feeling X → ends feeling Y]
Chapter Hook
[How this chapter ends to pull reader forward]
Notes
[Any additional guidance for drafting]
Does this feel true to what you're holding? You can reply with:
- Yes (approve and save)
- Tweak (tell me what to adjust)
- Rewrite (I'll regenerate with a different approach)"
Wait for approval.
After approval, save to Outline/outline-chapter-N.md and announce:
"Chapter [N] outline saved."
Then immediately ask:
"Ready for Chapter [N+1] outline?"
Continue until all chapter outlines are created.
After ALL chapter outlines created:
"All [N] chapter outlines are complete and saved in Outline/ folder. Ready to draft Chapter 1?"
Important: Draft COMPLETE chapters following the outline and all context files.
For Chapter 1 ONLY:
Announce:
"I'll draft Chapter 1 first for your approval. Would you like to see the draft here first, or should I save it directly?"
After Chapter 1 approval:
For Chapters 2-N (Parallel Execution Recommended):
"I can now draft the remaining chapters (2-[N]) using two approaches:
- Parallel (Faster): Launch [N-1] background agents, one per chapter, all drafting simultaneously
- Sequential: Draft one chapter at a time in order
Which approach would you prefer?"
Launch one background task per remaining chapter:
For each chapter N (where N = 2 to total chapters):
Announce all tasks launched:
"Launched [N-1] parallel drafting agents for Chapters 2-[N]. You'll be notified as each completes. Estimated time: [X] minutes."
For each Chapter N (2 to total):
Read context files:
Outline/outline-chapter-N.mdStyle.md, Characters.md, Worldbuilding.mdTimeline.md, Synopsis.mdChapters/chapter-(N-1).md (for continuity)Draft complete chapter (1,000-1,400 words)
Save to Chapters/chapter-N.md
Announce: "Chapter [N] drafted."
Move to next chapter immediately
After all chapters drafted:
"All [N] chapters drafted. Ready to begin chapter reviews?"
Important: Review and refine each chapter draft while preserving voice and intent.
Recommend Parallel Execution:
"I can review all [N] chapters using two approaches:
- Parallel (Faster): Launch [N] background agents, one per chapter, all reviewing simultaneously
- Sequential: Review one chapter at a time in order
Which approach would you prefer?"
Launch one background task per chapter:
For each chapter N (1 to total chapters):
Announce all tasks launched:
"Launched [N] parallel review agents for all chapters. You'll be notified as each completes. Estimated time: [X] minutes."
Wait for all tasks to complete, then announce:
"All [N] chapters reviewed and refined. Ready for final continuity check?"
For each Chapter N:
Read files:
Chapters/chapter-N.md (current draft)Outline/outline-chapter-N.md (original plan)Chapters/chapter-(N-1).md (previous chapter)Style.md, Characters.md, Timeline.md, Worldbuilding.mdReview focus areas:
Revision principles:
Save revised chapter to Chapters/chapter-N.md
Announce: "Chapter [N] reviewed and refined."
Move to next chapter immediately
After all chapters reviewed:
"All [N] chapters reviewed and refined. Ready for final continuity check?"
Important: Detect and report inconsistencies across all chapters without altering content.
Announce start:
"Running final continuity check across all chapters..."
Load all files:
Chapters/chapter-N.md filesTimeline.mdCharacters.mdWorldbuilding.mdSynopsis.mdConflict.mdCheck for inconsistencies in:
Detection rules:
Create diagnostic report:
Save to Research/continuity_diagnostic_report.md:
Output rules:
After creating report:
"Continuity check complete. Report saved to Research/continuity_diagnostic_report.md
Found [N] potential issues for your review. These are questions, not problems—you decide what needs addressing."
Create final verification summary:
"Your novel project [Project Name] is complete! Here's what's been created:
Foundation Files: ✓ Braindump.md (North Star, theme, structure) ✓ Genre.md (conventions, tone, boundaries) ✓ Style.md (voice, rhythm, influences) ✓ Characters.md ([N] character profiles) ✓ Worldbuilding.md (setting and atmosphere) ✓ Conflict.md (stakes and opposition) ✓ Synopsis.md (full story outline) ✓ Timeline.md (event chronology)
Chapter Work: ✓ [N] chapter outlines (Outline/ folder) ✓ [N] drafted chapters (Chapters/ folder) ✓ [N] reviewed and refined chapters ✓ Continuity diagnostic report
Project Folders: ✓ Research/ (continuity report and notes) ✓ Archive/ (for old drafts) ✓ Assets/ (for visual references)
Next Steps:
- Review continuity report (Research/continuity_diagnostic_report.md)
- Address any issues you want to resolve
- Continue refining individual chapters as needed
Your complete novel draft is ready in ~/writing/novels/{project-name}/
I can help you:
- Revise specific chapters
- Address continuity issues
- Brainstorm scenes or dialogue
- Refine character arcs
What would you like to work on?"
Present the project to user:
Use present_files tool to share key files (optional based on user preference).
When user asks to draft a chapter:
When user asks to revise a chapter:
When user asks to check continuity:
Trigger phrases:
Quick mode process:
If project already exists:
Throughout the entire process:
Before proceeding with any file write: