kidoclisted

# kidoc — Engineering Documentation Skill Generate professional engineering documentation from KiCad project files. ## Quick Start One command generates the full scaffold — analyses, diagrams, renders, and markdown are all produced automatically: ```bash python3 skills/kidoc/scripts/kidoc_scaffold.py \ --project-dir /path/to/kicad/project \ --type hdd \ --output reports/HDD.md ``` This auto-detects `.kicad_sch` and `.kicad_pcb` files, runs schematic/PCB/EMC/thermal analyses, generates block diagrams and schematic SVG renders, and produces a structured markdown scaffold with pre-filled data tables and narrative placeholders. To produce a PDF: ```bash python3 skills/kidoc/scripts/kidoc_generate.py \ --project-dir /path/to/kicad/project \ --doc reports/HDD.md \ --format pdf ``` Creates `reports/.venv/` automatically on first run (PDF/DOCX/ODT only — HTML is zero-dep). ## Workflow 1. **Generate scaffold** — `kidoc_scaffold.py` auto-runs all available analyses, renders schematics, generates diagrams, and writes the markdown scaffold. 2. **Fill narratives** — The agent reads the scaffold and writes engineering prose for each `<!-- NARRATIVE: section_name -->` placeholder. The engineer reviews and edits. 3. **Regenerate** — On re-run, data sections between `<!-- GENERATED: section_id -->` markers update from fresh analysis; user-written narrative content is preserved. 4. **Render output** — `kidoc_generate.py` produces PDF, HTML, DOCX, or ODT. ## Document Type