Velith — AI-Native Publishing System
Overview
Build books like software. 6-phase pipeline from blank page to published book, with dedicated skills, agents, and quality gates at every stage.
Phase 0: Onboarding → Phase 1: Ideation → Phase 2: Outlining → Phase 3: Drafting → Phase 4: Editing → Phase 5: Publishing
Genre Support
| Genre |
Key Differences |
Reference File |
| Fiction |
Plot structure (Save the Cat!/Snowflake), character bible, scene beats |
book-fiction |
| Non-Fiction |
Problem-solution structure, persona-driven, evidence hierarchy |
book-nonfiction |
| Technical |
Concept progression (novice→expert), code examples, diagrams, API docs |
book-technical |
| Screenplay |
3-act + sequence method, dialogue/action, A/B story |
book-screenplay |
| Poetry |
Form-driven (sonnet/haiku/free verse), imagery systems, collection arc |
book-poetry |
| Game |
Quest trees, branching dialogue, lore bible, flag system |
book-game |
| Academic |
IMRAD, literature review, argument chains, citation practices |
book-academic |
| Custom |
Compose patterns from any genre via book-genre-creator |
book-genre-creator |
Phase Router
When /velith is invoked without arguments, detect current project state and route:
- No project exists → Run Phase 0 (Onboarding)
- Project exists, no outline → Run Phase 1 (Ideation)
- Outline exists, no drafts → Run Phase 2 (Outlining) validation, then Phase 3
- Drafts exist, incomplete → Continue Phase 3 (Drafting)
- All drafts complete → Run Phase 4 (Editing)
- Editing complete → Run Phase 5 (Publishing)
Detection: check for drafts/ directory, outline.md, STYLE.md, PRD.md in current project.
Phase Details
Phase 0: Onboarding (/velith onboard)
- Genre selection (fiction/non-fiction/technical/screenplay/poetry/game/academic/custom)
- Target audience definition
- Language selection
- Project directory setup
- Source material scan (existing notes, articles, code)
- Generate
STYLE.md (voice, tone, conventions)
- Generate
PRD.md (book requirements)
Phase 1: Ideation (/velith ideate)
- Market research (competing titles, gaps)
- Core concept distillation (elevator pitch)
- Unique value proposition
- Scope definition (chapters, word count, timeline)
- Save to
ideation.md
Phase 2: Outlining (/velith outline)
- Generate full chapter outline with dependencies
- Per-chapter specs: title, hook, key concepts, word target, difficulty level
- Cross-chapter reference map
- Save to
outline.md
- Agent:
book-architect validates structure
Phase 3: Drafting (/velith draft)
- Plan-Then-Execute pattern: chapter-by-chapter generation
- Each chapter gets: outline context + previous chapter summary + style guide
- Parallel chapter generation via subagents (max 4 concurrent)
- Agent:
scene-generator decomposes chapters into scenes first (fiction only)
- Agent:
chapter-writer generates each chapter (from scenes if available)
- Agent:
continuity-editor checks cross-chapter consistency
- Quality gate: line count, frontmatter, style compliance
Phase 4: Editing (/velith edit)
- 5-stage editing pipeline:
- Editorial Assessment (macro structure)
- Developmental Edit (flow, pacing, gaps)
- Line Edit (sentence-level clarity)
- Copy Edit (grammar, consistency)
- Proofread (final typos)
- Agent:
style-doctor enforces voice consistency
- Generate editing report with severity-ranked issues
Phase 5: Publishing (/book-publish)
- Format conversion (EPUB/PDF/MOBI/TXT/MD via Pandoc + Calibre)
- Agent:
cover-designer → concepts + image prompts
- Agent:
illustrator → interior illustration plan (optional, after drafting)
- Agent:
marketing-expert → launch strategy
- Metadata, title candidates, KDP checklist
Interior Illustrations (/book-illustrate)
- Can run after Phase 3 (Drafting) or during Phase 5 (Publishing)
- Agent:
illustrator → scene extraction, style bible, prompts
- Produces illustration plan with placement metadata
- Integrates image references into chapter drafts
Project Structure
{project-dir}/
├── PRD.md # Book requirements (Phase 0)
├── STYLE.md # Voice, tone, conventions (Phase 0)
├── ideation.md # Ideas, market research (Phase 1)
├── outline.md # Full chapter outline (Phase 2)
├── drafts/ # Chapter drafts (Phase 3)
│ ├── ch00-foreword.md
│ ├── ch01-xxx.md
│ └── ...
├── edits/ # Editing reports (Phase 4)
│ └── editorial-report.md
├── publish/ # Final outputs (Phase 5)
│ ├── book.epub
│ ├── book.pdf
│ └── metadata.yaml
└── sources/ # Source material references
Sub-Skills
Each phase has a dedicated skill in skills/book-{name}/SKILL.md:
| Skill |
Phase |
Description |
book-init |
0 |
Project setup, genre selection, STYLE.md + PRD.md |
book-ideation |
1 |
Market research, concept distillation, scope |
book-outline |
2 |
Chapter outline with dependencies and cross-references |
book-draft |
3 |
Plan-Then-Execute chapter generation |
book-edit |
4 |
5-stage editing pipeline |
book-publish |
5 |
EPUB/PDF/MOBI packaging, cover, marketing |
book-illustrate |
3-5 |
Interior illustrations, scene extraction, prompts |
book-status |
— |
Project status dashboard and web UI |
book-fiction |
— |
Fiction patterns (Save the Cat!, character bible) |
book-nonfiction |
— |
Non-fiction patterns (problem-solution, persona) |
book-technical |
— |
Technical book patterns (concept progression, code) |
book-screenplay |
— |
Screenplay patterns (3-act + sequence method, dialogue) |
book-poetry |
— |
Poetry patterns (form types, imagery systems, collection) |
book-game |
— |
Game scenario patterns (quest trees, branching, lore) |
book-academic |
— |
Academic patterns (IMRAD, lit review, argument chains) |
book-genre-creator |
— |
Meta-skill for genre selection and custom genre creation |
Agents
| Agent |
Role |
When |
book-architect |
Structure validation, outline generation |
Phase 2 |
chapter-writer |
Chapter draft generation |
Phase 3 |
continuity-editor |
Cross-chapter consistency check |
Phase 3-4 |
style-doctor |
Voice and tone consistency |
Phase 4 |
scene-generator |
Scene-level breakdown with GMC+RDD (fiction only) |
Phase 3, fiction |
cover-designer |
Cover concepts + image generation prompts |
Phase 5 |
illustrator |
Interior illustrations — scene extraction, style, prompts |
Phase 3-5 |
marketing-expert |
Reader personas, channel strategy, launch calendar |
Phase 5 |
Quality Gates
Each phase has mandatory completion criteria before proceeding:
| Phase |
Gate |
Evidence |
| 0 |
Project initialized |
PRD.md + STYLE.md exist |
| 1 |
Concept validated |
Elevator pitch + 3 competing titles analyzed |
| 2 |
Outline complete |
All chapters specified + cross-reference map |
| 3 |
Drafts complete |
All chapters meet word target + frontmatter |
| 4 |
Editing complete |
5-stage pipeline passed + <5 issues remaining |
| 5 |
Publish ready |
EPUB/PDF generated + metadata complete |
Integration with Existing Tools
- alcove: Search existing project docs as source material
- episteme: Validate technical content against knowledge graph
- discover: Run problem discovery for book concept
- council: Get multi-voice input on structure/outline decisions
Source: hashgraph-online/awesome-codex-plugins → plugins/epicsagas/Velith/skills/loom/SKILL.md
1---2name: loom3description: AI-native publishing system: autonomous multi-phase workflows from ideation to export. Fiction, non-fiction, and technical books. Trigger: /velith or book-related requests.4---567# Velith — AI-Native Publishing System89## Overview1011Build books like software. 6-phase pipeline from blank page to published book, with dedicated skills, agents, and quality gates at every stage.1213```14Phase 0: Onboarding → Phase 1: Ideation → Phase 2: Outlining → Phase 3: Drafting → Phase 4: Editing → Phase 5: Publishing15```1617## Genre Support1819| Genre | Key Differences | Reference File |20|-------|----------------|----------------|21| Fiction | Plot structure (Save the Cat!/Snowflake), character bible, scene beats | `book-fiction` |22| Non-Fiction | Problem-solution structure, persona-driven, evidence hierarchy | `book-nonfiction` |23| Technical | Concept progression (novice→expert), code examples, diagrams, API docs | `book-technical` |24| Screenplay | 3-act + sequence method, dialogue/action, A/B story | `book-screenplay` |25| Poetry | Form-driven (sonnet/haiku/free verse), imagery systems, collection arc | `book-poetry` |26| Game | Quest trees, branching dialogue, lore bible, flag system | `book-game` |27| Academic | IMRAD, literature review, argument chains, citation practices | `book-academic` |28| Custom | Compose patterns from any genre via `book-genre-creator` | `book-genre-creator` |2930## Phase Router3132When `/velith` is invoked without arguments, detect current project state and route:33341. **No project exists** → Run Phase 0 (Onboarding)352. **Project exists, no outline** → Run Phase 1 (Ideation)363. **Outline exists, no drafts** → Run Phase 2 (Outlining) validation, then Phase 3374. **Drafts exist, incomplete** → Continue Phase 3 (Drafting)385. **All drafts complete** → Run Phase 4 (Editing)396. **Editing complete** → Run Phase 5 (Publishing)4041Detection: check for `drafts/` directory, `outline.md`, `STYLE.md`, `PRD.md` in current project.4243## Phase Details4445### Phase 0: Onboarding (`/velith onboard`)46- Genre selection (fiction/non-fiction/technical/screenplay/poetry/game/academic/custom)47- Target audience definition48- Language selection49- Project directory setup50- Source material scan (existing notes, articles, code)51- Generate `STYLE.md` (voice, tone, conventions)52- Generate `PRD.md` (book requirements)5354### Phase 1: Ideation (`/velith ideate`)55- Market research (competing titles, gaps)56- Core concept distillation (elevator pitch)57- Unique value proposition58- Scope definition (chapters, word count, timeline)59- Save to `ideation.md`6061### Phase 2: Outlining (`/velith outline`)62- Generate full chapter outline with dependencies63- Per-chapter specs: title, hook, key concepts, word target, difficulty level64- Cross-chapter reference map65- Save to `outline.md`66- Agent: `book-architect` validates structure6768### Phase 3: Drafting (`/velith draft`)69- Plan-Then-Execute pattern: chapter-by-chapter generation70- Each chapter gets: outline context + previous chapter summary + style guide71- Parallel chapter generation via subagents (max 4 concurrent)72- Agent: `scene-generator` decomposes chapters into scenes first (fiction only)73- Agent: `chapter-writer` generates each chapter (from scenes if available)74- Agent: `continuity-editor` checks cross-chapter consistency75- Quality gate: line count, frontmatter, style compliance7677### Phase 4: Editing (`/velith edit`)78- 5-stage editing pipeline:79 1. Editorial Assessment (macro structure)80 2. Developmental Edit (flow, pacing, gaps)81 3. Line Edit (sentence-level clarity)82 4. Copy Edit (grammar, consistency)83 5. Proofread (final typos)84- Agent: `style-doctor` enforces voice consistency85- Generate editing report with severity-ranked issues8687### Phase 5: Publishing (`/book-publish`)88- Format conversion (EPUB/PDF/MOBI/TXT/MD via Pandoc + Calibre)89- Agent: `cover-designer` → concepts + image prompts90- Agent: `illustrator` → interior illustration plan (optional, after drafting)91- Agent: `marketing-expert` → launch strategy92- Metadata, title candidates, KDP checklist9394### Interior Illustrations (`/book-illustrate`)95- Can run after Phase 3 (Drafting) or during Phase 5 (Publishing)96- Agent: `illustrator` → scene extraction, style bible, prompts97- Produces illustration plan with placement metadata98- Integrates image references into chapter drafts99100## Project Structure101102```103{project-dir}/104├── PRD.md # Book requirements (Phase 0)105├── STYLE.md # Voice, tone, conventions (Phase 0)106├── ideation.md # Ideas, market research (Phase 1)107├── outline.md # Full chapter outline (Phase 2)108├── drafts/ # Chapter drafts (Phase 3)109│ ├── ch00-foreword.md110│ ├── ch01-xxx.md111│ └── ...112├── edits/ # Editing reports (Phase 4)113│ └── editorial-report.md114├── publish/ # Final outputs (Phase 5)115│ ├── book.epub116│ ├── book.pdf117│ └── metadata.yaml118└── sources/ # Source material references119```120121## Sub-Skills122123Each phase has a dedicated skill in `skills/book-{name}/SKILL.md`:124125| Skill | Phase | Description |126|-------|-------|-------------|127| `book-init` | 0 | Project setup, genre selection, STYLE.md + PRD.md |128| `book-ideation` | 1 | Market research, concept distillation, scope |129| `book-outline` | 2 | Chapter outline with dependencies and cross-references |130| `book-draft` | 3 | Plan-Then-Execute chapter generation |131| `book-edit` | 4 | 5-stage editing pipeline |132| `book-publish` | 5 | EPUB/PDF/MOBI packaging, cover, marketing |133| `book-illustrate` | 3-5 | Interior illustrations, scene extraction, prompts |134| `book-status` | — | Project status dashboard and web UI |135| `book-fiction` | — | Fiction patterns (Save the Cat!, character bible) |136| `book-nonfiction` | — | Non-fiction patterns (problem-solution, persona) |137| `book-technical` | — | Technical book patterns (concept progression, code) |138| `book-screenplay` | — | Screenplay patterns (3-act + sequence method, dialogue) |139| `book-poetry` | — | Poetry patterns (form types, imagery systems, collection) |140| `book-game` | — | Game scenario patterns (quest trees, branching, lore) |141| `book-academic` | — | Academic patterns (IMRAD, lit review, argument chains) |142| `book-genre-creator` | — | Meta-skill for genre selection and custom genre creation |143144## Agents145146| Agent | Role | When |147|-------|------|------|148| `book-architect` | Structure validation, outline generation | Phase 2 |149| `chapter-writer` | Chapter draft generation | Phase 3 |150| `continuity-editor` | Cross-chapter consistency check | Phase 3-4 |151| `style-doctor` | Voice and tone consistency | Phase 4 |152| `scene-generator` | Scene-level breakdown with GMC+RDD (fiction only) | Phase 3, fiction |153| `cover-designer` | Cover concepts + image generation prompts | Phase 5 |154| `illustrator` | Interior illustrations — scene extraction, style, prompts | Phase 3-5 |155| `marketing-expert` | Reader personas, channel strategy, launch calendar | Phase 5 |156157## Quality Gates158159Each phase has mandatory completion criteria before proceeding:160161| Phase | Gate | Evidence |162|-------|------|----------|163| 0 | Project initialized | PRD.md + STYLE.md exist |164| 1 | Concept validated | Elevator pitch + 3 competing titles analyzed |165| 2 | Outline complete | All chapters specified + cross-reference map |166| 3 | Drafts complete | All chapters meet word target + frontmatter |167| 4 | Editing complete | 5-stage pipeline passed + <5 issues remaining |168| 5 | Publish ready | EPUB/PDF generated + metadata complete |169170## Integration with Existing Tools171172- **alcove**: Search existing project docs as source material173- **episteme**: Validate technical content against knowledge graph174- **discover**: Run problem discovery for book concept175- **council**: Get multi-voice input on structure/outline decisions176177---178179**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/epicsagas/Velith/skills/loom/SKILL.md`
thedixitjain