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

scripts/edit_deck.py

View on GitHub
"""Edit an existing .pptx file in place-style (input -> output).

Three subcommands cover the most common edits on decks you didn't generate:

- `replace-text`: find/replace across every shape text frame and run.
- `list-slides`: print a 1-based index + title summary of each slide.
- `delete-slide`: drop a slide (1-based) and its presentation relationship.

These operations use python-pptx only. For XML-level edits python-pptx can't
express, use `unpack_pptx.py` / `pack_pptx.py` instead.
"""

from __future__ import annotations

import argparse
import sys
from pathlib import Path
from typing import Any

from pptx import Presentation


def _resolve_input(path_str: str) -> Path:
    path = Path(path_str).expanduser().resolve()
    if not path.exists():
        print(f"Error: input file not found: {path}", file=sys.stderr)
        raise SystemExit(2)
    if not path.is_file():
        print(f"Error: input is not a file: {path}", file=sys.stderr)
        raise SystemExit(2)
    return path


def _resolve_output(path_str: str) -> Path:
    path = Path(path_str).expanduser().resolve()
    path.parent.mkdir(parents=True, exist_ok=True)
    return path


def _guard_output(output_path: Path, input_path: Path, overwrite: bool) -> None:
    """Refuse clobbering and same-path writes. Raises SystemExit(3) on failure."""
    if output_path.resolve() == input_path.resolve():
        print(
            f"Error: --output resolves to the same path as --input: {output_path}. "
            f"Point --output to a different file.",
            file=sys.stderr,
        )
        raise SystemExit(3)
    if output_path.exists() and not overwrite:
        print(
            f"Error: output exists (use --overwrite to replace): {output_path}",
            file=sys.stderr,
        )
        raise SystemExit(3)


def _title_text(slide: Any) -> str:
    try:
        title_shape = slide.shapes.title
        if title_shape is not None:
            return (title_shape.text or "").strip()
    except Exception:
        pass
    return ""


def _iter_text_frames(shape: Any) -> Any:
    """Yield text frames from a shape.

    Descends into group shapes and table cells. Does NOT visit chart,
    SmartArt, or slide-master text (see references/editing.md).
    """
    # Group shape: recurse into children. Groups can themselves contain
    # tables, so we route through the same dispatcher.
    if getattr(shape, "shape_type", None) is not None and hasattr(shape, "shapes"):
        for child in shape.shapes:
            yield from _iter_text_frames(child)
        return
    # Table: visit every cell's text frame.
    if getattr(shape, "has_table", False):
        table = shape.table
        for row in table.rows:
            for cell in row.cells:
                cell_frame = getattr(cell, "text_frame", None)
                if cell_frame is not None:
                    yield cell_frame
        return
    if getattr(shape, "has_text_frame", False):
        yield shape.text_frame


def _replace_in_runs(text_frame: Any, find: str, replace: str) -> int:
    """Replace occurrences of `find` inside every run of `text_frame`.

    Run-level replacement preserves formatting. Matches that span run
    boundaries will not be caught; this mirrors how most tooling treats
    python-pptx replacements.
    """
    count = 0
    for paragraph in text_frame.paragraphs:
        for run in paragraph.runs:
            if run.text and find in run.text:
                count += run.text.count(find)
                run.text = run.text.replace(find, replace)
    return count


def _cmd_replace_text(args: argparse.Namespace) -> int:
    if args.find == "":
        print("Error: --find must be a non-empty string", file=sys.stderr)
        return 2

    input_path = _resolve_input(args.input)
    output_path = _resolve_output(args.output)
    _guard_output(output_path, input_path, args.overwrite)

    presentation = Presentation(str(input_path))
    total = 0
    for slide in presentation.slides:
        for shape in slide.shapes:
            for text_frame in _iter_text_frames(shape):
                total += _replace_in_runs(text_frame, args.find, args.replace)
        if getattr(slide, "has_notes_slide", False):
            notes_frame = slide.notes_slide.notes_text_frame
            total += _replace_in_runs(notes_frame, args.find, args.replace)

    if total == 0 and args.require_match:
        print(
            f"Error: --require-match set but 0 occurrence(s) of {args.find!r} found; "
            f"output not written.",
            file=sys.stderr,
        )
        return 4

    presentation.save(str(output_path))
    print(f"Replaced {total} occurrence(s) of {args.find!r} -> {args.replace!r}")
    print(f"Wrote {output_path}")
    return 0


def _cmd_list_slides(args: argparse.Namespace) -> int:
    input_path = _resolve_input(args.input)
    presentation = Presentation(str(input_path))
    print(f"File: {input_path}")
    print(f"Slides: {len(presentation.slides)}")
    for idx, slide in enumerate(presentation.slides, start=1):
        title = _title_text(slide) or "(No title)"
        print(f"  {idx:>3}. {title}")
    return 0


def _cmd_delete_slide(args: argparse.Namespace) -> int:
    input_path = _resolve_input(args.input)
    output_path = _resolve_output(args.output)
    _guard_output(output_path, input_path, args.overwrite)

    presentation = Presentation(str(input_path))
    slides = presentation.slides
    total = len(slides)
    index = int(args.index)
    if index < 1 or index > total:
        print(
            f"Error: --index {index} out of range (deck has {total} slide(s))",
            file=sys.stderr,
        )
        return 2

    # python-pptx has no public delete API. We remove the sldId entry from the
    # presentation's sldIdLst and drop the matching relationship. The slide
    # part itself is left in the package; PowerPoint ignores orphaned parts.
    zero_based = index - 1
    slide_id_list = slides._sldIdLst  # type: ignore[attr-defined]
    sld_id_elements = list(slide_id_list)
    target = sld_id_elements[zero_based]
    rId = target.rId
    slide_id_list.remove(target)
    presentation.part.drop_rel(rId)

    presentation.save(str(output_path))
    print(f"Deleted slide {index} of {total}; wrote {output_path}")
    return 0


def _build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(
        description="Edit an existing .pptx deck (text replace, slide list, slide delete).",
    )
    sub = parser.add_subparsers(dest="command", required=True)

    replace = sub.add_parser(
        "replace-text",
        help="Replace text across shapes, table cells, groups, and notes.",
    )
    replace.add_argument("--input", required=True, help="Input .pptx path")
    replace.add_argument("--output", required=True, help="Output .pptx path")
    replace.add_argument("--find", required=True, help="Exact substring to find")
    replace.add_argument("--replace", required=True, help="Replacement substring")
    replace.add_argument(
        "--overwrite",
        action="store_true",
        help="Allow overwriting an existing --output file",
    )
    replace.add_argument(
        "--require-match",
        action="store_true",
        help="Exit non-zero (4) if 0 occurrences are replaced",
    )
    replace.set_defaults(func=_cmd_replace_text)

    listing = sub.add_parser(
        "list-slides",
        help="Print a 1-based index + title for every slide.",
    )
    listing.add_argument("--input", required=True, help="Input .pptx path")
    listing.set_defaults(func=_cmd_list_slides)

    delete = sub.add_parser(
        "delete-slide",
        help="Delete a slide by 1-based index.",
    )
    delete.add_argument("--input", required=True, help="Input .pptx path")
    delete.add_argument("--output", required=True, help="Output .pptx path")
    delete.add_argument(
        "--index",
        required=True,
        type=int,
        help="1-based slide index to delete",
    )
    delete.add_argument(
        "--overwrite",
        action="store_true",
        help="Allow overwriting an existing --output file",
    )
    delete.set_defaults(func=_cmd_delete_slide)

    return parser


def main() -> int:
    parser = _build_parser()
    args = parser.parse_args()
    return int(args.func(args))


if __name__ == "__main__":
    try:
        raise SystemExit(main())
    except SystemExit:
        raise
    except Exception as exc:  # pragma: no cover - CLI error path
        print(f"Error: {exc}", file=sys.stderr)
        raise SystemExit(1)
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: 197kUpdated 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: 197kUpdated 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: 197kUpdated 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: 197kUpdated Claude CodeCodexVerifiedInstall