Agent skill

Planners Ppt Hell

by thePlannerIvan in thePlannerIvan/planners-ppt-hell

把材料或上游交来的画面契约做成有证据、可读的画面。两个出口:可编辑 PPT(优先从逐页内容稿出发 —— 通常由 planners-bypage 产出;收到非 PPT 资料包或需要完整内容理解时,先调用 planners-bypage;仅在简单单源材料且不需要内容展开时提供轻量切片降级。主 Agent 自主设计 SVG、看图修订、可选整套人工审阅,导出质量由转换器保证),以及视频静态画面(从…

AGPL-3.0Auto-check passedDocuments & Office

Install Planners Ppt Hell

skills CLI
$ npx skills add thePlannerIvan/planners-ppt-hell --skill planners-ppt-hell -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thePlannerIvan/planners-ppt-hell planners-ppt-hell --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
planners-ppt-hell
GitHub stars
234
Token cost
~1.6k tokens
SKILL.md length
286 words
Files
391 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
AGPL-3.0

At a glance

把材料或上游交来的画面契约做成有证据、可读的画面。两个出口:可编辑 PPT(优先从逐页内容稿出发 —— 通常由 planners-bypage 产出;收到非 PPT 资料包或需要完整内容理解时,先调用 planners-bypage;仅在简单单源材料且不需要内容展开时提供轻量切片降级。主 Agent 自主设计 SVG、看图修订、可选整套人工审阅,导出质量由转换器保证),以及视频静态画面(从…

  • Tasks that involve PowerPoint presentations
  • SKILL.md covers 两条路线:只走一条,走完它的完成标准, 开始, 阶段 and 怎么验证, plus 2 more sections
  • Calls python
  • Tasks that involve Video scripts and shorts

What it does

Planners Ppt Hell is an agent skill from thePlannerIvan/planners-ppt-hell. 把材料或上游交来的画面契约做成有证据、可读的画面。两个出口:可编辑 PPT(优先从逐页内容稿出发 —— 通常由 planners-bypage 产出;收到非 PPT 资料包或需要完整内容理解时,先调用 planners-bypage;仅在简单单源材料且不需要内容展开时提供轻量切片降级。主 Agent 自主设计 SVG、看图修订、可选整套人工审阅,导出质量由转换器保证),以及视频静态画面(从 video-idea-system 交来的 visual-plan.json + assets 出发,挑一个视觉风格、逐屏出可被动画指名的 SVG,录制前交付)。也用于指定品牌模板复用、按需提取模板与已有项目返修。

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 396 other files, including scripts, reference files and assets (for example `CHANGELOG.md`, `COMMERCIAL.md` and `GOTCHAS.md`).

It sits in Documents & Office, covering PowerPoint presentations and Video scripts and shorts. It works with Microsoft PowerPoint. The repository describes itself as: A PPT Skill for Planners. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve PowerPoint presentations
  • Tasks that involve Video scripts and shorts

Example prompts

  • “/planners-ppt-hell”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit fd9d142. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Planners Ppt Hell loads about 1.6k tokens when it runs, and up to ~61k if it reads all its reference files. Until then it costs about 84 tokens; SKILL.md has 286 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~61k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from thePlannerIvan/planners-ppt-hell at commit fd9d142, republished under its AGPL-3.0 licence (© thePlannerIvan). 286 words, ~1,627 tokens.

Download SKILL.mdSave it as .claude/skills/planners-ppt-hell/SKILL.md (or your agent's skills folder). This skill also uses 390 other files; get the full folder from GitHub.
name
planners-ppt-hell
description
把材料或上游交来的画面契约做成有证据、可读的画面。两个出口:可编辑 PPT(优先从**逐页内容稿**出发 —— 通常由 `planners-bypage` 产出;收到非 PPT 资料包或需要完整内容理解时,先调用 `planners-bypage`;仅在简单单源材料且不需要内容展开时提供**轻量切片降级**。主 Agent 自主设计 SVG、看图修订、可选整套人工审阅,导出质量由转换器保证),以及视频静态画面(从 video-idea-system 交来的 visual-plan.json + assets 出发,挑一个视觉风格、逐屏出可被动画指名的 SVG,录制前交付)。也用于指定品牌模板复用、按需提取模板与已有项目返修。

Planner's PPT Hell

来源识别:由阿祖不看 TVC 创建与维护。小红书同名账号,https://demyth.info,Lawyif@163.com。来源信息保留在 Skill 和审阅界面,不加入客户 PPT、SVG 或 PNG。

把材料变成有证据、可读的画面。先整理内容,再让实际画面帮助修正表达与布局。

两条路线:只走一条,走完它的完成标准

幻灯片路线视频画面路线
什么时候走要做一份可编辑 PPT上游 video-idea-system 交了画面契约,要做录制前的静态画面
入口init_svg_project.py --source <doc>init_svg_project.py --assets <包>/assets --plan <visual-plan.json>
内容从哪来上游的逐页内容稿(planners-bypage)/非 PPT 资料先交给 planners-bypage/本路线的轻量切片降级上游契约适配而来;本路线不做内容判断
视觉身份模板库/视觉参考/自主设计风格库(video-craft/visual/themes/,旗舰四域风格见 references/domain/video_style_editorial_archive.md;从参考画板提炼新视频风格见 references/workflow/08_video_style_extraction_sop.md)或自主设计
出口final_deck.pptx全部 _internal/02_svg_source/<page_key>.svg,且可能被强调的元素都带稳定 id 与预埋 data-step / data-anim 子元素钩子(不导出 PPT)
完成导出并复核过 PPTX画面全部做完,且作者看过——这条路上审阅是门,不是可选项
额外要读references/domain/svg_to_ppt_rules.mdreferences/domain/video_style_editorial_archive.md(选用 editorial-archive 时)

两条路线共享:画布几何(scripts/canvas_frame.py)、校验器(scripts/validate_svg_layout.py)、渲染与看图、references/domain/svg_rules.md、设计判断框架(style_system.md、layout_taxonomy.md)、版本绑定与恢复。

「模板库」与「风格库」是两件事:模板库(template_library.py)装的是从 PPTX 提出来的、带锁层的品牌模板,给幻灯片路线用;风格库装的是配色与字型 token,给视频画面用。不要拿其中一个去顶另一个。

text
材料 或 画面契约 → 内容(底稿 / 适配)→ 主 Agent 制作 SVG ↔ 渲染看图修订
                                              ↓
                                    整套人工审阅 ↔ 修订
                                              ↓
                              PPTX 导出与复核   /   交出 SVG(带 id)给动画层

为什么视频这边交 SVG 而不是 PNG:后面还要按实测音频做轻动画。所以交出去的不是几张图,是一个能被按元素指名的活结构——给可能被强调的元素铸稳定 id,剪辑那侧就能按 id 指名(03_video_route.md 有完整交接)。

开始

读 references/workflow/00_pipeline_controller.md,用其中的初始化或恢复命令,并按它做开局的一次性确认(幻灯片路线确认视觉来源与画幅;视频画面路线确认风格与画幅)。

阶段

两条路线共用第一件与制作那一件;之后的步序不同,所以分开列。只写到「一眼能不能看出没做完」——每一步完整的完成标准在它自己的文档里。

共用

#这一步做什么主要产物做完的标志完整任务
0开局与恢复:立项目或恢复已有项目,一次性确认(视觉来源或风格、画幅、图片)项目目录、_internal/00_project/page_manifest.json(含路线)源文或契约可读、图片逐张有归属(用到,或写明为什么不用)、视觉来源与画幅已确认(不静默默认)00_pipeline_controller.md
制作制作与逐页自检:画一页 → 渲染 → 看大图 → 修每页 _internal/02_svg_source/<page_key>.svg、_internal/03_png_preview/pages/<page_key>.png、_internal/04_validation/<page_key>.json每页 check 无 error;看过当前这一版 PNG 大图并留下 inspect 记录(位置 + 看过有没有缺陷)04_svg_stage.md

幻灯片路线(出口是可编辑 PPT)

#这一步做什么主要产物做完的标志完整任务
1确认视觉来源:自主设计/模板库/视觉参考/新建品牌模板,四选一选定来源;用模板时项目内的 fidelity 包;参考路线渲染出的参考页视觉身份已确认;要真实复用品牌资产时是复用而不是近似重画01_template_intake.md
2内容底稿:直接沿用已批准逐页稿;收到非 PPT 资料包、多源材料或含待核数字时调 $planners-bypage;仅在简单单源材料且不需要完整内容展开时走轻量切片降级_internal/01_content/page_content.json(含每页 mode)底稿覆盖论证与资产、每页读法已声明,next 进 CREATE02_content_stage.md
3整套审阅(可选步骤)02_visual_review.html、_internal/05_review/review-surface.json(宿主契约)、_internal/05_review/feedback.json作者在真实页面上提交过整套决定,或明确表示当前这版不用审(导出会提醒一次)07_visual_review.md
4导出与复核final_deck.pptx、_internal/00_project/export.json、PPTX 渲染出来的逐页复核图页数与页面版本对得上,且导出的 PPTX 逐页看过(export-inspect 之后才到 COMPLETE)07_visual_review.md

视频画面路线(出口是全部 SVG,不导出 PPT)

#这一步做什么主要产物做完的标志完整任务
V1接手:把包立成账本,把视觉身份定下来适配来的 page_content.json、_internal/01_content/design_direction.md、登记好的图片账本每屏要么有上屏文字、要么有登记图片;四条视频约束四条都写了;assets/ 里每张图有归属03_video_route.md
V2逐屏画:边画边真的看每页 SVG(可能被强调的元素带全片唯一的 id)与 PNG、inspect 记录每页 check 无 error(含文字出画布);看的是每页 PNG 大图;inspect 记了位置与「看过有没有缺陷」03_video_route.md(额外三条)+ 上面「制作」那一行
V3整套:并排看一遍,然后交给作者整套 contact sheet 的结论、审阅记录、全部 _internal/02_svg_source/<page_key>.svg全部页面 check 无 error;作者提交过整套审阅(记录覆盖当前页面版本)——这条路上审阅是门03_video_route.md + 07_visual_review.md

默认由主 Agent 制作和跨页检查。约每 3 页渲染一次是可调整的工作节奏,不是页数上限或任务边界。用户要求样页或委派时再采用对应执行方式。

怎么验证

  • 自动回归:在 Skill 根跑 python -m unittest discover -s scripts/test -p 'test_*.py'。它钉的是本 Skill 自己的判据,不是规格来源。
  • 人工/新会话的行为用例:evals/evals.json——十条 prompt 与它们的 must_do/must_not_do(幻灯片出口五条、视频画面路线五条),用来在干净会话里看这个 Skill 会不会被绕过去。它的状态是「人工在新会话里跑」(文件里写着 not_run_user_will_test_elsewhere),不在自动测试里,也没有任何东西自动执行它。

责任边界

  • 模型负责内容、构图、裁剪、视觉与取舍;可以在制作中调整这些决定,同时更新内容底稿中的必要说明。
  • 源事实、数字、来源、限定条件和用户明确批准的要求必须保留。需要改变结论或承诺时先向用户说明。
  • 设计判断归模型。 脚本不评价密度、字号档位、构件选择、留白或配色——那些规则会把每套页面推向同一种稀疏均匀的样子。脚本只拦在任何风格下都是缺陷的东西(文字压文字、元素出画布、空页、图片被拉伸);幻灯片出口另外拦「转成 PPT 会坏」的那一组(svg_to_ppt_rules.md)。其余靠渲染后看图。
  • 看图是必填动作,而且必须由能看图的模型执行。 执行 inspect 的模型要能读图;当前模型看不了就把它派给能看的模型。这条不是形式要求——「这一屏第一眼落在哪」是这条记录唯一能被证伪的地方。看的是每页 PNG 大图,不是联系表里的缩略格。
  • 脚本负责资产登记、文件索引、渲染、技术校验、版本绑定、保存恢复和转换;模型不手写审批、hash、manifest 或完成状态。
  • 图片是设计的一部分,不只是输入。看完材料先判断这套页面是否需要配图,需要就一次性说明要什么、哪几页、用户是否已有资产;仍无图时在底稿写明原因,不用装饰图形冒充证据。源图逐张看过并说明用途;上屏图片保留比例,证据图确保关键信息可读。
  • SVG 是可编辑页面源;PNG 用来检查。视频出口的 SVG 还要能被动画按元素指名:可能被强调的元素带稳定 id,且 id 在全片唯一(把 page_key 放进名字里——各屏会被内联进同一个 DOM,重复的 id 会让「按 id 指名」只命中第一屏)。
  • 本 Skill 有两个审阅面,它们是两个主体:页面审阅(单位 page_key,02_visual_review.html)与模板审阅(单位 layout_id,00_template_review.html;决定词表是 pass/discard/revise,粒度整批,不声明上传能力)。两面各写各的 surface、各写各的反馈文件,不要合并。
  • 人审围绕真实页面进行。跑 review / template-review 前先看宿主有没有 review_open 工具:有 → 加 --surface-only(只生成页面与 surface,把 surface 绝对路径交给那个工具挂进侧栏,不起本地宿主);没有 → 不带(起无插件宿主并由公共件打开浏览器)。自检通过不代表用户批准,修改后旧批准不可复用到新版本。幻灯片路线上页面审阅是可选步骤,导出会在没审过时提醒一次;视频画面路线上审阅是门;模板审阅是模板入库(publish)的门。
  • 页面审阅工作台支持拖动缩略图调整页序(顺序写入草稿与提交的 page_order,刷新可恢复),以及双击画布文字原地编辑(回车完成、Esc 取消;顶部工具栏只保留字号、删除、批注等辅助操作)。

维护架构时读 references/architecture.md;核对机器接口时读 references/contracts/project_contract.md。它们不是每页必填的思考模板。

运行后迭代

任务结束做内部自检。仅将明确纠正或多次复现的通用缺陷作为下一次升级候选;项目反馈保留在项目;没有可复用发现时不增加日志。

三个落点,各自是唯一真相源,不要互相复述:

  • 改之前读 references/architecture.md——每个 module 拥有什么、接口是什么、动了会牵连谁。
  • 候选记进 GOTCHAS.md(Skill 根):现象/原因/行为修正/证据/状态,并写明它属于哪个 module。
  • 升级记进 references/maintenance-history.md:做了什么、为什么、影响了哪些 module、删了什么。

更改 Skill 先确认,冻结候选版本测试,测试完成后统一发布;替换旧机制时同步删除活跃旧规则和消费者。

© thePlannerIvan, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 390 other files (scripts, references, assets) in the repository root of thePlannerIvan/planners-ppt-hell.

  • SKILL.md
  • .gitignore
  • CHANGELOG.md
  • COMMERCIAL.md
  • GOTCHAS.md
  • LICENSE
  • NOTICE
  • README.md
  • SECURITY.md
  • TRADEMARK.md
  • agents/openai.yaml
  • assets/review/review.html
  • assets/template_library/agency-social-proposal/SPEC.md
  • assets/template_library/agency-social-proposal/anchors/mizuno_ops_svg_p11_architecture_6pillars.png
  • assets/template_library/agency-social-proposal/anchors/mizuno_v2_pdf_p02_3in1_system.png
  • … and 376 more

Open the folder on GitHubat commit fd9d142

Compare with similar skills

Planners Ppt Hell next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Planners Ppt Hell compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Planners Ppt Hell this skillthePlannerIvan/planners-ppt-hell234—~1.6kAutomated safety check: PassAGPL-3.0
Reimagine ItKayforkind/reimagine-it203—~11kAutomated safety check: PassMIT
Nano BananaEvoScientist/EvoSkills4752 repos~3.5kAutomated safety check: PassApache-2.0
Linkedin Carousel Generatordmccreary/ibook-skills105—~3.7kAutomated safety check: PassCC-BY-NC-4.0
Book Media Generatordmccreary/ibook-skills105—~1.7kAutomated safety check: PassCC-BY-NC-4.0
Ppt CompressorLeoYeAI/openclaw-master-skills2.2k—~3.9kAutomated safety check: PassMIT

Similar skills

  • Reimagine It

    Kayforkind/reimagine-it

    Content-Derived Design — reads existing HTML and writes a stronger standalone page from headings, facts, names, dates, numbers, links, emails, and colors already in that file.

    203 GitHub stars~11k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Nano Banana

    EvoScientist/EvoSkills

    Generate professional presentation slides and high-quality illustrations using Gemini image generation API (Nano Banana 2), with interactive browser-based review and iterative editing.

    475 GitHub starsUsed in 2 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Linkedin Carousel Generator

    dmccreary/ibook-skills

    Generates a 13-slide LinkedIn carousel (a "document post" — PPTX/PDF) that showcases an intelligent textbook's key features, with real screenshots, mascot art, and metrics pulled from the project.

    105 GitHub stars~3.7k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Book Media Generator

    dmccreary/ibook-skills

    Generates media for intelligent textbooks - slide decks and presentations (MARP web decks in docs/slides/ or PowerPoint .pptx lecture downloads), illustrated stories and graphic novels…

    105 GitHub stars~1.7k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Ppt Compressor

    LeoYeAI/openclaw-master-skills

    This skill should be used when the user wants to compress a PowerPoint (.pptx) file by reducing the size of embedded videos and large images.

    2.2k GitHub stars~3.9k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Gpt Image 2 Paper Ppt Images

    dracohu2025-cloud/draco-skills-collection

    A skill your agent uses when generating PPT-style image slides, poetic presentation covers, quiet paper-texture visual pages, report pages, invitations, social cards, or slide-image sets with…

    227 GitHub stars~3.9k tokensUpdated 21 days ago
    Documents & OfficeAuto-check passed

Questions about Planners Ppt Hell

What does Planners Ppt Hell do?

把材料或上游交来的画面契约做成有证据、可读的画面。两个出口:可编辑 PPT(优先从逐页内容稿出发 —— 通常由 planners-bypage 产出;收到非 PPT 资料包或需要完整内容理解时,先调用 planners-bypage;仅在简单单源材料且不需要内容展开时提供轻量切片降级。主 Agent 自主设计 SVG、看图修订、可选整套人工审阅,导出质量由转换器保证),以及视频静态画面(从…. Planners Ppt Hell is an agent skill from thePlannerIvan/planners-ppt-hell.

When should I use Planners Ppt Hell?

Planners Ppt Hell fits situations like: tasks that involve PowerPoint presentations; tasks that involve Video scripts and shorts.

How do I install Planners Ppt Hell in Claude Code?

Run `npx skills add thePlannerIvan/planners-ppt-hell --skill planners-ppt-hell -a claude-code`. Or copy the skill folder (the thePlannerIvan/planners-ppt-hell repository) into .claude/skills/planners-ppt-hell in your project. Claude Code loads it when a task matches its description.

How do I install Planners Ppt Hell in Codex?

Run `npx skills add thePlannerIvan/planners-ppt-hell --skill planners-ppt-hell -a codex`. Or copy the skill folder (the thePlannerIvan/planners-ppt-hell repository) into .agents/skills/planners-ppt-hell in your project. Codex loads it when a task matches its description.

Can I use Planners Ppt Hell in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thePlannerIvan/planners-ppt-hell --skill planners-ppt-hell -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/planners-ppt-hell, .gemini/skills/planners-ppt-hell, .github/skills/planners-ppt-hell and .opencode/skills/planners-ppt-hell in your project.

What does Planners Ppt Hell need to run?

Going by SKILL.md and its folder, Planners Ppt Hell needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Planners Ppt Hell access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Planners Ppt Hell safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Planners Ppt Hell use?

Planners Ppt Hell is published under the AGPL-3.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Planners Ppt Hell use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 59k tokens, read only when the agent opens those files.

What are the alternatives to Planners Ppt Hell?

Skills that share tags, products or a category with Planners Ppt Hell: Reimagine It (Kayforkind/reimagine-it, 203 stars), Nano Banana (EvoScientist/EvoSkills, 475 stars), Linkedin Carousel Generator (dmccreary/ibook-skills, 105 stars) and Book Media Generator (dmccreary/ibook-skills, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Planners Ppt Hell?

thePlannerIvan (a GitHub user) maintains it in thePlannerIvan/planners-ppt-hell, which has 234 GitHub stars. The repository was last updated on October 8, 2026.

Source: thePlannerIvan/planners-ppt-hell on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.