morph_skill

Overview

This skill converts documents between common formats (Markdown, Word, Excel, PDF, HTML, draw.io, Mermaid) while preserving structure, styling, metadata, and cross-references. It focuses on high-fidelity transformations, batch processing, template application, and automated verification. Use it to produce deliverables, archives, or distribution-ready files from source artifacts created by other agents or tools.

How this skill works

Morph analyzes the source file to detect structure, unsupported features, and dependencies, then selects the optimal conversion toolchain (pandoc, LibreOffice, wkhtmltopdf, mermaid-cli, drawio-cli) and applies templates or style sheets. After conversion it runs automated QA checks—structure, visual fidelity, content integrity, and metadata—then packages outputs, applies optional PDF/A, signatures, watermarks, or encryption, and delivers files with a verification summary.

When to use it

• Produce a print-ready PDF from a Markdown spec or HTML report
• Generate Word deliverables from technical Markdown for stakeholder editing
• Batch-convert a directory of mixed formats for archival (PDF/A)
• Export diagrams (draw.io, Mermaid) to embedable PNG/PDF files
• Apply corporate templates and generate TOC, headers/footers, and metadata
• Prepare accessible PDFs (PDF/UA, WCAG) or apply digital signatures and encryption

Best practices

• Run ANALYZE phase first to detect unconvertible features and ask clarifying questions
• Choose toolchains per conversion matrix (pandoc for Markdown↔HTML/Word, LibreOffice for Excel→PDF)
• Provide or select a template before conversion to avoid style rework
• Verify output with automated QA metrics and a visual spot-check for critical pages
• Use batch processing with reusable config files and commit conversion scripts to project journal
• Escalate permission or sensitive-data concerns before including in batch jobs

Example use cases

• Scribe-produced PRD (Markdown) → Morph → corporate-branded PDF with TOC and embedded diagrams
• Harvest monthly reports (HTML/CSV) → Morph → management-ready Word and PDF bundles
• Canvas diagrams (draw.io/Mermaid) → Morph → single-file PNG and printable PDF exports
• Quill documentation (HTML) → Morph → PDF/A archive with accessibility tagging and metadata
• Batch convert a release folder to PDF for stakeholder distribution and archival