| name | pdf-ops |
| description | Generate, inspect, and refine PDF deliverables for product work. Use when someone says PDF report, export doc, render check, layout review, extraction, or printable brief. Produce validated PDF artifacts plus a concise quality checklist and revision notes.
|
| license | Apache-2.0 |
| metadata | {"author":"shipwright","version":"1.0.0","tags":["pdf","documentation","reporting","quality-assurance","product-management"]} |
PDF Ops
When to Use This Skill
Use this skill when a PM needs to create, inspect, or improve a PDF.
Run it for product briefs, release reports, stakeholder packs, or any PDF export that must be readable and visually clean.
Read references/pdf-workflow.md before generating output.
Capabilities
- Create structured PDFs from markdown or provided content.
- Extract text from existing PDFs for summarization or comparison.
- Validate rendering quality page-by-page before sharing.
- Return a revision log with concrete fixes when issues are found.
Instructions
- Confirm the task type:
create, review, extract, or revise.
- Confirm required output:
destination filename, audience, page style, and language.
- If creating a PDF, build the content outline first, then generate.
- If reviewing, inspect both text content and rendered layout.
- Report issues with severity:
critical (must fix), major (should fix), minor (nice to fix).
- Always include a quality checklist:
headers, spacing, page breaks, tables, and legibility.
- If local dependencies are missing, degrade gracefully:
state what is missing and provide install commands.
- Keep all file paths explicit and avoid assumptions about platform-specific tools.
Dependency Guidance
Preferred Python packages:
python -m pip install reportlab pdfplumber pypdf
Optional renderer for visual checks:
pdftoppm -png INPUT.pdf page
If pdftoppm is unavailable, continue with text and metadata checks and call out that visual validation is partial.
Output Format
Task Summary
- Mode: create | review | extract | revise
- Input files:
- Output files:
Result
- What was produced or analyzed
- Key findings
Quality Checklist
- Typography and spacing
- Page flow and breaks
- Tables/charts readability
- File integrity
Next Actions
- Required fixes
- Optional improvements
Example Input
Review this release summary PDF and list layout defects before I send it to leadership.
Example Output
A prioritized PDF review with detected defects, suggested fixes, and a clear share/no-share recommendation.