ce-house-style

name

ce-house-style

description

Collision Engineers house style and branded document generation. Use whenever a CE output needs the house visual layout, the house writing tone, or a branded document built. Modes: document-builder generates branded DOCX and PDF (letters, reports, fee notes, certificates) from a JSON spec via a self-contained ReportLab/python-docx engine with no external service; visual-layout for logo, typography, page headers/footers, brand red, and templates; writing-tone for the plain independent-engineer register, dispute/TPI wording, and anti-AI phrasing checks. Use this skill whenever you draft, brand, or format any CE client, court, insurer, valuation, repair, rebuttal, roadworthy, fee-note or invoice document, even if "house style" is not mentioned. Consumed by vehicle-valuation, damage-estimating, rebuttal, roadworthy, finance-document, and invoice drafts.

CE House Style

Shared Collision Engineers house style and a self-contained branded-document generator. Load this skill whenever document layout, written tone, or producing a branded DOCX/PDF is needed.

Modes

Mode	Use when	Load
document-builder	Producing a branded CE document — letter, report, fee note, certificate — as DOCX and/or PDF.	references/document-spec.md, scripts/ce_document.py, assets/examples/
visual-layout	Checking or describing brand layout (logo, typography, headers/footers, brand red, templates).	references/visual-layout.md and assets/
writing-tone	Drafting or revising client, court, insurer, invoice, rebuttal, valuation, or status wording.	references/writing-tone.md and references/query-responses.md

Building a branded document

The builder is self-contained (pure-Python ReportLab + python-docx, no system libraries), so it runs anywhere including Claude Desktop. One-time setup:

python -m pip install -r src/skills/ce-house-style/requirements.txt

Describe the document as a JSON spec (schema in references/document-spec.md; start from assets/examples/report.json or letter.json), then render:

python src/skills/ce-house-style/scripts/ce_document.py --spec my-spec.json --format both --out output

--format is docx, pdf, or both. The brand — logo, reference block, footer, red rules, table styling, fonts, margins — is applied automatically; you supply only the content. For the wording, follow writing-tone.md and reuse query-responses.md.

Governance

Assist/reference class. This skill formats and styles output; it does not approve expert findings or authorise external sends. The calling skill owns sign-off: valuation, roadworthy, rebuttal, salvage, and damage-estimating expert outputs remain AI-assisted drafts until a named human signs off.

Validation

• Drafts: python src/skills/ce-house-style/scripts/check_house_style.py <draft-or-spec> flags AI tell-tales and internal workflow terms before anything goes out.
• Generated documents: render assets/examples/report.json and letter.json and compare against the worked examples in assets/ and docs/reference/case-corpus/.
• Repository changes: python tools/verify_scaffold.py.