manuscript-export
Skill0 starsChanged 43 days agoMITView on GitHub
Assemble un manuscrit en fichiers Markdown et l'exporte en DOCX, EPUB ou PDF de qualité éditoriale (page de titre, chapitres, pagination, métadonnées). À utiliser pour compiler un livre, produire un fichier lisible/partageable, préparer un envoi à un éditeur ou une auto-publication. Trigger: exporter, compiler le livre, docx, epub, pdf, manuscrit final.
In this repository9 other files it gives its agents.
- chapter-draftSkill
- continuity-checkSkill
- continuity-ledgerSkill
- derivative-contentSkill
- lore-lookupSkill
- story-architectSkill
- story-outlineSkill
- style-guideSkill
- vision-loreSkill
The file
Files
Manuscript Export — du dossier Markdown au livre
Ordre imposé : contrôler → assembler → exporter → vérifier le fichier produit. Exporter un manuscrit non contrôlé diffuse les incohérences.
Quand utiliser
« Compile le livre », « sors-moi un PDF », « je veux un EPUB », « prépare le fichier pour l'éditeur ».
Procédure
1. Contrôle préalable (bloquant)
- Mesurer :
python3 ../continuity-ledger/scripts/wb_manuscript.py <manuscrit>/chapitres --target-words <objectif> - Continuité : exécuter
continuity-checksur chaque chapitre. Annoncer le résultat avant d'exporter. S'il reste des contradictions bloquantes, demander à l'utilisateur s'il veut exporter quand même (fichier marqué « version de travail »).
2. Assembler
Script fourni (ordre garanti, notes d'auteur retirées) :
python3 ${HERMES_SKILL_DIR}/scripts/assemble.py \
--chapters <manuscrit>/chapitres \
--out <manuscrit>/exports/livre.md \
--title "<Titre>" --author "<Auteur>" --strip-notesLe script affiche le nombre de mots par fichier et le total : c'est la mesure de référence.
Il écrit aussi exports/meta.txt (titre, auteur, nb de chapitres, mots) pour l'étape suivante.
3. Exporter
DOCX — chemin principal, sans dépendance externe :
python3 ${HERMES_SKILL_DIR}/scripts/md_to_docx.py \
--in <manuscrit>/exports/livre.md \
--out <manuscrit>/exports/livre.docx \
--title "<Titre>" --author "<Auteur>"Utilise python-docx s'il est installé, sinon bascule automatiquement sur un écrivain OOXML
en bibliothèque standard. Le .docx obtenu est valide dans les deux cas (le moteur employé
est affiché en sortie).
Si pandoc est présent (command -v pandoc), préférer pandoc pour EPUB et PDF :
pandoc <manuscrit>/exports/livre.md -o <manuscrit>/exports/livre.epub \
--toc --epub-chapter-level=1 \
--metadata title="<Titre>" --metadata author="<Auteur>" --metadata lang=fr
pandoc <manuscrit>/exports/livre.md -o <manuscrit>/exports/livre.pdf \
--pdf-engine=xelatex -V lang=fr -V geometry:margin=2.5cm -V fontsize=11pt --tocLe PDF exige un moteur LaTeX : vérifier command -v xelatex avant de promettre un PDF.
S'il manque, livrer .md + .docx et donner la commande d'installation manquante — ne pas
bricoler une conversion approximative.
4. Vérifier le fichier produit
Obligatoire, pas décoratif :
ls -lh <manuscrit>/exports/
python3 verif_docx.py <manuscrit>/exports/livre.docx # ou le bloc ci-dessousBloc de vérification équivalent :
import zipfile, re
p = "<manuscrit>/exports/livre.docx"
z = zipfile.ZipFile(p)
assert z.testzip() is None, "paquet corrompu"
xml = z.read("word/document.xml").decode("utf-8", errors="replace")
texte = re.sub(r"<[^>]+>", "", xml)
print("paragraphes :", len(re.findall(r"<w:p[ >]", xml)))
print("mots :", len(texte.split()))
print("tete :", texte[:80].strip())
print("queue :", texte[-80:].strip())Trois contrôles obligatoires : le paquet est intègre (testzip()), le nombre de mots du
.docx est du même ordre que celui annoncé par assemble.py, et la tête/queue du document
correspondent au premier et au dernier chapitre. Un .docx de quelques centaines d'octets
est un échec, pas un succès.
Pièges
- Exporter avant de contrôler. Le fichier circule, les fautes de canon aussi.
- Ordre de chapitres faux.
ls | sortimpose des noms numériques à deux chiffres (01-,02-, …10-) :1-,10-,2-s'ordonnent mal. - Notes d'auteur publiées. Filtrer les sections
## Notes,## TODOavant l'export. - PDF annoncé sans moteur LaTeX. Vérifier
xelatexavant de promettre un PDF. - Titre dupliqué. Ne pas remettre le titre dans le Markdown assemblé :
assemble.pyne l'écrit pas, c'estmd_to_docx.py/pandoc qui posent la page de titre. - Casse des caractères accentués. Toujours
--metadata lang=fr(etxelatex, jamaispdflatexpar défaut, pour les accents).
Vérification
Le livrable est valide si : le fichier existe avec une taille > 0, il s'ouvre (test zipfile
pour docx/epub), et le nombre de chapitres dans le fichier = nombre de fichiers source.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

