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.

$npx skills add https://github.com/junaid18183/novel-architect-skills --skill novel-architect
0 commentsdiscussion
summary

[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'\"
skill.md

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:

  1. Gather Project Basics → Name, language, core idea
  2. Create Directory Structure → All folders with README files
  3. Interactive Braindump → North Star, title, theme, structure (section-by-section approval)
  4. Define Genre → Conventions, tone, boundaries, expectations
  5. Discover Voice → POV, tone, rhythm, influences
  6. Build Characters → Rich character sheets in table format (one at a time)
  7. Build World → Worldbuilding tables (setting, atmosphere, rules)
  8. Map Conflicts → Internal/external conflicts, stakes
  9. Write Synopsis → Full story outline (beginning → middle → end)
  10. Create Timeline → Chronological event map
  11. Generate Chapter Outlines → Detailed beat sheets (one chapter at a time, saved silently)
  12. Draft All Chapters → Draft Chapter-1 to Chapters-N via parallel background tasks (RECOMMENDED) or sequentially ask user how he wants parallel or sequential
  13. Review Each Chapter → All chapters via parallel background tasks (RECOMMENDED) or sequentially
  14. Final Continuity Check → Verify consistency across all chapters
  15. 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=true parameter 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:

  1. Announce how many tasks launched
  2. Provide estimated completion time
  3. System will notify when tasks complete
  4. User can request status updates or live monitoring
  5. 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:

  1. Be completely self-contained and independent
  2. List ALL required context files explicitly in prompt
  3. Include clear success criteria and output format
  4. Specify what NOT to do (constraints)
  5. 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?

  1. 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:

  1. Yes (approve and continue)
  2. Tweak (tell me what to adjust)
  3. 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:

  1. [Title option 1]
  2. [Title option 2]
  3. [Title option 3]
  4. [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:

  1. Yes (choose a number or suggest your own)
  2. Tweak (tell me what to adjust)
  3. Rewrite (I'll regenerate different options)"

Wait for explicit approval. Store chosen/adjusted title.

Example:

  1. "The Disappearing Town"
  2. "Lost Horizon"
  3. "Maps Without Names"
  4. "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:

  1. Yes (approve and continue)
  2. Tweak (tell me what to adjust)
  3. 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:

  1. Yes (approve and continue)
  2. Tweak (tell me what to adjust)
  3. 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:

  1. [Structure option 2]
  2. [Structure option 3]

Does this feel true to what you're holding? You can reply with:

  1. Yes (approve this structure)
  2. Tweak (tell me what to adjust)
  3. 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]

## Struc
how to use novel-architect

How to use novel-architect on Cursor

AI-first code editor with Composer

1

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
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/junaid18183/novel-architect-skills --skill novel-architect

The skills CLI fetches novel-architect from GitHub repository junaid18183/novel-architect-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/novel-architect

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

GET_STARTED →

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. 1.Install product management skill
  2. 2.Start with user story generation for known feature
  3. 3.Progress to competitive analysis: research 2-3 competitors
  4. 4.Use for roadmap prioritization: apply RICE/ICE scoring
  5. 5.Draft stakeholder communications and refine based on feedback
  6. 6.Build template library for recurring PM tasks
  7. 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

  1. 1Basic: user stories, feature specs, status updates
  2. 2Intermediate: competitive analysis, prioritization frameworks, PRDs
  3. 3Advanced: product strategy, go-to-market planning, OKR setting
  4. 4Expert: product vision, market positioning, business model innovation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.527 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

1 / 3