docflow-presentations-and-docs-skill

name	docflow-presentations-and-docs-skill
description	DocFlow - Presentations and Docs Skill. Agent-agnostic office automation for DOCX/XLSX/PDF/PPTX with bilingual guidance (English/Español).
version	1.1.0
author	Tao Jin (shynloc) [original], Rafael Lozano [modifications] & contributors
license	MIT
metadata	{"hermes":{"tags":["office","docx","xlsx","pdf","pptx","automation","presentations","docs"],"runtime":"python","import":"from office_suite import OfficeSuite"},"openclaw":{"requires":{"bins":["python3"]},"trust":"medium","permissions":[{"read":"."},{"write":"."}]}}

DocFlow - Presentations and Docs Skill

EN: Local-first office automation skill for document and presentation workflows. ES: Skill local-first para automatización de documentos y presentaciones.

Scope | Alcance

EN:

• Create: DOCX, XLSX, PDF, PPTX
• Convert formats (LibreOffice-backed)
• Extract document text/data
• Batch conversions and watermark helpers
• Generate presentations with preflight preferences
• Build charts using:
  • Option A: native python-pptx
  • Option B: matplotlib image embedding
• Generate style-heavy presentations with HTML templates:
  • doc_type: html_pptx / pptx_html
  • Themes: neon-executive, cobalt-corporate, bold-pitch
  • Pipeline: HTML/CSS -> headless Chrome PNG -> PPTX
• File-based template catalog (v1.1):
  • doc_type: slide_template, slide_deck_templates, doc_template
  • 13 slide templates: editorial, manifesto, question, revenue, covers, brutalist, swiss-minimal, mono-editorial, KPI dashboard, chart comparison...
  • 6 document templates: invoice (modern + brutalist), exec/minimal reports, proposal cover, formal letter.
  • Agents discover templates via suite.list_templates() and the slot contract via suite.get_template_meta(id, category).

ES:

• Crear: DOCX, XLSX, PDF, PPTX
• Convertir formatos (con LibreOffice)
• Extraer texto/datos de documentos
• Conversión por lotes y helpers de watermark
• Generar presentaciones con preferencias preflight
• Crear gráficos con:
  • Opción A: python-pptx nativo
  • Opción B: matplotlib como imagen
• Generar presentaciones de estilo avanzado con plantillas HTML:
  • doc_type: html_pptx / pptx_html
  • Temas: neon-executive, cobalt-corporate, bold-pitch
  • Pipeline: HTML/CSS -> Chrome headless PNG -> PPTX
• Catálogo de plantillas basado en archivos (v1.1):
  • doc_type: slide_template, slide_deck_templates, doc_template
  • 13 plantillas de slides (editorial, manifesto, brutalist, swiss-minimal, KPI dashboard, etc.) y 6 de documentos (facturas, reportes, carta, propuesta).
  • El agente descubre plantillas con suite.list_templates() y su contrato de slots con suite.get_template_meta(id, category).

Safety model | Modelo de seguridad

EN:

• Local processing by default
• No hidden network calls for this skill runtime
• Never hardcode credentials

ES:

• Procesamiento local por defecto
• Sin llamadas de red ocultas en este runtime de la skill
• Nunca hardcodear credenciales

Quick start | Inicio rápido

# Standard
python -m pip install -r requirements.txt
python -m compileall src examples setup.py
python examples/basic_usage.py

# Isolated (uv)
uv run --with python-pptx --with python-docx --with openpyxl --with reportlab --with pypdf2 --with pandas --with pillow --with numpy --with matplotlib python examples/basic_usage.py

Python usage

from office_suite import OfficeSuite
suite = OfficeSuite()

suite.create(
    "word",
    title="Daily Report",
    content="# Summary\nDone.",
    output_path="./output/daily_report.docx",
)

File-based templates (slides + documents)

# Discover catalog
catalog = suite.list_templates()
# -> {"slides": [...], "documents": [...]}

# Read slot contract for one template
meta = suite.get_template_meta("invoice-modern", category="documents")

# Render ONE slide to PNG
suite.create(
    "slide_template",
    template="manifesto-grain",
    data={"number": "01", "total": "05", "points": [{"text": "..."}]},
    output_path="./output/slide.png",
)

# Build a full deck by mixing templates
suite.create(
    "slide_deck_templates",
    slides=[
        {"template": "cover-blue",        "data": {...}},
        {"template": "chart-kpi-dashboard","data": {...}},
        {"template": "mono-editorial",    "data": {...}},
    ],
    output_path="./output/deck.pptx",
)

# Render a document to PDF (invoice, report, letter, proposal...)
suite.create(
    "doc_template",
    template="invoice-modern",
    data={...},
    output_path="./output/invoice.pdf",
)

See docs/TEMPLATE_CATALOG.md for the full list and slot definitions.

PPTX preflight preferences (strict)

Required keys when require_preflight=True:

• theme: midnight-luxe | aurora-glow | obsidian-slate | ivory-bloom | neon-velocity
• chart_mode: native | matplotlib | auto
• use_emojis: true | false
• tone: classic-formal | boardroom | conversational | laid-back

opts = suite.get_presentation_preflight_prompts()
print(opts)

Known limitations | Limitaciones actuales

• EN: PDF watermarking currently performs a safe pass-through copy + warning.
• ES: El watermark en PDF actualmente hace copia segura + advertencia.
• EN: PPT transition effects are placeholders due to python-pptx limits.
• ES: Los efectos de transición PPT son placeholder por limitaciones de python-pptx.