Skip to content

siril9/presentation-skill / plugins/presentation-skill/skills/presentation-skill

presentation-skill

Flagged

Build, edit, redesign, render, and verify content-led, structurally diverse, clean, editable, reproducible PowerPoint `.pptx` decks. Use for scientific, lab, clinical, consulting, board, investor, editorial, policy, and operational presentations where alignment, readability, contrast, and balanced density matter.

FileKindSize
DESIGN.mdmarkdown13.7 KB
DISCOVERY.mdmarkdown6.6 KB
LICENSEother1.0 KB
SKILL.mdskill md14.7 KB
agents/discovery.jsonconfig8.2 KB
agents/openai.yamlconfig309 B
examples/outline.jsonconfig3.4 KB
package-lock.jsonmanifest22.0 KB
package.jsonmanifest1.8 KB
references/agent_picker.mdmarkdown1.9 KB
references/alignment_and_coherence.mdmarkdown2.1 KB
references/assets/visual_references/editorial_chart.jpgbinary53.2 KB
references/assets/visual_references/editorial_decision.jpgbinary100.4 KB
references/assets/visual_references/editorial_focal_metric.jpgbinary45.4 KB
references/assets/visual_references/editorial_pilot.jpgbinary62.0 KB
references/assets/visual_references/lab-native-method.jpgbinary53.9 KB
references/assets/visual_references/lab-residual-panels.jpgbinary64.8 KB
references/assets/visual_references/lab_cover.jpgbinary39.8 KB
references/assets/visual_references/lab_endpoints.jpgbinary70.8 KB
references/assets/visual_references/lab_evidence_gate.jpgbinary67.3 KB
references/assets/visual_references/lab_trend.jpgbinary60.5 KB
references/assets/visual_references/operations_handoffs.jpgbinary87.2 KB
references/assets/visual_references/operations_owner_register.jpgbinary87.2 KB
references/assets/visual_references/operations_queue.jpgbinary81.8 KB
references/assets/visual_references/operations_tradeoff.jpgbinary99.9 KB
references/benchmark_protocol.mdmarkdown12.1 KB
references/codex_guardrails.mdmarkdown10.3 KB
references/composition_grammar_catalog.mdmarkdown4.0 KB
references/deck_creation.mdmarkdown1.4 KB
references/deck_workspace_mode.mdmarkdown34.4 KB
references/design_philosophy.mdmarkdown5.5 KB
references/dynamic_design_and_subagents.mdmarkdown12.3 KB
references/editing.mdmarkdown12.4 KB
references/external_best_practices.mdmarkdown1.7 KB
references/large_style_corpus_sources.jsonconfig22.7 KB
references/model_adaptive_workflow.mdmarkdown6.6 KB
references/outline_schema.mdmarkdown44.8 KB
references/planning_schema.mdmarkdown54.8 KB
references/pptxgenjs.mdmarkdown7.6 KB
references/preview_extension.mdmarkdown1.7 KB
references/reference_script_patterns.mdmarkdown13.5 KB
references/renderer_role_contracts_v2.jsonconfig38.2 KB
references/reproducible_workflow.mdmarkdown5.1 KB
references/speed_and_rendering.mdmarkdown4.6 KB
references/style_grammar_index.jsonconfig364.2 KB
references/style_inspiration_corpus.jsonconfig32.9 KB
references/style_reference_catalog.mdmarkdown23.9 KB
references/style_reference_sources.jsonconfig35.8 KB
references/style_token_atlas.jsonconfig174.7 KB
references/subagent_patterns.mdmarkdown10.2 KB
references/visual_qa_prompt.mdmarkdown4.9 KB
references/visual_reference_catalog.jsonconfig26.6 KB
references/visual_reference_catalog.mdmarkdown6.0 KB
schemas/deck_ir.schema.jsonconfig9.5 KB
schemas/renderer_capabilities_v2.jsonconfig701 B
scripts/accessibility_qa.pyscript24.8 KB
scripts/action_registry.pyscript12.5 KB
scripts/add_slide.pyscript8.6 KB
scripts/advance_delivery.pyscript88.2 KB
scripts/advance_workspace.pyscript150.3 KB
scripts/apply_artifact_manifest_bindings.pyscript54.1 KB
scripts/apply_atom_composition.pyscript8.2 KB
scripts/apply_data_analysis_handoff.pyscript67.0 KB
scripts/apply_deck_intake_answers.pyscript35.6 KB
scripts/apply_design_contract.pyscript71.7 KB
scripts/apply_outline_authoring_handoff.pyscript23.7 KB
scripts/apply_pptx_style_fragment.pyscript19.7 KB
scripts/asset_stage.pyscript24.6 KB
scripts/audition_styles.pyscript8.7 KB
scripts/benchmark_decks.pyexecutablescript45.4 KB
scripts/build_deck.pyexecutablescript173.6 KB
scripts/build_deck_pptxgenjs.jsexecutablescript72.7 KB
scripts/build_large_style_corpus_contact_sheets.pyscript18.1 KB
scripts/build_workspace.pyscript126.2 KB
scripts/clean_unpacked.pyscript12.9 KB
scripts/compact_source_footers.pyscript17.8 KB
scripts/composition_grammar_catalog.pyscript30.3 KB
scripts/deck_benchmark.pyscript71.1 KB
scripts/deck_intake.pyscript6.9 KB
scripts/deck_ir.pyscript47.5 KB
scripts/design_catalog_selector.pyscript17.4 KB
scripts/design_rules_qa.pyscript24.8 KB
scripts/design_tokens.pyscript20.3 KB
scripts/edit_deck.pyscript8.4 KB
scripts/emit_content_research.pyscript4.6 KB
scripts/emit_data_analysis_prompt.pyscript30.1 KB
scripts/emit_deck_intake_prompt.pyexecutablescript19.9 KB
scripts/emit_deck_start_packet.pyscript97.1 KB
scripts/emit_design_contract_prompt.pyscript66.2 KB
scripts/emit_outline_authoring_prompt.pyscript35.4 KB
scripts/emit_outline_critique.pyscript11.6 KB
scripts/emit_style_content_router.pyscript49.6 KB
scripts/extract_outline.pyexecutablescript4.1 KB
scripts/extract_pptx_style.pyscript33.2 KB
scripts/fetch_wikimedia_cc.pyscript8.6 KB
scripts/finalize_quick_deck.pyscript17.6 KB
scripts/generate_openai_image.pyscript5.6 KB
scripts/init_deck_workspace.pyscript74.4 KB
scripts/inspect_artifact_manifest.pyscript29.8 KB
scripts/inventory.pyscript10.6 KB
scripts/iterate_deck.pyexecutablescript10.2 KB
scripts/layout_lint.pyscript40.4 KB
scripts/log_skill_telemetry.pyscript6.9 KB
scripts/model_adaptive_workflow.pyscript28.0 KB
scripts/office_package_hash.pyscript1.6 KB
scripts/pack_pptx.pyscript5.7 KB
scripts/palette_from_topic.pyscript4.1 KB
scripts/plan_research_assets.pyscript13.1 KB
scripts/preflight.pyscript136.9 KB
scripts/present.pyscript9.6 KB
scripts/python_runtime.pyscript787 B
scripts/qa_gate.pyexecutablescript27.4 KB
scripts/qa_visual_gate.pyexecutablescript8.5 KB
scripts/reference_deck.pyscript12.7 KB
scripts/render_cache.pyscript3.9 KB
scripts/render_mermaid.pyscript8.9 KB
scripts/render_slides.pyexecutablescript19.4 KB
scripts/repair_packet.pyscript14.7 KB
scripts/report_delivery_readiness.pyscript107.6 KB
scripts/report_workspace_readiness.pyscript244.6 KB
scripts/requirements-runtime.txtmarkdown472 B
scripts/role_layout_contracts.pyscript10.6 KB
scripts/runtime_doctor.pyscript6.3 KB
scripts/scaffold_figure_artifacts.pyscript92.3 KB
scripts/source_fidelity.pyscript30.5 KB
scripts/structural_diversity_v2.pyscript32.5 KB
scripts/style_atom_router.pyscript14.5 KB
scripts/style_inspiration_corpus.pyscript15.1 KB
scripts/style_reference_catalog.pyscript142.8 KB
scripts/style_reference_sources.pyscript12.7 KB
scripts/style_treatment_profiles.pyscript26.0 KB
scripts/summarize_skill_log.pyscript7.0 KB
scripts/taste_grammar_catalog.pyscript27.0 KB
scripts/test_structural_diversity_v2.pyscript4.9 KB
scripts/text_fit.pyscript23.6 KB
scripts/thumbnail.pyscript9.2 KB
scripts/trim_image_whitespace.pyexecutablescript5.4 KB
scripts/unpack_pptx.pyscript8.3 KB
scripts/upgrade_renderer_role_contracts_v2.pyscript7.3 KB
scripts/validate_planning.pyscript169.2 KB
scripts/verify_narration.pyscript10.6 KB
scripts/visual_qa.pyscript7.7 KB
scripts/visual_review.pyscript41.1 KB
scripts/visual_review_receipt.pyscript8.3 KB
scripts/workflow_atom_context.pyscript17.3 KB
templates/pptxgenjs/README.mdmarkdown8.4 KB
templates/pptxgenjs/presets.jsscript5.6 KB
templates/pptxgenjs/readable_role_layouts.jsscript17.5 KB
templates/pptxgenjs/render_plan.jsscript12.6 KB
templates/pptxgenjs/role_layout_contracts.jsscript4.7 KB
templates/pptxgenjs/slides.jsscript451.0 KB
templates/pptxgenjs/space_allocation.jsscript1.6 KB

DISCOVERY.md

View on GitHub
# Discovery and Adoption

`presentation-skill` 0.14.0 is an MIT-licensed, source-first PowerPoint skill
for coding agents with local tool access. Write `outline.json`, build an
editable `.pptx`, check retained source content and layout, then inspect the
actual rendered slides.

## Why Use It

- Source JSON, local data, and figure scripts remain rebuildable; repair source
  rather than patching a generated deck when its source exists.
- Native PowerPoint text, charts, and tables stay editable where supported.
  Native ordered methods carry 2-4 editable stages with titles/details.
  Scientific figures offer `panel-grid`, `primary-rail`, `ledger-rail`, and
  `strip-readout` layouts with `open`, `ruled`, or `panel` frames; sidebars
  measure the declared interpretation at readable type. Imported images and
  rendered figures are not editable data objects.
- Content-led layouts vary with the argument, not just the palette. Scientific,
  lab, clinical, board, investor, editorial, and operational decks share a
  deterministic renderer without a mandatory slide sequence.
- Normal QA checks geometry, readability, placeholders, accessibility, and
  mapped visible source fields, including captions, caveats, units, and native
  chart values. Source retention is not factual verification or exhaustive
  coverage of every field; actual rendered review remains necessary.
- One capable model, including GPT-6.1, can use a compact brief, source authoring,
  and finalization. Fast briefs expose actual evidence fallback variants;
  those routes do not claim v2 slot execution.
  Questions, style auditions, and saved workspaces are optional. Focused repair
  packets and verified render caching reduce repeated work without reusing
  stale visual approval. Exact PPTX/render hashes can bind a human/model review.

## Install

For a coding agent supported by the [skills CLI](https://github.com/vercel-labs/skills):

```bash
npx skills add https://github.com/siril9/presentation-skill \
  --skill presentation-skill
```

Installer support is not a claim that this skill has been tested in every agent.
For the pinned Codex plugin release:

```bash
codex plugin marketplace add siril9/presentation-skill --ref v0.14.0
```

Then open `/plugins` in Codex and install `presentation-skill` from the
repository's **Presentation Skill** marketplace. This is a repository-provided
marketplace, not a claim of official or globally curated marketplace inclusion.
Follow the [README setup instructions](https://github.com/siril9/presentation-skill#install)
for runtime dependencies. Run commands from the installed skill directory.
Ordinary chat without local execution tools cannot run this workflow directly.

## Try It

```text
Use presentation-skill to build a 7-slide editable lab-report PowerPoint from
this CSV. Treat outline.json as source. Retain units, denominators, captions,
and limitations; choose layouts from the evidence, run QA, and inspect the
actual rendered slides before delivery.
```

Read [SKILL.md](SKILL.md) for the compact brief -> source -> finalize route.
Use workspace mode only when the deck needs saved planning or repeated rebuilds.
Generation does not require LibreOffice; full rendered verification requires
the supported LibreOffice/Poppler tools. A deferred render is not approval.

## Release Evidence

Three eight-slide public studies provide 24 actual slides: a white calibration
decision, a dark contrast seminar, and a light sampling report. Source outlines,
seeded data and figure scripts make the examples reproducible.

- [Scientific/report showcase](https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_showcase.jpg)
  and [release manifest](https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_studies/release_manifest.json).
- Full contact sheets: [white calibration](https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_studies/white_calibration_contact_sheet.jpg),
  [dark contrast](https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_studies/dark_contrast_contact_sheet.jpg),
  and [light sampling report](https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_studies/light_river_report_contact_sheet.jpg).
- [v0.14.0 release](https://github.com/siril9/presentation-skill/releases/tag/v0.14.0)
  and [three decks plus source ZIP](https://github.com/siril9/presentation-skill/releases/download/v0.14.0/presentation-skill-v0.14-lab-studies.zip).
- Individual editable decks: [calibration](https://github.com/siril9/presentation-skill/releases/download/v0.14.0/white_calibration.pptx),
  [contrast](https://github.com/siril9/presentation-skill/releases/download/v0.14.0/dark_contrast.pptx),
  and [sampling](https://github.com/siril9/presentation-skill/releases/download/v0.14.0/light_river_report.pptx).

Only invented synthetic nonclinical data are used. The studies are not real-world
findings, model-quality benchmarks, or evidence of superiority over another
generator. History: [previous proof and downloads](https://github.com/siril9/presentation-skill/releases/tag/v0.13.1).

The optional [Slide Review extension](extensions/preview/README.md) is a local
pilot. Core use does not require it; no globally hosted or curated listing is claimed.

## Agent and Directory Routing

Trigger requests include PowerPoint, PPTX, slide deck, presentation, deck
redesign, scientific figures, CSV/Excel-to-slides, and layout/readability QA.
Search terms: source-first PPTX generator, editable PowerPoint skill, Codex
presentation skill, scientific slide deck, agent presentation QA.

`SKILL.md` frontmatter supplies the skill name and a description with trigger
phrases. Search aliases are separate metadata in
[agents/discovery.json](agents/discovery.json), not an `aliases` frontmatter
field or a guarantee of fuzzy matching. [agents/openai.yaml](agents/openai.yaml)
provides the agent-facing prompt. Skip pure text brainstorming when no deck
artifact is needed.

## Share

General links: [repository](https://github.com/siril9/presentation-skill),
[latest release](https://github.com/siril9/presentation-skill/releases/latest),
[skills.sh listing](https://www.skills.sh/siril9/presentation-skill/presentation-skill).
Use pinned release links only for version-specific installation and evidence.
[Promotion copy](https://github.com/siril9/presentation-skill/blob/main/docs/PROMOTION.md)
is short and ready to adapt. Useful feedback includes the prompt, source,
affected slide, and rendered image for a concrete content or design miss.
For the official public plugin submission route, see the
[publication guide](https://github.com/siril9/presentation-skill/blob/main/docs/PLUGIN_PUBLICATION.md).
Submission is not a claim of acceptance or marketplace curation.
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall