skill
BLCU-PPT-Template
A skill that generates PPT files or web PPT programs from the BLCU presentation template
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/ChHsiching/BLCU-PPT-Template itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 21, 2026Give your agent a document, some figures, and a prompt like “make this into a
group-meeting report”. The skill plans an outline, confirms it with you,
renders sample pages for approval, then produces the full deck on the BLCU
report template. Slides are cloned from the template itself, so its brand
layer comes through exactly; formulas become editable PowerPoint math; fonts
are subset and embedded so the file renders correctly anywhere. The BLCU
theme ships built-in, and the templates/ layout is ready for more.
Installation
# skills CLI — works with Claude Code, Cursor, Codex, and most agents
npx skills add ChHsiching/BLCU-PPT-Template
# or register as a local plugin directory for Claude Code
git clone https://github.com/ChHsiching/BLCU-PPT-Template.git
claude --plugin-dir BLCU-PPT-Template
Then provide material and a prompt; SKILL.md drives the rest.
Requirements
| Requirement | Used by | If missing |
|---|---|---|
| Python 3.11+ with python-pptx, latex2mathml, matplotlib | all rendering | hard stop |
| playwright + Chromium (optional PIL) | web QA gate | gate notes the skip |
| Node 24 + npm | web output only | pptx-only mode unaffected |
| PowerPoint COM on Windows | screenshot spot checks | downgrades to a note |
Usage
Put your material in any project folder; figure filenames say what the figures show:
my-report/
material/
method-notes.md
images/
lambda-acc.png # filename = what the figure shows
Then tell the agent one line:
The material is in my-report/material/. Make it into a group-meeting deck, about 15 minutes.
Page count, output mode (pptx / web / both), and presenter name are asked one by one at CP1; the full deck renders only after you approve sample pages (CP2).
Deliverables
| File | Contents |
|---|---|
outline.md | page plan and budgets, fixed after CP1 |
deck.json | single source of truth both renderers consume |
out/<name>.pptx | the deck: native OMML formulas, embedded fonts |
out/web/ | Vite + React slideshow (npm run dev) |
演讲稿.md | standalone speaker script |
A complete worked example lives in
examples/qat-lsq-repro/ — regenerate it:
python scripts/render_pptx.py examples/qat-lsq-repro/deck.json \
-o examples/qat-lsq-repro/out/qat-report.pptx
python scripts/scaffold_web.py examples/qat-lsq-repro/deck.json \
-o examples/qat-lsq-repro/out/web --force
Development
python -m pytest tests/
Architecture, environment notes, and QA-gate details are documented in AGENTS.md; the domain glossary is CONTEXT.md.
Issues track history and open work.
License
AGPL-3.0-only · Copyright (c) 2026 ChHsiching — see LICENSE. Fonts under fonts/ keep their own SIL OFL 1.1.
- Use (including internal commercial use), modification, and distribution are free. Distributing it or offering it as a network service requires derivative works to be open-sourced under AGPL-3.0.
- Closed-source commercial use requires a separate commercial license: hsichingchang@gmail.com
Contribution Terms
By submitting a PR, you agree to license your contribution under AGPL-3.0 and grant the maintainer the right to offer separate commercial licenses. Your contribution remains available to everyone under AGPL.