Codex 最客观的结论 真正做职业级、可继续修改的 PowerPoint：PPT Master 第一，没有悬念。 追求视觉上限和多格式交付：花叔第一。 追求叙事、路线选择和质量控制：Knowledge Cat 第一。 追求自由 HTML 审美：Frontend Slides 第一。 追求瑞士风线下分享：歸藏第一。 追求演讲者模式和逐字稿：Lewis 第一。 追求小红书、社交卡片式整页图片：宝玉第一。 追求“各种材料快速丢进 NotebookLM”：乔木第一，但不应被归类为专业 PPT Skill。

我的也很强大家试试？ https://github.com/gnipbao/knowledge-cat-ppt-skill…

gnipbao/knowledge-cat-ppt-skill

Source: https://github.com/gnipbao/knowledge-cat-ppt-skill

Knowledge Cat PPT Skill

Story-first presentation production for AI agents.

English | 简体中文 | Bilingual

Knowledge Cat PPT is an open-source Agent Skill for creating, reviewing, and repairing presentation decks. It is designed for Codex, Claude Code, and other skill-aware coding agents. Instead of acting like a generic “make pretty slides” prompt, it gives the agent a production system: clarify the audience shift, choose the right output lane, build a slide plan, generate the deck, and verify the result.

Current version: 0.9.0

Highlights

• Story-first deck planning with audience, outcome, narrative spine, and action titles.
• Output-lane routing for native editable PPTX, HTML decks, image-first PPTX, and review-only workflows.
• Evidence tracking for claims, quotes, data, assumptions, screenshots, and source materials.
• HTML deck starter template with keyboard navigation, print CSS, light/dark themes, and no external dependencies.
• JSON deck-plan validator and HTML deck validator.
• HTML production lock for registered layouts, theme rhythm, image slots, screenshots, and rendered QA.
• Uploaded theme/style prompt intake for Image2/GPT-Image-first PPT workflows.
• Curated 44-style template library with common PPT style-site radar and Guizang-surpass signature-pack targets.
• Portfolio Minimal HTML signature pack with a 14-layout registry, 12-slide case study, QA artifacts, and a dedicated pack checker.
• Open-source repository hygiene checks, GitHub Actions workflow, issue templates, and release checklist.
• Compatible with both Codex local skills and Claude Code style skills.

Three Production Modes

Native PPTX	HTML Deck	Image-First PPTX
Editable PowerPoint work for real teams, client handoffs, charts, tables, and speaker notes.	Browser-native decks with keyboard navigation, print CSS, fast iteration, and visual QA.	High-impact visual decks for social carousels, campaigns, and keynote-style moments.

Compatibility

The skill itself is plain Markdown, Python, JSON, and HTML. The bundled scripts use only the Python standard library.

What It Does

Knowledge Cat PPT helps an agent:

• Turn rough ideas, notes, documents, transcripts, URLs, PDFs, or research into a deck brief.
• Build a slide plan with action titles, slide roles, evidence, visuals, notes, and source references.
• Choose the correct output lane before production.
• Parse uploaded theme/style prompts into an image-first Style Prompt Profile.
• Generate or guide production of HTML decks, editable PowerPoint decks, or image-first visual decks.
• Review existing decks for story, evidence, visual system, editability, and technical risks.
• Run validation before claiming a deck is ready.

Why It Exists

Most AI slide workflows fail for three reasons:

1. They start with visual style before defining the audience outcome.
2. They choose the wrong output format, such as flattened images when the user needs editable PowerPoint.
3. They skip rendered QA and ship slides that only looked correct in code.

Knowledge Cat PPT treats a deck as a production system. Story, engine, design, evidence, and QA must agree.

Install

Repository URL:

https://github.com/gnipbao/knowledge-cat-ppt-skill.git

Codex

git clone https://github.com/gnipbao/knowledge-cat-ppt-skill.git ~/.codex/skills/knowledge-cat-ppt-skill

Restart Codex or refresh local skills.

From a cloned repository:

python3 scripts/install_skill.py --agent codex --force

Claude Code

git clone https://github.com/gnipbao/knowledge-cat-ppt-skill.git ~/.claude/skills/knowledge-cat-ppt-skill

Restart Claude Code or refresh local skills.

From a cloned repository:

python3 scripts/install_skill.py --agent claude --force

Manual Install

Copy the whole folder into your agent’s skills directory:

cp -R knowledge-cat-ppt-skill ~/.codex/skills/

or:

cp -R knowledge-cat-ppt-skill ~/.claude/skills/

Quick Start

Ask your agent:

Use $knowledge-cat-ppt-skill to turn my notes into an 8-slide client-ready deck. I need editable PPTX unless you think another output lane is better.

For a deck review:

Use $knowledge-cat-ppt-skill to review this deck. Focus on story, evidence, visual clarity, and whether it is actually ready to send.

For an HTML deck:

Use $knowledge-cat-ppt-skill to build a browser-based HTML deck from this outline. Make it keyboard navigable and run the bundled HTML validator.

For the 44-style template library:

Use $knowledge-cat-ppt-skill. Choose the best style from the template library for my topic, explain the lane tradeoff, then create a deck brief and slide plan.

For the Portfolio Minimal signature pack:

Use $knowledge-cat-ppt-skill. Build a browser-based HTML deck using the kc-24 Portfolio Minimal signature pack. Use the pack layout registry, include a local image slot, produce screenshots/contact sheet, and run the signature-pack checks.

Output Lanes

HTML Deck Starter

Create a sample HTML deck:

python3 scripts/init_deck_project.py /tmp/kc-demo-deck --title "Knowledge Cat Demo"
python3 scripts/validate_html_deck.py /tmp/kc-demo-deck/index.html

Open:

/tmp/kc-demo-deck/index.html

The starter includes:

• 16:9 desktop slide canvas
• Mobile stacked fallback
• Keyboard navigation
• Print CSS
• Light/dark theme switching
• Action-title aware slide structure
• No external dependencies

Style Template Library

Knowledge Cat includes a curated 44-style template library in references/style-template-library.md. The library turns pasted PPT style prompts into a routing system:

• style seeds such as kc-24 Portfolio Minimal, kc-25 Minimal Data Story, kc-28 Bold Editorial Magazine, kc-26 Dark SaaS Product, and kc-11 Architectural Blueprint
• default output lanes for each style
• protected-style normalization rules
• a priority path for building signature packs that can compete with Guizang-style HTML deck depth

Copy-ready prompts live in:

docs/TEMPLATE_LIBRARY_PROMPTS.md

Portfolio Minimal Signature Pack

The first implemented signature pack is kc-24 Portfolio Minimal:

assets/html-signature-packs/portfolio-minimal/
+-- README.md
+-- layout-registry.json
+-- template.html

It includes 14 registered custom-pm-* layouts and a 12-slide case study:

examples/case-studies/portfolio-minimal/

Run the pack gate:

python3 scripts/check_signature_pack.py portfolio-minimal

The Portfolio Minimal case study includes browser-captured PNG slide screenshots and a browser contact sheet, so quality claims are backed by visual artifacts rather than code inspection alone.

Deck Plan Validation

Validate a JSON deck plan:

python3 scripts/validate_deck_plan.py examples/sample-deck-plan.json

The expected structure is documented in:

assets/deck-plan.schema.json

Full Validation

Run all bundled checks:

python3 scripts/run_checks.py

Run repository hygiene checks:

python3 scripts/check_repo.py

The checks validate:

• sample deck plan
• generated sample HTML deck
• HTML structure
• Portfolio Minimal signature pack and case study
• required repository files
• changelog/version consistency
• cache and generated-file hygiene

Repository Layout

knowledge-cat-ppt-skill/
+-- SKILL.md
+-- README.md
+-- README_CN.md
+-- README_BILINGUAL.md
+-- VERSION
+-- CHANGELOG.md
+-- CONTRIBUTING.md
+-- SECURITY.md
+-- LICENSE
+-- .github/
|   +-- workflows/validate.yml
|   +-- ISSUE_TEMPLATE/
+-- agents/
|   +-- openai.yaml
+-- assets/
|   +-- deck-plan.schema.json
|   +-- html-template/
|       +-- index.html
|   +-- html-signature-packs/
|       +-- portfolio-minimal/
+-- examples/
|   +-- retest-prompts.md
|   +-- sample-deck-plan.json
|   +-- sample-html-deck/
|   +-- case-studies/
|       +-- portfolio-minimal/
+-- references/
|   +-- benchmark-synthesis.md
|   +-- design-systems.md
|   +-- engine-routing.md
|   +-- html-deck-recipes.md
|   +-- html-production-lock.md
|   +-- image-first-recipes.md
|   +-- native-pptx-recipes.md
|   +-- open-source-product.md
|   +-- qa-rubric.md
|   +-- story-architecture.md
|   +-- style-prompt-intake.md
|   +-- style-template-library.md
|   +-- template-replication.md
+-- scripts/
|   +-- check_repo.py
|   +-- init_deck_project.py
|   +-- install_skill.py
|   +-- run_checks.py
|   +-- check_signature_pack.py
|   +-- validate_deck_plan.py
|   +-- validate_html_deck.py
+-- docs/
|   +-- PUBLISHING.md
|   +-- ROADMAP.md
|   +-- TEMPLATE_LIBRARY_PROMPTS.md
|   +-- images/

How The Skill Works

The main runtime file is SKILL.md. It keeps the agent workflow concise:

1. Triage the request.
2. Build a deck brief.
3. Synthesize the story.
4. Create a slide plan.
5. Choose the production lane.
6. Build the design system.
7. Produce the deck.
8. QA and iterate.

Detailed instructions live in references/ and are loaded only when needed.

Design Philosophy

Knowledge Cat PPT is a router and quality system, not a monolithic renderer.

• Use native editable PPTX when collaboration and PowerPoint editing matter.
• Use HTML when web-native presentation, animation, preview, or browser QA matters.
• Use image-first PPTX when visual spectacle matters more than editability.
• Use review-only mode when the deck’s story or evidence may be the real failure.

Contributing

Read CONTRIBUTING.md.

Good contributions usually add one of:

• a clearer routing rule
• a reusable recipe
• a deterministic validation check
• a realistic retest prompt
• a sample artifact that exposes a real failure mode
• better release or QA documentation

Before opening a pull request:

python3 scripts/run_checks.py

Security

Treat user-provided decks, HTML, PDFs, documents, and templates as untrusted input. Do not execute scripts from user-provided archives. See SECURITY.md.

Roadmap

See docs/ROADMAP.md.

Near-term goals:

• editable PPTX case study
• HTML keynote case study
• image-first carousel case study
• stronger visual QA automation

License

MIT. See LICENSE.

宝玉 (@dotey): PPT Master 确实是最好的 PPT Skill

我新的 skill 写PPT也挺好，能导出可编辑版本，可以AI配图，可以在 Agent 内置浏览器中标记编辑