Document Generation Skills & Agents Roadmap
Prioritized Claude Code skills and automation agents to build for Solanasis document generation. Last Updated: 2026-04-12 Source Research: See
.ultra-plans/doc-generation-comparison-research-RESEARCH.mdSee also: document-generation-tool-comparison-matrix, ai-native-document-generation-playbook, ultimate-claude-code-skills-playbook
1. Current State
What exists today across the Solanasis document generation stack:
| Capability | Tool | Status | Location |
|---|---|---|---|
| Template-driven Google Docs/Slides | GWS CLI + generate-doc.py | Production | solanasis-scripts/generate-doc.py |
| Programmatic pitch decks | python-pptx + generate-pitch-deck.py | Production | solanasis-scripts/generate-pitch-deck.py |
| HTML-to-DOCX | python-docx/htmldocx | Partial | solanasis_core/.../solanasis_document_template.py |
| PDF post-processing | pypdf (merge, split) | Not built | N/A |
| Offline branded PDFs | Typst + typst-py | Not built (guide ready) | See typst-setup-and-brand-template-guide |
| Markdown-to-slides | Marp CLI | Not built (guide ready) | See marp-cli-setup-and-brand-theme-guide |
| Multi-format from Markdown | Pandoc | Not built (guide ready) | See pandoc-setup-and-brand-pipeline-guide |
Key assets already in place:
- Brand constants (Navy #020532, Copper C47A3D, Parchment FEF9F1, Warm Stone F0EBE4, Charcoal #111827; Fonts: Playfair Display, Montserrat, Libre Baskerville) defined in
generate-pitch-deck.pylines 40-88 - CLI scaffold template (
solanasis-scripts/templates/cli_scaffold.py) with argparse, —dry-run, —check-only, —json, check-registry, lazy imports - 16 Claude Code skills deployed globally, 3 project-level skills in solanasis-docs
- Ultra system operational for multi-step plan-execute-test-review pipelines
2. Priority 1: Near-Term Skills (Build within 2 weeks)
These four skills fill the highest-value gaps identified in the document-generation-tool-comparison-matrix Tier 2 tools. Each has a setup guide already written.
2.1 typst-proposal-generator skill
- Purpose: Generate branded PDF proposals from structured content using Typst + typst-py
- Trigger: When Claude Code needs to produce an offline PDF proposal or security report
- Pattern: Claude generates Markdown content → skill converts to Typst variables → typst-py compiles to PDF
- Dependencies: Typst CLI installed, typst-py installed, Solanasis .typ brand template created
- Effort: 4-6 hours (template creation + skill SKILL.md + test)
- Reuses: Brand constants from
generate-pitch-deck.py, CLI scaffold fromsolanasis-scripts/templates/cli_scaffold.py
2.2 marp-slide-generator skill
- Purpose: Generate branded PDF/HTML slides from Markdown content using Marp CLI
- Trigger: When Claude Code needs to produce quick internal presentations or training decks
- Pattern: Claude writes Markdown with Marp directives → skill invokes
marpCLI with Solanasis theme → outputs PDF/HTML - Dependencies: Marp CLI installed, Solanasis CSS theme created
- Effort: 2-3 hours (theme creation + skill SKILL.md + test)
- Reuses: Brand colors/fonts already defined
2.3 pdf-post-processor skill
- Purpose: Merge, watermark, encrypt, and split PDF deliverables
- Trigger: After any PDF generation, when post-processing is needed (e.g., add confidentiality watermark, merge cover + report)
- Pattern: Takes input PDF(s) → applies operations (merge, watermark with Solanasis logo, encrypt with password, split by page range) → outputs processed PDF
- Reference: Based on
anthropics/skills/pdffrom skills.sh (51K installs). Adapt to Python-first with pypdf library. - Dependencies:
pip install pypdf - Effort: 3-4 hours (script + skill SKILL.md + test)
- Reuses: Existing pypdf patterns
2.4 pandoc-multi-format skill
- Purpose: Convert Markdown to branded DOCX, PDF, or HTML using Pandoc
- Trigger: When a deliverable needs to be in multiple formats (e.g., client wants both PDF and DOCX)
- Pattern: Claude writes Markdown with YAML frontmatter → skill invokes Pandoc with appropriate template/reference doc → outputs requested format(s)
- Dependencies: Pandoc installed, Typst installed (for PDF), reference DOCX created
- Effort: 2-3 hours (reference doc creation + skill SKILL.md + test)
- Reuses: Typst template from skill #1, brand constants
3. Priority 2: Medium-Term Skills (Build within 1-2 months)
These skills build on top of Priority 1 and add orchestration or advanced patterns.
3.1 proposal-orchestrator agent
- Purpose: End-to-end proposal generation: research prospect → generate content → select best tool → produce deliverable → post-process
- Pattern: Orchestrates
typst-proposal-generator,marp-slide-generator,pandoc-multi-format, andpdf-post-processorbased on use case - This is an agent (multi-step), not a simple skill — uses
context: forkand coordinates multiple sub-skills in sequence - Effort: 8-12 hours
- Depends on: All Priority 1 skills built and tested
3.2 pptx-qa-inspector skill
- Purpose: Convert PPTX slides to PNG thumbnails for visual QA inspection
- Pattern: Based on
anthropics/skills/pptxQA workflow. Takes PPTX → converts each slide to PNG via LibreOffice → displays for Claude to inspect layout/branding - Dependencies: LibreOffice installed (
sudo apt install libreoffice-impress) - Effort: 3-4 hours
- Reuses: Pattern from anthropics/skills/pptx
3.3 pitch-deck-json-model skill enhancement
- Purpose: Adopt the structured JSON data model pattern from
ailabs-393/pitch-deckskill forgenerate-pitch-deck.py - Pattern: Define a JSON schema for pitch deck content (title, problem, solution, market, product, traction, business model, competition, team, financials). Claude fills the JSON, python-pptx renders it.
- Effort: 4-6 hours (JSON schema + script modification + test)
- Reuses: Existing
generate-pitch-deck.py, JSON pattern from ailabs-393
4. Priority 3: Future Considerations
These items are deferred unless a specific use case triggers them.
4.1 Carbone integration
Only if non-developer template editing becomes a requirement. Would allow editing DOCX/PPTX templates in Word/PowerPoint with {d.variable} markers. Requires Node.js (conflicts with Python-first convention). The template editability score (9/10) is the highest of any evaluated tool, making it the best choice if designers or account managers need to modify templates directly.
4.2 Quarto data reports
Only if data-heavy reports with embedded Python analysis become a regular deliverable. The _brand.yml concept is compelling for centralized branding — a single YAML file defines logo, colors, and fonts across all output formats. Best suited for security assessment dashboards with embedded charts, compliance scorecards, or any deliverable where live data feeds directly into the document.
4.3 MCP Server consolidation
Evaluate whether Office-PowerPoint-MCP-Server or Office-Word-MCP-Server add value over direct library usage. Currently, direct python-pptx and python-docx usage is simpler and has no MCP protocol overhead. Revisit if MCP becomes the standard integration pattern for document tools across multiple AI agents.
5. Skill Specifications
Planned file locations for each skill following the .claude/skills/ directory convention and solanasis-scripts/ for implementation scripts.
| Skill | Type | SKILL.md Location | Script Location | Test Location |
|---|---|---|---|---|
| typst-proposal-generator | Claude Code Skill | .claude/skills/typst-proposal-generator/SKILL.md | solanasis-scripts/generate-typst-proposal.py | solanasis-scripts/tests/test_generate_typst_proposal.py |
| marp-slide-generator | Claude Code Skill | .claude/skills/marp-slide-generator/SKILL.md | N/A (invokes marp CLI directly) | .claude/skills/marp-slide-generator/test/ |
| pdf-post-processor | Claude Code Skill | .claude/skills/pdf-post-processor/SKILL.md | solanasis-scripts/pdf_postprocess.py | solanasis-scripts/tests/test_pdf_postprocess.py |
| pandoc-multi-format | Claude Code Skill | .claude/skills/pandoc-multi-format/SKILL.md | N/A (invokes pandoc CLI directly) | .claude/skills/pandoc-multi-format/test/ |
| proposal-orchestrator | Claude Code Agent | .claude/skills/proposal-orchestrator/SKILL.md | solanasis-scripts/orchestrate_proposal.py | solanasis-scripts/tests/test_orchestrate_proposal.py |
| pptx-qa-inspector | Claude Code Skill | .claude/skills/pptx-qa-inspector/SKILL.md | solanasis-scripts/pptx_qa_inspect.py | solanasis-scripts/tests/test_pptx_qa_inspect.py |
Conventions applied:
- All skills follow the SKILL.md format documented in ultimate-claude-code-skills-playbook Section 1
- All scripts follow
solanasis-scripts/docs/cli-conventions.md(argparse, —dry-run, —check-only, —json) - Skills that wrap external CLIs (Marp, Pandoc) have no separate script — the SKILL.md contains the invocation instructions directly
- Skills with Python scripts place them in
solanasis-scripts/with corresponding tests insolanasis-scripts/tests/
6. Dependencies & Prerequisites
Tool Installation (Required before building Priority 1 skills)
| Tool | Install Command | Verification |
|---|---|---|
| Typst CLI | curl -fsSL https://install.typst.community/install.sh | sh | typst --version |
| typst-py | pip install typst | python3 -c "import typst" |
| Marp CLI | npm i -g @marp-team/marp-cli or download standalone binary | marp --version |
| Pandoc | sudo apt install pandoc | pandoc --version |
| pypdf | pip install pypdf | python3 -c "import pypdf" |
| LibreOffice (for pptx-qa-inspector) | sudo apt install libreoffice-impress | libreoffice --version |
Brand Assets (Required before template creation)
- Solanasis logo PNG (high-resolution, transparent background)
- Fonts installed system-wide: Playfair Display, Montserrat, Libre Baskerville (downloadable from Google Fonts)
- Brand template files created per the setup guides:
- Typst:
.typbrand template per typst-setup-and-brand-template-guide - Marp: CSS theme per marp-cli-setup-and-brand-theme-guide
- Pandoc: Reference DOCX per pandoc-setup-and-brand-pipeline-guide
- Typst:
Conventions (All skills must follow)
- All skills follow:
solanasis-scripts/docs/cli-conventions.md(argparse, —dry-run, —check-only, —json) - All skills follow:
.claude/skills/directory convention with SKILL.md file - All scripts include
--check-onlyflag for pre-flight verification - All scripts return
(status, message)tuples where status isOK,WARN, orFAIL - All skills are portable via the Agent Skills Open Standard (works across Claude Code, Codex CLI, Copilot, and 20+ other platforms)
Build Order
Week 1:
Install Typst + typst-py + Marp CLI + Pandoc
Create Typst brand template (.typ)
Create Marp CSS theme
Create Pandoc reference DOCX
Build: typst-proposal-generator skill
Build: marp-slide-generator skill
Week 2:
Build: pdf-post-processor skill
Build: pandoc-multi-format skill
Integration test: all 4 skills with real content
Month 2:
Build: proposal-orchestrator agent
Build: pptx-qa-inspector skill
Build: pitch-deck-json-model enhancement
See also: document-generation-tool-comparison-matrix, typst-setup-and-brand-template-guide, marp-cli-setup-and-brand-theme-guide, pandoc-setup-and-brand-pipeline-guide, ai-native-document-generation-playbook