# PDF Presentation > Generate professional PDF reports and presentations from structured content. Converts evaluations, proposals, and assessments into polished PDFs with tables, score visualizations, and styled sections. Use when: generate PDF, create report, export to PDF, make presentation, create proposal document, export evaluation. - Skill: `juanmarchetto/pdf-presentation` (Agent Skill, multi-file: 6 files) - Install (CLI): `npx skillmds@latest add juanmarchetto/pdf-presentation` - Raw SKILL.md: https://api.skillmd.com/api/skills/juanmarchetto/pdf-presentation/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - License: MIT - Author: JuanMarchetto (https://skillmd.com/u/juanmarchetto) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/juanmarchetto/pdf-presentation --- # PDF Presentation Skill Generate professional PDF reports from structured content using WeasyPrint. ## When This Skill Activates Trigger phrases: "generate PDF", "create report", "export to PDF", "make presentation", "create proposal document", "export evaluation", "PDF report". ## Workflow ### Step 1: Analyze Content Identify what type of content needs to be exported: - **Architect Evaluation**: Look for Value Matrix, Opportunity Score (1-10), sub-scores, risk assessment, recommendations. Structure as a full evaluation report with title page. - **General Report/Proposal**: Any structured document with sections, headings, and body text. Structure with a cover page and sectioned layout. - **Comparison Table**: Side-by-side analysis of options. Structure with prominent tables. - **Scored Assessment**: Any content with numerical ratings or grades. Include SVG score visualizations. ### Step 2: Build the HTML Document Create a complete HTML file with inline CSS. Use the template structure from `assets/templates/report.html` as reference. The HTML must be self-contained (no external stylesheets, no external images). #### Structure ```html
``` #### CSS Guidelines - Use the professional color palette from the template: `#1a365d` (primary navy), `#2b6cb0` (accent blue), `#e2e8f0` (light gray), `#f7fafc` (background) - Set `@page` rules with 20mm margins, running headers/footers - Use `page-break-before: always` for major sections - Typography: system font stack, 11pt body, 1.6 line-height - Tables: alternating row colors, proper padding, header styling #### SVG Score Visualizations For numerical scores (1-10 scale), generate inline SVG elements: **Horizontal bar chart** for sub-scores: ```html 7/10 ``` The filled width = (score / max_score) * total_width. **Gauge circle** for overall scores: ```html 7.2 out of 10 ``` The stroke-dashoffset = circumference - (score / max_score) * circumference. Circumference for r=50 is ~314. **Color coding for scores:** - 8-10: `#38a169` (green) - 5-7: `#d69e2e` (amber) - 1-4: `#e53e3e` (red) #### Architect Evaluation Specifics When exporting Architect evaluation results, include these sections: 1. **Cover Page**: Idea/project name, evaluation date, mode (New Idea / Existing Project) 2. **Executive Summary**: 2-3 sentence overview with Go/No-Go recommendation 3. **Opportunity Score**: Large gauge SVG with overall score, then bar chart for all 6 sub-scores 4. **Value Matrix**: 3-column table (Commercial / Educational / Social) with scores and notes 5. **Evaluator Reports**: One section per evaluator with their findings 6. **Risk Assessment**: Risk matrix table with severity/likelihood 7. **Recommendations**: Prioritized action items 8. **Next Steps**: Concrete actionable items with timeframes ### Step 3: Write the HTML File Save the generated HTML to a temporary file. Use a descriptive filename: - For evaluations: `evaluation-.html` - For reports: `report-.html` - For proposals: `proposal-.html` Place it in the current working directory or a specified output directory. ### Step 4: Generate the PDF Run the generation script: ```bash python3 /scripts/generate_pdf.py -o ``` Where `` is the directory containing this SKILL.md file. If the user specified an output path, use that. Otherwise default to the current working directory with a descriptive filename like `report-.pdf`. ### Step 5: Report Results Tell the user: - The output PDF path (absolute) - Page count if available - Any warnings about content that could not be rendered ## Supported Content Types | Content Type | Key Elements | Template Sections Used | |---|---|---| | Architect Evaluation | Value Matrix, Opportunity Score, Risk Assessment | Cover, Summary, Scores, Matrix, Evaluators, Risk, Recommendations | | Project Proposal | Problem, Solution, Timeline, Budget | Cover, Summary, Sections, Tables, Recommendations | | Comparison Analysis | Options, Criteria, Scores | Cover, Summary, Comparison Tables, Scores | | General Report | Sections, Findings, Conclusions | Cover, Summary, Sections, Recommendations | | Meeting Notes | Agenda, Decisions, Action Items | Cover, Sections, Action Items | ## Requirements - Python 3.8+ - WeasyPrint (`pip install weasyprint`) - No other Python dependencies required ## Tips for Best Results - Provide structured content with clear headings and sections - Include numerical scores when possible for visual impact - Specify a title if you want a custom cover page heading - For Architect evaluations, the skill auto-detects the format from standard output ## Example Output ``` PDF generated: ./report-skills-evaluation.pdf - Pages: 8 - Sections: Cover, Executive Summary, Value Matrix, Risk Assessment, Recommendations - Score visualizations: Opportunity Score gauge (7.0/10), 6 sub-score bars - File size: 245 KB ``` The PDF includes: professional cover page with title and date, table of contents, color-coded score tables, SVG bar charts for sub-scores, risk assessment with severity indicators, and numbered recommendations. ## Fallback Without WeasyPrint If WeasyPrint is not installed, the skill generates a standalone HTML file instead. This HTML file: - Can be opened in any browser - Can be printed to PDF via Ctrl+P / Cmd+P - Contains all the same styling and visualizations - Is a valid intermediate output, not a degraded experience ## Error Handling - **WeasyPrint not installed**: Fall back to HTML output (see above). Suggest `pip install weasyprint` for full PDF support. - **Missing fonts**: WeasyPrint uses system fonts. If text renders incorrectly, specify a font family in the CSS or install the needed font. - **SVG not rendering**: Ensure SVG elements use inline styles, not CSS classes. WeasyPrint has limited CSS support for SVG. - **Large content overflows page**: The template uses CSS `page-break-inside: avoid` for tables and score blocks. If content still overflows, it splits across pages gracefully.