novel-architect▌
junaid18183/novel-architect-skills · updated Jun 2, 2026
MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.
[Begins Step 1 with warm, inviting questions]
- ›### Example 2: Quick Command Setup
- ›User: \"/novel-architect an english novel named lost-horizon 'A man discovers his small town is slowly disappearing from maps'\"
Novel Architect
A comprehensive skill for literary fiction writers that transforms vague story ideas into structured novel projects through patient, emotionally-attentive dialogue.
Core Philosophy
Reflection before construction. Emotional truth before narrative logic.
This skill:
- Works through conversation first, writing only after understanding is complete
- Proposes content section-by-section, waiting for approval at each step
- Stores approved sections in memory, writing files only when complete
- Preserves authorial voice and intent above all else
- Respects silence, ambiguity, and emotional restraint
What This Creates
| 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 |
Output Location
Project is created in:
~/writing/novels/{novel-name}/
All work is done in the same location. The skill works on one file at a time.
Usage Patterns
Quick Start (Command Style)
/novel-architect an english novel named lost-horizon "A man discovers his small town is slowly disappearing from maps"
Interactive Start
"Help me create a novel project"
"I want to start writing a novel"
"Set up a new book for me"
Both trigger the same step-by-step interview process.
Complete Process Overview
The skill follows this exact sequence, never skipping ahead:
- Gather Project Basics → Name, language, core idea
- Create Directory Structure → All folders with README files
- Interactive Braindump → North Star, title, theme, structure (section-by-section approval)
- Define Genre → Conventions, tone, boundaries, expectations
- Discover Voice → POV, tone, rhythm, influences
- Build Characters → Rich character sheets in table format (one at a time)
- Build World → Worldbuilding tables (setting, atmosphere, rules)
- Map Conflicts → Internal/external conflicts, stakes
- Write Synopsis → Full story outline (beginning → middle → end)
- Create Timeline → Chronological event map
- Generate Chapter Outlines → Detailed beat sheets (one chapter at a time, saved silently)
- Draft All Chapters → Draft Chapter-1 to Chapters-N via parallel background tasks (RECOMMENDED) or sequentially ask user how he wants parallel or sequential
- Review Each Chapter → All chapters via parallel background tasks (RECOMMENDED) or sequentially
- Final Continuity Check → Verify consistency across all chapters
- Complete & Present → Final verification and next steps
Workflow Optimization Notes:
Parallel Processing (Steps 12-13):
- Steps 12 and 13 support parallel execution via background agents
- For Step 12: Draft Chapter 1 first for approval, then launch parallel agents for remaining chapters
- For Step 13: Launch one review agent per chapter simultaneously
- Parallel execution dramatically reduces total time (minutes vs hours)
- Each agent works independently with full context access
- Use
run_in_background=trueparameter in delegate_task calls
When to Use Parallel vs Sequential:
- Parallel (Default): 5+ chapters, user wants speed, no special dependencies
- Sequential: User preference, very complex continuity, or debugging needed
Background Task Management
When to Use Background Tasks
Use delegate_task with run_in_background=true for:
- Drafting multiple chapters (Step 12: Chapters 2-N)
- Reviewing multiple chapters (Step 13: All chapters)
- Any parallel, independent operations that don't require sequential execution
Task Parameters:
delegate_task(
category="unspecified-high",
description="Brief task description (shown to user)",
prompt="Detailed instructions with context file paths and requirements",
run_in_background=true # REQUIRED for parallel execution
)
Monitoring Background Tasks
After launching parallel tasks:
- Announce how many tasks launched
- Provide estimated completion time
- System will notify when tasks complete
- User can request status updates or live monitoring
- Use
background_output(task_id="...")to retrieve results
Status Communication:
- "Launched [N] parallel agents for [task description]"
- "Task [N] of [Total] completed"
- "All tasks complete. Proceeding to next step."
Task Design Principles
Each background task must:
- Be completely self-contained and independent
- List ALL required context files explicitly in prompt
- Include clear success criteria and output format
- Specify what NOT to do (constraints)
- Save results to correct file location
Avoid:
- Tasks that depend on other background tasks completing first
- Vague instructions without file paths
- Tasks that require user input mid-execution
Critical Interaction Principles
THE CONFIRMATION FORMAT (Mandatory)
After proposing ANY section content, ALWAYS use this exact format:
Does this feel true to what you're holding?
You can reply with:
1. **Yes** (approve and continue)
2. **Tweak** (tell me what to adjust)
3. **Rewrite** (I'll regenerate with a different approach)
Memory-Based Workflow
CRITICAL FILE WRITING RULES:
- DO NOT write files until ALL sections of that file are approved
- Store each approved section in memory only
- SAVE files IMMEDIATELY after all sections of that file are complete and approved
- Each File is written in ONE operation when complete
- Never revise completed files unless explicitly asked
- Progress through sections sequentially, never jumping ahead
- Foundation files (Braindump, Genre, Style, etc.) must be saved before moving to Outlines
Tone & Voice
Throughout all interactions:
- Calm, patient, emotionally attentive
- Gentle, human, reflective language
- No rush, no assumptions
- Mirror emotional truth back to the author
- Respect silence and uncertainty
Step 1: Gather Project Basics
Parse Quick Start Command (If Provided)
If user invokes with command syntax:
/novel-architect [language] novel named [name] "[core idea]"
Extract:
- Language: "an english novel" →
english| "hindi" | "bilingual" - Name: "named lost-horizon" →
lost-horizon(becomes folder name) - Core idea: Quote-wrapped description
- For specialized genre support, consult @genre.md, @fantasy.md, or @mystery.md.
Otherwise, Ask Gently
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.
Step 2: Create Directory Structure
Do this silently (no need to narrate file creation unless asked).
Create the full project structure:
/home/claude/novels/{project-name}/
├── Braindump.md (to be filled in Step 3)
├── Genre.md (to be filled in Step 4)
├── Style.md (to be filled in Step 5)
├── Characters.md (to be filled in Step 6)
├── Worldbuilding.md (to be filled in Step 7)
├── Conflict.md (to be filled in Step 8)
├── Synopsis.md (to be filled in Step 9)
├── Timeline.md (to be filled in Step 10)
├── Outline/
│ └── README.md
├── Chapters/
│ └── README.md
├── Research/
│ └── README.md
├── Archive/
│ └── README.md
└── Assets/
└── README.md
README Templates
Outline/README.md:
# Outline
Chapter-by-chapter beat sheets and plot structure.
Each file: `outline-chapter-N.md`
## Structure per chapter
- Chapter goal
- POV character
- Key beats
- Emotional arc
- Setting
- Notes
Chapters/README.md:
# Chapters
Manuscript files for each chapter.
Each file: `chapter-N.md`
Write your draft here. One file per chapter.
Title format: `# Chapter N: [Title]`
Research/README.md:
# Research
Reference materials, sources, and background research.
Store:
- Historical research
- Location references
- Technical details
- Inspiration sources
- Continuity notes
Archive/README.md:
# Archive
Deleted scenes, old drafts, and cut content.
Move old versions here instead of deleting.
Prefix files with date: `2026-01-29-old-chapter-3.md`
Assets/README.md:
# Assets
Visual references, maps, character art, and other media.
Store:
- Character reference images
- Location photos
- Maps and diagrams
- Mood boards
- Cover ideas
After creating structure:
"I've created your project structure. Let's begin building the foundation of your story."
Step 3: Interactive Braindump
Critical: Work through each section ONE AT A TIME. Store in memory. Write Braindump.md only when ALL sections approved.
Section 3.1: The North Star
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"
Section 3.2: Title
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"
Section 3.3: Core Idea
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.
Section 3.4: Central Theme
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?
Section 3.5: Structure
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.
Complete Braindump.md
After ALL sections approved:
"Perfect. I've captured everything for your Braindump. Writing it now..."
Write Braindump.md with this exact format:
## North Star
[Approved content]
## Title
[Approved title]
## Core Idea
[Approved content]
## Central Theme
[Approved content]
## StrucHow to use novel-architect on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your development machine
- ›Node.js version 16.0+ with npm package manager (verify with
node --version) - ›Active project directory or workspace where you want to add novel-architect
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
The skills CLI fetches novel-architect from GitHub repository junaid18183/novel-architect-skills and configures it for Cursor.
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Reload or restart Cursor to activate novel-architect. Access the skill through slash commands (e.g., /novel-architect) or your agent's skill management interface.
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases▌
User Story & Requirements Generation
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Competitive Analysis
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Roadmap Prioritization
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
Make data-driven prioritization decisions faster
Stakeholder Communication
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Implementation Guide▌
Prerequisites
- ›Claude Desktop or compatible AI client
- ›Access to product documentation and roadmap tools (Jira, Notion, etc.)
- ›Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
- ›Stakeholder contact information and communication channels
Time Estimate
30-60 minutes to see productivity improvements
Installation Steps
- 1.Install product management skill
- 2.Start with user story generation for known feature
- 3.Progress to competitive analysis: research 2-3 competitors
- 4.Use for roadmap prioritization: apply RICE/ICE scoring
- 5.Draft stakeholder communications and refine based on feedback
- 6.Build template library for recurring PM tasks
- 7.Share effective prompts with product team
Common Pitfalls
- ⚠Not validating competitive research—verify facts before sharing
- ⚠Accepting user stories without involving engineering team
- ⚠Over-relying on frameworks without qualitative judgment
- ⚠Not customizing outputs to company culture and communication style
- ⚠Skipping stakeholder validation of generated requirements
Best Practices▌
✓ Do
- +Validate research and competitive analysis with real data
- +Collaborate with engineering when generating technical requirements
- +Customize frameworks and templates to your company context
- +Use skill for first drafts, refine with stakeholder input
- +Document successful prompt patterns for PM tasks
- +Combine AI efficiency with human judgment and intuition
✗ Don't
- −Don't publish competitive analysis without fact-checking
- −Don't finalize user stories without engineering review
- −Don't make prioritization decisions solely on AI scoring
- −Don't skip customer validation of generated requirements
- −Don't ignore company-specific context and culture
💡 Pro Tips
- ★Provide context: company goals, constraints, customer feedback
- ★Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
- ★Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
- ★Use skill for 70% generation + 30% customization to company needs
When to Use This▌
✓ Use When
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid When
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
Learning Path▌
- 1Basic: user stories, feature specs, status updates
- 2Intermediate: competitive analysis, prioritization frameworks, PRDs
- 3Advanced: product strategy, go-to-market planning, OKR setting
- 4Expert: product vision, market positioning, business model innovation
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★27 reviews- ★★★★★Chaitanya Patil· Dec 24, 2024
Useful defaults in novel-architect — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Noor Liu· Dec 24, 2024
Useful defaults in novel-architect — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Piyush G· Nov 15, 2024
novel-architect is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Mia Patel· Nov 15, 2024
novel-architect is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Shikha Mishra· Oct 6, 2024
Keeps context tight: novel-architect is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Neel Brown· Oct 6, 2024
Keeps context tight: novel-architect is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Yash Thakker· Sep 25, 2024
We added novel-architect from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Min Sharma· Sep 17, 2024
novel-architect fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Dhruvi Jain· Aug 16, 2024
novel-architect fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Henry Shah· Aug 16, 2024
novel-architect fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
showing 1-10 of 27