Skip to content

ningzimu/codex-ppt-skill / skills/codex-ppt

codex-ppt

Verified

Generate visually unified image-based PPT/PPTX decks from articles, reports, papers, notes, or outlines.

FileKindSize
.clawhubignoreother162 B
SKILL.mdskill md10.1 KB
docs/backend-selection.mdmarkdown3.5 KB
docs/cli-api-fallback.mdmarkdown5.4 KB
docs/image-model-configuration.mdmarkdown3.5 KB
docs/outline-style-and-sample.mdmarkdown9.3 KB
docs/project-assembly-and-reporting.mdmarkdown8.3 KB
docs/slide-generation-and-subagents.mdmarkdown14.5 KB
docs/style-library.mdmarkdown6.4 KB
docs/user-supplied-assets.mdmarkdown3.0 KB
docs/workflow-gates-and-progress.mdmarkdown2.5 KB
prompts/slide-worker.mdmarkdown2.6 KB
references/党政红风格.mdmarkdown8.5 KB
references/创意杂志风.mdmarkdown3.3 KB
references/复古扁平插画风.mdmarkdown3.3 KB
references/手绘技术解释风.mdmarkdown4.7 KB
references/手绘白板风.mdmarkdown3.3 KB
references/教学课件风.mdmarkdown9.7 KB
references/数据仪表盘风.mdmarkdown3.4 KB
references/清爽专业风.mdmarkdown4.4 KB
references/温暖手工风.mdmarkdown3.3 KB
references/电子墨水杂志风.mdmarkdown4.6 KB
references/科研答辩风.mdmarkdown9.1 KB
references/麦肯锡风格.mdmarkdown14.8 KB
requirements.txtmanifest65 B
scripts/assemble_ppt.pyscript14.5 KB
scripts/codex_ppt_runtime.pyscript8.5 KB
scripts/image_gen.pyscript34.1 KB
scripts/image_providers/__init__.pyscript188 B
scripts/image_providers/atlascloud.pyscript8.1 KB
scripts/image_providers/base.pyscript887 B
scripts/image_providers/factory.pyscript734 B
scripts/image_providers/openai_compatible.pyscript7.3 KB
scripts/prepare_slide_prompts.pyexecutablescript19.8 KB
scripts/record_slide_blocker.pyscript1.4 KB
scripts/record_slide_dispatch.pyscript2.3 KB
scripts/record_slide_result.pyscript6.6 KB
scripts/remove_chroma_key.pyscript13.8 KB
scripts/slide_job_status.pyscript2.3 KB
scripts/slide_run_state.pyscript6.4 KB

docs/backend-selection.md

View on GitHub
# Backend Selection

Read this before confirming the image backend or generating the first sample slide.

This skill supports two image backends:

1. Built-in image tool, preferred when available. Example tool names: Codex `image_gen`; OpenClaw `image_generate`.
2. Local API/CLI fallback, using `scripts/image_gen.py`.

## Decision Rules

- Before recommending CLI/API fallback, actively check whether the built-in image generation tool is callable in the current environment. Do not infer availability only from the agent name or subscription context.
- Prefer the built-in image tool when available. In Codex, this usually means the built-in `image_gen` tool. In OpenClaw, this may be `image_generate`. Resolution, quality, aspect ratio, or slide-edit requests alone do not require CLI/API fallback. Check which parameters the current tool actually exposes.
- Do not identify the built-in tool as a specific GPT Image model unless the environment provides evidence. If exact model, size, or quality selection is required but the tool does not expose it, explain the limitation and select a compatible API/CLI fallback with the user. Successful image generation alone does not verify the actual model or requested parameters.
- Use CLI/API fallback only when the built-in tool is unavailable, the built-in tool failed for a required capability, the user explicitly asks for API/CLI or a third-party image API/provider adapter, or the requested capability is unavailable in the built-in tool.
- Do not recommend CLI/API fallback merely because it provides direct `--out` file paths, easier local file management, local config reuse, batch generation convenience, or simpler automation.
- Before generating the first image, tell the user which tool availability you checked, which backend you plan to use, why fallback is or is not needed, and ask for confirmation. Do not treat being in a specific agent environment as proof that the built-in image tool is available.
- CLI/API fallback loads `~/.codex-ppt-skill/.env` automatically. Run the CLI normally; do not manually parse `.env` or ask for configuration before an error.
- Ask for `OPENAI_API_KEY` configuration only after you have intentionally selected CLI/API fallback and that fallback reports missing config, after authentication/base URL/model errors, or when the user explicitly wants to change API settings. Do not mention missing `OPENAI_API_KEY` while the Codex built-in image tool is available. Configure provided values with `scripts/codex_ppt_runtime.py config --api-key`.

If CLI/API fallback is selected, read `cli-api-fallback.md` before generating images. For API key, base URL, model, and `.env` configuration, read `image-model-configuration.md` only after the fallback CLI reports missing or invalid configuration, or when the user explicitly wants to change those settings.

## Confirmation Text

Built-in backend:

```text
我检查到当前环境可调用内置图片生成工具(Codex 通常是 image_gen,OpenClaw 通常是 image_generate),因此准备优先用内置工具生成样张,不切到本地 API/CLI fallback。可以开始生成 1 页样张吗?
```

CLI/API fallback:

```text
我检查后没有可用的内置图片生成工具,或内置工具缺少本页必需能力,因此准备使用本地 API/CLI fallback 生成样张,读取 ~/.codex-ppt-skill/.env 中的 OPENAI_BASE_URL / CODEX_PPT_IMAGE_MODEL 配置。可以开始生成 1 页样张吗?
```

Wait for confirmation before generating the sample slide. If the user questions the backend, resolve that before continuing.
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: 195kUpdated 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: 195kUpdated 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: 195kUpdated 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: 195kUpdated Claude CodeCodexVerifiedInstall