$npx -y skills add epicsagas/Velith --skill loomAI-native publishing system: autonomous multi-phase workflows from ideation to export. Fiction, non-fiction, and technical books. Trigger: /velith or book-related requests.
| 1 | # Velith — AI-Native Publishing System |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | Build books like software. 6-phase pipeline from blank page to published book, with dedicated skills, agents, and quality gates at every stage. |
| 6 | |
| 7 | ``` |
| 8 | Phase 0: Onboarding → Phase 1: Ideation → Phase 2: Outlining → Phase 3: Drafting → Phase 4: Editing → Phase 5: Publishing |
| 9 | ``` |
| 10 | |
| 11 | ## Genre Support |
| 12 | |
| 13 | | Genre | Key Differences | Reference File | |
| 14 | |-------|----------------|----------------| |
| 15 | | Fiction | Plot structure (Save the Cat!/Snowflake), character bible, scene beats | `book-fiction` | |
| 16 | | Non-Fiction | Problem-solution structure, persona-driven, evidence hierarchy | `book-nonfiction` | |
| 17 | | Technical | Concept progression (novice→expert), code examples, diagrams, API docs | `book-technical` | |
| 18 | | Screenplay | 3-act + sequence method, dialogue/action, A/B story | `book-screenplay` | |
| 19 | | Poetry | Form-driven (sonnet/haiku/free verse), imagery systems, collection arc | `book-poetry` | |
| 20 | | Game | Quest trees, branching dialogue, lore bible, flag system | `book-game` | |
| 21 | | Academic | IMRAD, literature review, argument chains, citation practices | `book-academic` | |
| 22 | | Custom | Compose patterns from any genre via `book-genre-creator` | `book-genre-creator` | |
| 23 | |
| 24 | ## Phase Router |
| 25 | |
| 26 | When `/velith` is invoked without arguments, detect current project state and route: |
| 27 | |
| 28 | 1. **No project exists** → Run Phase 0 (Onboarding) |
| 29 | 2. **Project exists, no outline** → Run Phase 1 (Ideation) |
| 30 | 3. **Outline exists, no drafts** → Run Phase 2 (Outlining) validation, then Phase 3 |
| 31 | 4. **Drafts exist, incomplete** → Continue Phase 3 (Drafting) |
| 32 | 5. **All drafts complete** → Run Phase 4 (Editing) |
| 33 | 6. **Editing complete** → Run Phase 5 (Publishing) |
| 34 | |
| 35 | Detection: check for `drafts/` directory, `outline.md`, `STYLE.md`, `PRD.md` in current project. |
| 36 | |
| 37 | ## Phase Details |
| 38 | |
| 39 | ### Phase 0: Onboarding (`/velith onboard`) |
| 40 | - Genre selection (fiction/non-fiction/technical/screenplay/poetry/game/academic/custom) |
| 41 | - Target audience definition |
| 42 | - Language selection |
| 43 | - Project directory setup |
| 44 | - Source material scan (existing notes, articles, code) |
| 45 | - Generate `STYLE.md` (voice, tone, conventions) |
| 46 | - Generate `PRD.md` (book requirements) |
| 47 | |
| 48 | ### Phase 1: Ideation (`/velith ideate`) |
| 49 | - Market research (competing titles, gaps) |
| 50 | - Core concept distillation (elevator pitch) |
| 51 | - Unique value proposition |
| 52 | - Scope definition (chapters, word count, timeline) |
| 53 | - Save to `ideation.md` |
| 54 | |
| 55 | ### Phase 2: Outlining (`/velith outline`) |
| 56 | - Generate full chapter outline with dependencies |
| 57 | - Per-chapter specs: title, hook, key concepts, word target, difficulty level |
| 58 | - Cross-chapter reference map |
| 59 | - Save to `outline.md` |
| 60 | - Agent: `book-architect` validates structure |
| 61 | |
| 62 | ### Phase 3: Drafting (`/velith draft`) |
| 63 | - Plan-Then-Execute pattern: chapter-by-chapter generation |
| 64 | - Each chapter gets: outline context + previous chapter summary + style guide |
| 65 | - Parallel chapter generation via subagents (max 4 concurrent) |
| 66 | - Agent: `scene-generator` decomposes chapters into scenes first (fiction only) |
| 67 | - Agent: `chapter-writer` generates each chapter (from scenes if available) |
| 68 | - Agent: `continuity-editor` checks cross-chapter consistency |
| 69 | - Quality gate: line count, frontmatter, style compliance |
| 70 | |
| 71 | ### Phase 4: Editing (`/velith edit`) |
| 72 | - 5-stage editing pipeline: |
| 73 | 1. Editorial Assessment (macro structure) |
| 74 | 2. Developmental Edit (flow, pacing, gaps) |
| 75 | 3. Line Edit (sentence-level clarity) |
| 76 | 4. Copy Edit (grammar, consistency) |
| 77 | 5. Proofread (final typos) |
| 78 | - Agent: `style-doctor` enforces voice consistency |
| 79 | - Generate editing report with severity-ranked issues |
| 80 | |
| 81 | ### Phase 5: Publishing (`/book-publish`) |
| 82 | - Format conversion (EPUB/PDF/MOBI/TXT/MD via Pandoc + Calibre) |
| 83 | - Agent: `cover-designer` → concepts + image prompts |
| 84 | - Agent: `illustrator` → interior illustration plan (optional, after drafting) |
| 85 | - Agent: `marketing-expert` → launch strategy |
| 86 | - Metadata, title candidates, KDP checklist |
| 87 | |
| 88 | ### Interior Illustrations (`/book-illustrate`) |
| 89 | - Can run after Phase 3 (Drafting) or during Phase 5 (Publishing) |
| 90 | - Agent: `illustrator` → scene extraction, style bible, prompts |
| 91 | - Produces illustration plan with placement metadata |
| 92 | - Integrates image references into chapter drafts |
| 93 | |
| 94 | ## Project Structure |
| 95 | |
| 96 | ``` |
| 97 | {project-dir}/ |
| 98 | ├── PRD.md # Book requirements (Phase 0) |
| 99 | ├── STYLE.md # Voice, tone, conventions (Phase 0) |
| 100 | ├── ideation.md # Ideas, market research (Phase 1) |
| 101 | ├── outline.md # Full chapter outline (Phase 2) |
| 102 | ├── drafts/ # Chapter drafts (Phase 3) |
| 103 | │ ├── ch00-foreword.md |
| 104 | │ ├── ch01-xxx.md |
| 105 | │ └── ... |
| 106 | ├── edits/ # Editing reports (Phase 4) |
| 107 | │ └── editorial-report.md |
| 108 | ├── publish/ # Final outputs (Phase 5) |
| 109 | │ ├── book.epub |
| 110 | │ ├── book.pdf |
| 111 | │ └── metadata.yaml |
| 112 | └── sources/ # Source material references |
| 113 | ``` |
| 114 | |
| 115 | ## Sub-Skills |
| 116 | |
| 117 | Each phase ha |