ckb/.agents/modules/convert/module.yaml
Michał Kopeć c57ddceffd Template 2.2.0: voice and convert modules
- 2.1.0 new opt-in `voice` module (D-0020): skill ckb-voice rewrites every
  prose file written under apply_to (outputs/answers, documents, reports,
  PROJECT-OVERVIEW) in a voice whose profile is a wiki page,
  wiki/voice/<name>.md (type voice-profile); settings in ckb.yaml (mode,
  profile, writer, apply_to, skip, chat); frozen spans never change, vague
  claims flagged not cut; `writer:` delegates to an external rewriting
  skill such as a personal ghost-writer. ckb-module writes a manifest's
  default_config into the entry's config:. Eval ckb-module/install-voice.
- 2.2.0 new opt-in `convert` module (D-0021): skill ckb-convert and
  convert.py turn Markdown into Word/ODT/PDF/HTML through pandoc with a
  house style in templates/styles/; unit tests and eval
  ckb-module/install-convert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 20:57:39 +01:00

56 lines
2.1 KiB
YAML

# Cascade KB module manifest — read by `ckb-module` on install/uninstall.
# See docs/decisions/0021-convert-module.md.
name: convert
title: Document conversion with house styles
version: 1.0.0
requires_kb_schema: "1.7"
summary: >
Turns any Markdown file in the KB (a document from a template, a kept
answer, a report, a wiki page) into Word, OpenDocument, PDF or HTML through
pandoc, in a named house style kept in templates/styles/, so nobody has to
pick fonts, sizes or margins by hand.
skills:
- ckb-convert
# Created on install, never removed on uninstall: it holds the user's styles.
scaffold:
- path: templates/styles/
from: scaffold/styles-README.md
as: templates/styles/README.md
note: House styles, one NAME.docx per style (NAME.odt and NAME.css optional).
agents_fragment: fragments/agents-routing.md
gitignore_fragment: fragments/gitignore.snippet
# Written under this module's `config:` in ckb.yaml on install; ckb-convert
# owns them afterwards ("make PDF the default", "use the board style").
default_config:
style: house # templates/styles/<style>.docx, used when the request names none
format: docx # docx | odt | pdf | html
out_dir: outputs/documents/ # for files outside outputs/; a file in outputs/ converts beside itself
toc: false # table of contents
number_sections: false
keep_links: false # true = keep links to KB paths (dead outside the KB)
schema_additions:
types: []
fields: []
depends_on:
- name: pandoc
scope: all
check: "command -v pandoc"
optional: true
note: >
Does every conversion, so nothing converts without it. Optional only for
the install: the module is committed and shared, and a teammate without
pandoc is told how to get it when they first convert. Never installed
without asking.
- name: libreoffice
scope: pdf-and-odt
check: "command -v soffice || command -v libreoffice"
optional: true
note: >
Turns the styled .docx into PDF or ODT so every format looks the same.
Without it PDF needs a pandoc PDF engine and ignores the Word style.