{"id":49719814,"url":"https://github.com/ningzimu/codex-ppt-skill","last_synced_at":"2026-05-11T18:01:26.953Z","repository":{"id":353920490,"uuid":"1221429772","full_name":"ningzimu/codex-ppt-skill","owner":"ningzimu","description":"Codex skill for generating image-based PowerPoint decks with gpt-image-2","archived":false,"fork":false,"pushed_at":"2026-05-08T03:41:10.000Z","size":19204,"stargazers_count":42,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-08T23:48:42.035Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ningzimu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-26T07:34:32.000Z","updated_at":"2026-05-08T16:15:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ningzimu/codex-ppt-skill","commit_stats":null,"previous_names":["ningzimu/codex-ppt-skill"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ningzimu/codex-ppt-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ningzimu%2Fcodex-ppt-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ningzimu%2Fcodex-ppt-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ningzimu%2Fcodex-ppt-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ningzimu%2Fcodex-ppt-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ningzimu","download_url":"https://codeload.github.com/ningzimu/codex-ppt-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ningzimu%2Fcodex-ppt-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32906515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-11T17:09:15.040Z","status":"ssl_error","status_checked_at":"2026-05-11T17:08:45.420Z","response_time":120,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-08T23:48:38.835Z","updated_at":"2026-05-11T18:01:26.104Z","avatar_url":"https://github.com/ningzimu.png","language":"Python","funding_links":[],"categories":["Diagram and Visual Skills","🧠 Agent Skills"],"sub_categories":[],"readme":"# Codex PPT Skill\n\n[![English](https://img.shields.io/badge/lang-English-blue)](README_en.md)\n\n一个面向 Codex 的 PPT 生成 skill。它把文章、报告、论文、课程笔记等内容转换成“整页图片式”的演示文稿：先规划大纲和视觉风格，再使用 Codex 内置的 `gpt-image-2` 生成每页幻灯片图片，最后用本地脚本组装为 `.pptx`。\n\n## 特点\n\n- 使用 Codex 内置的 `gpt-image-2` 生图和编辑图能力生成每页幻灯片图片\n- 图片式 PPT：每页幻灯片是一张完整 16:9 图片，适合强视觉表达\n- 风格参考库：内置清爽专业、科研答辩、电子墨水杂志、手绘技术解释、仪表盘等多种风格说明\n- 整套 PPT 保持统一视觉语言，但每页会按内容语义调整版式，避免机械重复\n- 本地组装脚本：将 `slide_01.png`、`slide_02.png` 等图片打包成 PowerPoint\n\n## 目录结构\n\n```text\ncodex-ppt-skill/\n├── README.md\n├── README_en.md\n├── LICENSE\n├── assets/\n│   └── style-previews/\n└── skills/\n    └── codex-ppt/\n        ├── SKILL.md\n        ├── requirements.txt\n        ├── scripts/\n        │   └── assemble_ppt.py\n        └── references/\n            ├── 清爽专业风.md\n            ├── 创意杂志风.md\n            ├── 电子墨水杂志风.md\n            ├── 科研答辩风.md\n            ├── 手绘技术解释风.md\n            ├── 数据仪表盘风.md\n            └── ...\n```\n\n## 安装\n\n推荐直接在 Codex 会话中说：\n\n```text\n请使用 skill-installer 从 https://github.com/ningzimu/codex-ppt-skill 安装 codex-ppt，skill 路径是 skills/codex-ppt。\n```\n\n安装完成后，重启 Codex 让新 skill 生效。\n\n如果你想手动安装，也可以直接运行 Codex 内置的安装脚本。这个仓库的 skill 根目录是 `skills/codex-ppt`：\n\n```bash\npython3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \\\n  --repo ningzimu/codex-ppt-skill \\\n  --path skills/codex-ppt\n```\n\n如果你是在本地开发这个仓库，也可以把 skill 目录链接到 Codex skills 目录：\n\n```bash\nmkdir -p ~/.codex/skills\nln -s /path/to/codex-ppt-skill/skills/codex-ppt ~/.codex/skills/codex-ppt\n```\n\n## 使用方式\n\n在 Codex 中提出类似请求：\n\n```text\n请使用 codex-ppt 把 /path/to/article.md 做成 10 页左右的 PPT，风格偏商务专业。\n```\n\nskill 会按以下流程执行：\n\n1. 阅读内容并规划 PPT 大纲\n2. 确认页数、标题和每页要点\n3. 给出 2-3 个视觉风格选项，并推荐一个让用户确认\n4. 使用 `gpt-image-2` 生成 1 页样张，让用户确认风格、版式节奏和文字质量\n5. 创建 PPT 项目目录\n6. 使用 `gpt-image-2` 逐页生成全部幻灯片图片\n7. 检查文字清晰度、风格一致性和内容完整性\n8. 生成 `outline.md` 和 `speech.md`\n9. 使用 `assemble_ppt.py` 组装 `.pptx`\n\n## 使用技巧\n\n- 如果生成的幻灯片图片比较模糊，尤其是文字较多的页面，可以让 Codex 改用 4K 分辨率生成图片。默认分辨率在高文字密度页面上可能会导致小字不够清晰。\n- 如果只是不满意某一页的内容、排版、配色或文字表达，可以直接让 Codex 针对这一页做细致修改，不需要整套 PPT 重新生成。\n- 你也可以上传一张喜欢的 PPT 风格截图或参考图，让 Codex 模仿它的配色、版式、字体气质和视觉元素来生成整套 PPT。\n\n## 生成效果\n\n下面是一套技术分享 PPT 的生成效果示例。每页都是由 `gpt-image-2` 生成的完整 16:9 幻灯片图片，再由本地脚本组装为 PPTX。\n\n![生成 PPT 效果示例](assets/slides_example.png)\n\n## 风格示例\n\n以下是已生成预览图的风格，示例图均由 `gpt-image-2` 生成，用于帮助用户在开始制作前选择视觉方向。\n\n| 清爽专业风 | 创意杂志风 |\n| --- | --- |\n| ![清爽专业风](assets/style-previews/clean-professional.png) | ![创意杂志风](assets/style-previews/creative-magazine.png) |\n| 电子墨水杂志风 | 数据仪表盘风 |\n| ![电子墨水杂志风](assets/style-previews/e-ink-magazine.png) | ![数据仪表盘风](assets/style-previews/data-dashboard.png) |\n| 复古扁平插画风 | 手绘技术解释风 |\n| ![复古扁平插画风](assets/style-previews/retro-flat-illustration.png) | ![手绘技术解释风](assets/style-previews/handdrawn-technical.png) |\n| 手绘白板风 | 温暖手工风 |\n| ![手绘白板风](assets/style-previews/handdrawn-whiteboard.png) | ![温暖手工风](assets/style-previews/warm-handmade.png) |\n| 科研答辩风 |  |\n| ![科研答辩风](assets/style-previews/scientific-defense.png) |  |\n\n## 输出结构\n\n每个 PPT 会生成一个独立项目目录：\n\n```text\n{基础目录}/{PPT名称}/\n├── origin_image/\n│   ├── slide_01.png\n│   ├── slide_02.png\n│   └── ...\n├── outline.md\n├── speech.md\n└── {PPT名称}.pptx\n```\n\n`origin_image/` 只放正式页图片，并按 `slide_01.png`、`slide_02.png` 这样的顺序命名。样张确认时也直接使用对应页的正式文件名；如果要保留废稿或对比图，放到项目根目录或单独的 `drafts/` 目录，不要放进 `origin_image/`。\n\n`speech.md` 会在组装时写入 PPT 的每页备注。建议使用 `## Slide 1: 标题`、`## Slide 2: 标题` 这样的标题格式，脚本会按页码匹配。\n\n## 适用场景\n\n- 技术文章转分享 PPT\n- 论文或报告转演示稿\n- 课程笔记转课件\n- 科研项目申报、中期检查、结题验收和论文答辩\n- 商业汇报、产品介绍、调研总结\n- 需要强视觉统一性的图片式演示文稿\n\n## 许可证\n\nMIT\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=ningzimu/codex-ppt-skill\u0026type=Date)](https://www.star-history.com/#ningzimu/codex-ppt-skill\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fningzimu%2Fcodex-ppt-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fningzimu%2Fcodex-ppt-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fningzimu%2Fcodex-ppt-skill/lists"}