Skip to content
← Tags

#Validators (1)

Docs & Slidesop7418/guizang-ppt-skillFeatured

Guizang PPT Skill: two locked visual systems and three validators as a web-deck engineering spec

Our takeIt turns web slides into a script-verifiable engineering spec: two locked layout systems, three validators, and a repair ladder graded by pixels (1-40 micro-adjust, 40-90 compress spacing, 90-160 split pages, only above 160 may content be deleted), plus a fully local presenter mode with rehearsal timing. The idea worth stealing is the ban on custom hex values - aesthetic correctness is managed as a non-negotiable product constraint rather than left to model discretion. We have not produced a real deck with it, so it is graded as pending reproduction.

A web presentation-deck skill open-sourced by (op7418), AGPL-3.0, primary language HTML, 26,809 stars. It is not a prompt template that writes slide copy for you; it is an engineering specification that makes an agent reliably produce a single-file HTML swipe deck you can present on stage. The README states the provenance on its first screen: the rules were distilled round by round from the author's own offline talks, and every pitfall landed in references/checklist.md. The decisive reason for HTML over PPTX is that HTML and CSS are text an agent can read, edit and verify directly - a script can measure how many px a slide overflows by, and Playwright can render it for a real visual check. Its core asset is two visual systems with mutually incompatible class names and very different constraint strength: Style A (editorial magazine x e-ink, 10 paste-ready layout skeletons, 5 theme presets, Chinese display headlines capped at 5 characters with nowrap) and Style B (Swiss International, 22 named layouts S01-S22 that are locked, body pages may only pick from them and must write data-layout, 4 anchor colours IKB #002FA7 / #FFD500 / #C5E803 / #FF6B35, square corners with no gradient or shadow, large type forced to weight 200). The most counter-intuitive decision is that custom hex values are not allowed: when a user supplies an arbitrary colour the agent should politely refuse and lay out the presets instead, and SKILL.md says protecting the aesthetic matters more than giving freedom. What separates it from ordinary template packs is three validators plus a repair ladder: validate-swiss-deck.mjs statically checks registered layouts, image slots, text inside SVG and headline alignment, and with Playwright measures DOM overflow in px, bottom whitespace, the nav-safe line and title gap; validate-presenter-mode.mjs catches duplicate slide IDs, mismatched notes, a timing plan over 90% of the target and missing controls; check-presenter-runtime-sync.mjs exists solely to catch drift in the presenter runtime copied into both templates. Guessing-based fixes are forbidden: 1-40px overflow gets micro-adjustment only, 40-90px local spacing compression, 90-160px may squeeze a headline or split a page, and only above 160px may you change layout or delete content. A fully local presenter mode ships inside (press P: dual-window sync, structured notes stored by data-slide-id rather than page number, rehearsal timing, laser pointer and circling, black/white screen and audience-screen freeze, with no cloud relay, phone remote or AI coach), and under Codex it offers to generate imagery with GPT-Image 2.0 plus multi-platform covers such as a 21:9 article header or a 3:4 carousel. It states its own bad fits: dense tables, training courseware, multi-editor collaboration, and it cannot export PPTX. We did not install it and produce a real deck, so it is graded as pending reproduction.

Claude CodeCodex
npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill
HTMLop741826.8k
Guizang PPT Skill: two locked visual systems and three validators as a web-deck engineering spec