adopt

Extract manuscript metadata and rewrite chapters into a Holocron project.

Updated May 9, 2026
One-click install
npx skills add https://github.com/PetitChu/holocron --skill adopt-petitchu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/PetitChu/holocron/tree/main/skills/adopt
Command: npx skills add https://github.com/PetitChu/holocron --skill adopt-petitchu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns an existing story draft into a Holocron-ready project by extracting its craft parameters and then rewriting each chapter to match Holocron’s world rules and your declared author voice, instead of starting over from scratch.

Core Features & Use Cases

  • Draft ingestion (MD/DOCX): Accepts a single manuscript in markdown or DOCX, converts DOCX to markdown when needed, and preserves the original for reference.
  • Automatic extraction + wizard prefill: Splits the draft into chapter files, extracts era, premise, characters, world elements, outline, and voice mechanics evidence (raw observations), and uses those results to prefill the /holocron:new wizard in adoption mode.
  • Approval-gated chapter rewrites: Rewrites each chapter one at a time, requiring your accept/revise/skip decisions to prevent compounding voice drift while upgrading prose to the project’s craft rules.

Quick Start

Run /holocron:adopt path/to/your-draft.md to create a new Holocron project, extract defaults from your manuscript, and rewrite each chapter in your declared voice with an approval gate.

Frequently Asked Questions about adopt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import an existing manuscript draft into a new story project?

To import an existing manuscript draft, provide a single MD or DOCX file and the system extracts era, premise, characters, world, and outline to prefill a new project wizard. DOCX files are converted to markdown automatically using pandoc.

Can I rewrite story chapters to match a specific author voice without starting over?

Yes, you can rewrite chapters to match a specific author voice through an approval-gated process. Each chapter is rewritten one at a time, requiring your accept, revise, or skip decision to prevent compounding voice drift.

Does the manuscript adoption process support automatic chapter splitting?

Yes, manuscript adoption supports automatic chapter splitting. When you import a single-file markdown or DOCX draft, the system splits the content into individual chapter files and rewrites outputs into a standardized project structure.

What do I need to convert DOCX manuscripts for story rewriting?

To convert DOCX manuscripts for story rewriting, you need pandoc installed for DOCX to markdown conversion. The system preserves the original file for reference while producing markdown output for chapter splitting and voice extraction.

How does voice analysis work when adopting a draft?

Voice analysis during draft adoption extracts voice mechanics evidence as raw observations from your manuscript. These observations, along with craft rules from an author-authored voice file, guide the approval-gated per-chapter rewrites.

What are the limitations of adopting a single-file manuscript draft?

A key limitation is that adoption applies only to single-file MD or DOCX inputs, not multiple separate files. Additionally, the rewrite process requires manual approval for each chapter to prevent voice drift, which may be time-consuming for long manuscripts.