Gorden PPT Skill
Generate and edit PowerPoint decks from built-in Chinese templates by swapping text only — your one-line request becomes a real, layout-intact .pptx file.
Mandates auto-running `python3 scripts/apply_update.py` on first use each session, pulling and applying remote update files — a self-update mechanism where the user unknowingly fetches and runs code the maintainer can change at any time, a real supply-chain trust concern.
The bundled templates explicitly state personal/research use only, no commercial use, since they're third-party designer work — the license boundary is stated clearly.
- Auto-pulls and runs a remote update script on first use each session — effectively trusting code the maintainer can push at any time; weigh this supply-chain risk yourself
What does this skill do, and when should you use it?
This is an AI-agent skill for building PowerPoint presentations, built on python-pptx. It ships with hand-polished Chinese PPTX templates (17 per the repo description and README; SKILL.md says 21) and lets the agent pick pages, write an edits. of text replacements, and produce a genuine .pptx without touching shape positions, colors, or font sizes. It also supports non-destructive text-only editing of user-supplied .pptx templates, plus fully original minimalist layouts. Built-in safeguards include text-box overflow detection and same-level title font-size consistency checks. Note: personal and research use only — commercial use is strictly forbidden.
Reads templates/INDEX.md plus each template's intro.md and detail. to match and select a template; the user specifies slide selection and text replacements in edits.; scripts/build_pptx.py builds the final .pptx with overflow-detection warnings; scripts/render_slides.py (LibreOffice + pdftoppm) renders each slide to PNG for preview and self-checking; check_update.py and apply_update.py provide incremental git-based auto-updates; build_pptx.py --chart-data updates native PPT chart data; compute_capacity.py computes per-slot capacity fields when adding new templates.
- A professional needs a work report, year-end summary, or quarterly review deck and picks a built-in template, filling in their own content
- A student preparing a thesis proposal defense or book report wants a polished, information-dense final PPTX
- A user has their company's .pptx template and wants the AI to generate a new deck from it without breaking the layout
- A user wants to change only some text in an existing deck, keeping layout, colors, and font sizes untouched
- Someone needs teaching slides or a business proposal and wants to compare template previews before choosing
- A user explicitly asks for a clean original design with no template
What are this skill's strengths and limitations?
- Rich Chinese-scenario template library covering reports, summaries, defenses, proposals, and courseware
- Text-only, layout-preserving editing guarantees output matches the template's visual design
- Built-in overflow detection and same-level title font-size consistency checks reduce layout accidents
- Supports user-supplied templates and native chart data updates; README claims it was tested with DeepSeek, Xiaomi MiMo, Claude, and GPT
- Incremental auto-update mechanism keeps templates current
- Strictly non-commercial; templates come from third-party designers and commercial reuse requires the original authors' permission
- Decorative graphics (progress bars, rings, flow arrows) do not sync when you change percentage text
- Template count is inconsistent between the README (17) and SKILL.md (21), suggesting stale docs
- Depends on the Microsoft YaHei font — Linux users must configure a fontconfig alias; preview rendering requires LibreOffice and poppler
- No LICENSE file (NOASSERTION), so rights are ambiguous
- No automated test suite; output quality depends on the templates and how well the agent follows the rules
How do you install this skill?
The repo documents no automated installer. Per the README, you simply prompt your agent: "Install this Skill: https://github.com/GordenSun/GordenPPTSkill". Dependencies: python-pptx 1.0+; LibreOffice and poppler are additionally needed only for preview rendering. If Microsoft YaHei is missing, configure a fontconfig alias (an XML example is in the README). On first use in a session, the agent should run python3 scripts/apply_update.py to pull incremental updates.
How do you use this skill?
Standard flow: 1) pick a template from templates/INDEX.md (if unspecified, the skill should offer exactly 3 candidates with preview images for you to choose); 2) read the template's intro.md and detail.; 3) write edits. with template_slug, selected_slides, and per-slot text replacements; 4) run python3 scripts/build_pptx.py <template.pptx> edits. out/final.pptx --detail <detail.> (do not use --strict); 5) optionally run python3 scripts/render_slides.py out/final.pptx out/renders --dpi 144 to preview. Example trigger prompt: "Use this Skill to make a 2026 annual review deck." Editing rules include: replace all placeholder text, never truncate with ellipses, keep same-level titles at the same font size, and never modify the user's original template file.