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

agents/discovery.json

View on GitHub
{
  "schema": "presentation_skill_discovery_v1",
  "name": "presentation-skill",
  "version": "0.14.0",
  "license": "MIT",
  "repository": "https://github.com/siril9/presentation-skill",
  "summary": "Source-first, editable PowerPoint/PPTX generation and content-retention QA for coding agents with local tool access.",
  "one_line": "Author outline.json, build native editable slides, check mapped source retention and layout, and inspect actual renders before delivery.",
  "primary_audience": [
    "coding agents with local filesystem and execution tools",
    "developers building generated PowerPoint workflows",
    "people who need rebuildable lab, clinical, investor, board, editorial, or operational decks"
  ],
  "trigger_phrases": [
    "build a PowerPoint",
    "create a PPTX",
    "generate a slide deck",
    "make a presentation",
    "redesign this deck",
    "run layout QA on this deck",
    "make a lab report deck",
    "make a clinical summary deck",
    "make an investor deck",
    "make a board memo deck",
    "turn this CSV or Excel file into slides",
    "create scientific figure slides",
    "make the deck rebuildable"
  ],
  "aliases": [
    "powerpoint-deck-builder",
    "pptx-skill",
    "PowerPoint skill",
    "PPTX skill",
    "slide-deck generator",
    "slides generator",
    "deck builder",
    "presentation generator",
    "presentation maker",
    "agent presentation skill",
    "Codex presentation skill",
    "ChatGPT presentation skill"
  ],
  "capabilities": [
    "source-first PowerPoint generation from outline.json, with native editable text, charts, and tables where supported",
    "compact brief, source authoring, and finalization for one-off decks",
    "optional intake, style auditions, and saved planning workspaces",
    "content-led layouts across 16 content variants, 13 style families, and eight composition grammars",
    "bounded primary, alternate, and dense role layouts without a mandatory slide sequence",
    "on-demand descriptor style context and original visual references",
    "versioned coordinate-free Deck IR with stable semantic object identity",
    "preserve-by-default supported text and alt-text patching for standalone PowerPoint decks",
    "reproducible chart, table, and figure artifacts from local data",
    "native ordered methods with 2-4 editable title/detail stages and auto, strip, or bands allocation",
    "scientific panel-grid, primary-rail, ledger-rail, and strip-readout layouts with open, ruled, or panel frames",
    "measured figure sidebars that retain declared interpretation at readable type",
    "measured comparison fits and modern headers that preserve evidence space",
    "fast briefs expose supported evidence fallbacks without claiming v2 slot execution",
    "geometry, readability, placeholder, accessibility, and rendered-review checks",
    "mapped semantic visible-source retention checks for method titles/details, figure/sidebar interpretation, captions, caveats, units, denominators, table cells, and native chart values",
    "source-pointer repair packets for focused corrections",
    "verified render caching without stale visual-approval reuse",
    "hash-bound human or model visual-review receipts"
  ],
  "entrypoints": {
    "skill_contract": "SKILL.md",
    "agent_prompt": "agents/openai.yaml",
    "quick_example": "examples/outline.json",
    "present_cli": "scripts/present.py",
    "benchmark_protocol": "references/benchmark_protocol.md",
    "human_discovery": "DISCOVERY.md",
    "readme": "https://github.com/siril9/presentation-skill#readme",
    "plugin_publication": "https://github.com/siril9/presentation-skill/blob/main/docs/PLUGIN_PUBLICATION.md",
    "optional_local_preview": "extensions/preview/README.md"
  },
  "proof_assets": {
    "showcase": "https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_showcase.jpg",
    "showcase_manifest": "https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_studies/release_manifest.json",
    "lab_contact_sheet": "https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_studies/white_calibration_contact_sheet.jpg",
    "dark_contrast_contact_sheet": "https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_studies/dark_contrast_contact_sheet.jpg",
    "light_river_report_contact_sheet": "https://github.com/siril9/presentation-skill/blob/main/examples/v0.14_lab_studies/light_river_report_contact_sheet.jpg",
    "design_studies_zip": "https://github.com/siril9/presentation-skill/releases/download/v0.14.0/presentation-skill-v0.14-lab-studies.zip",
    "white_calibration_pptx": "https://github.com/siril9/presentation-skill/releases/download/v0.14.0/white_calibration.pptx",
    "dark_contrast_pptx": "https://github.com/siril9/presentation-skill/releases/download/v0.14.0/dark_contrast.pptx",
    "light_river_report_pptx": "https://github.com/siril9/presentation-skill/releases/download/v0.14.0/light_river_report.pptx",
    "historical_proof_release": "https://github.com/siril9/presentation-skill/releases/tag/v0.13.1",
    "release_url": "https://github.com/siril9/presentation-skill/releases/tag/v0.14.0",
    "latest_release_url": "https://github.com/siril9/presentation-skill/releases/latest"
  },
  "default_commands": {
    "quick_brief": "python3 scripts/present.py brief --topic \"Deck topic\" --prompt \"Original request\" --profile auto --output quick_deck_agent_brief.json",
    "quick_finalize": "python3 scripts/present.py finalize --outline /absolute/path/outline.json --output /absolute/path/out.pptx --qa-dir /absolute/path/qa",
    "workspace_init": "python3 scripts/present.py init --workspace /absolute/path/decks/my-deck --title \"My Deck Title\" --prompt \"Original request\" --profile auto",
    "workspace_build": "python3 scripts/present.py build --workspace /absolute/path/decks/my-deck",
    "accessible_final_build": "python3 scripts/present.py build --workspace /absolute/path/decks/my-deck"
  },
  "do_not_use_for": [
    "pure text brainstorming with no deck artifact",
    "mutating a generated PPTX when source workspace files exist",
    "shipping a deliverable deck without QA",
    "ordinary chat without local execution tools",
    "claiming synthetic design studies are benchmarks or current cross-generator superiority evidence"
  ],
  "proof_asset_scope": "Repository/release evidence, not bundled npm/plugin runtime assets. Three eight-slide studies, 24 actual slides, with invented synthetic nonclinical data and reproducible source. The release manifest maps slides to source and review evidence. These are not empirical findings or model/generator benchmarks. Previous proof is historical.",
  "installation": {
    "skills_index": "https://www.skills.sh/siril9/presentation-skill/presentation-skill",
    "skills_cli": "npx skills add https://github.com/siril9/presentation-skill --skill presentation-skill",
    "skills_cli_documentation": "https://github.com/vercel-labs/skills",
    "codex_plugin_marketplace": "codex plugin marketplace add siril9/presentation-skill --ref v0.14.0",
    "codex_plugin_next_step": "Open /plugins and install presentation-skill from the repository-provided Presentation Skill marketplace.",
    "setup_documentation": "https://github.com/siril9/presentation-skill#install",
    "support_boundary": "Installer-supported agents are not all tested here. No official/global marketplace curation claim. Local execution tools and runtime dependencies are required."
  },
  "workflow_boundaries": [
    "One capable model, including GPT-6.1, can use the workflow; no required recursive agents, provider, or model-specific orchestration. This is not a model-quality benchmark.",
    "Supported figure, sidebar, and native-method fallbacks are not v2 slot-execution claims.",
    "The optional Slide Review extension is a local pilot, not a globally hosted service or curated marketplace listing.",
    "Source retention checks cover explicitly mapped visible fields, not factual truth or every possible source field.",
    "Inspect actual rendered slides; static QA or a render cache hit is not visual approval.",
    "Keep images and rendered figures distinct from editable native chart/table objects.",
    "SKILL.md frontmatter uses name and description trigger phrases; aliases here are separate discovery metadata, not a frontmatter aliases field."
  ]
}
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