- 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>
56 lines
2.1 KiB
YAML
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.
|