k-dense-ai/pptx-posters
Create and audit editable scientific posters in macro-free PowerPoint (.pptx) from author-approved local content and assets. Use when the requested deliverable is a PowerPoint research/conference poster and exact physical, printer, accessibility, provenance, and package-security checks are required.
npx skills add https://github.com/K-Dense-AI/scientific-agent-skills --skill pptx-posters
Use this skill only when the requested source/deliverable is an editable PowerPoint
poster. Do not route an unspecified poster request here merely because PowerPoint is
available.
Version 2.0 generates a real one-slide .pptx from strict local JSON. It does not use
HTML conversion, external templates, schematic/image-generation services, API keys,
environment files, network requests, or mandatory figure styles.
Stop instead of guessing when any gate is unmet:
license, or QR target is unresolved.
.pptm, contains macros/external relationships/OLE/embedded files,or is an untrusted template.
Never fabricate missing material or leave a plausible placeholder. Drafts fail closed.
From the skill directory:
uv venv
uv pip install "python-pptx==1.0.2" "Pillow==12.3.0" "lxml==6.1.1"
Generation requires exactly:
python-pptx==1.0.2
Pillow==12.3.0
lxml==6.1.1
All CLIs use lazy optional imports, so python -B scripts/<tool>.py --help works
without these packages. Use -B to avoid bytecode artifacts.
Record these separately:
an exact source.
substitution/proof workflow.
There is no universal poster size. Microsoft currently limits each custom PowerPoint
dimension to 1–56 inches and uses one size for all slides. If the physical artboard
is larger, use a proportional canvas only when the printer confirms scaling.
Read references/poster_layout_design.md.
Copy assets/poster_manifest_template.json into the project. The template is
deliberately invalid until every replacement token, false confirmation, and draft
approval is resolved.
Follow references/manifest_spec.md and references/poster_content_guide.md.
The manifest requires:
author_verified: true on every source;author_approved: true on every element and asset;To obtain the content hash after all non-approval fields pass:
python -B scripts/validate_manifest.py poster.json \
--print-content-hash
Give that exact manifest and hash to the author. Then set approval.status to
approved, record approver and offset-aware timestamp, and copy the hash. Any
non-approval edit invalidates approval.
Validate the approved manifest and local assets:
python -B scripts/validate_manifest.py poster.json
python -B scripts/inventory_images.py poster.json \
--output poster.assets.json
python -B scripts/check_palette.py poster.json \
--output poster.palette.json
python -B scripts/plan_export.py poster.json \
--output poster.export-plan.json
Effective DPI is pixels divided by final placed inches, not image metadata DPI.
The inventory fully decodes bounded images and blocks EXIF/XMP/comments and embedded
text/application metadata;
strip those offline, then rehash and reapprove the asset.
Contrast uses WCAG 2.2 sRGB mathematics; applying those values to a physical poster is
a design target, not a standalone conformance claim. Keep color-redundant labels,
markers, shapes, patterns, or line styles.
If the printer requires CMYK, the plan blocks print-readiness until a
printer-approved conversion/profile and proof exist. Do not claim that a native
PowerPoint PDF is CMYK-compliant.
Read references/poster_design_principles.md.
Use a new output path:
python -B scripts/generate_poster.py poster.json \
--output poster.pptx \
--report poster.generation.json
Generation:
contain fitting;and existing destinations.
It renders exact manifest text. It does not compose, summarize, research, or correct
scientific content.
python -B scripts/inspect_pptx.py poster.pptx \
--output poster.package.json
python -B scripts/check_layout.py poster.pptx \
--manifest poster.json \
--output poster.layout.json
The package inspector reads bounded ZIP metadata and selected XML only. It never
extracts members or opens/executes the presentation. It rejects:
.pptx extension, including .pptm;excessive compression ratios;
Read references/pptx_security.md.
Automation cannot certify accessibility, text rendering, or scientific accuracy.
In a fully patched PowerPoint:
equations, overflow, contrast, and all edges.
Microsoft's 18 pt slide recommendation is not a universal poster minimum. Evaluate
font size at final physical output using the manifest's labeled basis and proofs.
Use the approved export plan. When PDF is required, export from the reviewed
PowerPoint using Standard/high print quality rather than Minimum size.
Independently verify the PDF:
Print a reduced-scale proof and obtain the printer's required proof. Re-run all checks
after any change.
Use assets/poster_quality_checklist.md for release sign-off.
validate_manifest.py — strict content/provenance/approval validator.generate_poster.py — exact-pinned local PPTX generator.inspect_pptx.py — non-executing ZIP/XML security inspector.check_layout.py — bounds, overlap, reading-order, and final-font checker.inventory_images.py — asset hash/metadata/effective-DPI manifest.check_palette.py — WCAG contrast and heuristic palette report.plan_export.py — dimensions, scale, fonts, color, media, export, and print preflight.references/manifest_spec.mdreferences/poster_content_guide.mdreferences/poster_design_principles.mdreferences/poster_layout_design.mdreferences/pptx_security.mdreferences/security_validation.mdreferences/source_ledger.mdTake k-dense-ai/pptx-posters from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip, uv.
Without those the skill loads but fails at the first command.