Agent skill

Qiaomu Bento Ppt

by joeseesun in joeseesun/qiaomu-bento-ppt

Use the standalone qiaomu-bento-ppt skill to create or edit qiaomu-style bento presentations as self-contained .bento.html files from briefs, notes, reports, URLs, data, or existing bento decks.

MITAuto-check passedDocuments & Office

Install Qiaomu Bento Ppt

skills CLI
$ npx skills add joeseesun/qiaomu-bento-ppt --skill qiaomu-bento-ppt -a claude-code

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

GitHub CLI
$ gh skill install joeseesun/qiaomu-bento-ppt qiaomu-bento-ppt --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
qiaomu-bento-ppt
GitHub stars
127
Token cost
~1.3k tokens
SKILL.md length
268 words
Files
53 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Use the standalone qiaomu-bento-ppt skill to create or edit qiaomu-style bento presentations as self-contained .bento.html files from briefs, notes, reports, URLs, data, or existing bento decks.

  • Works in 3 steps: references/upstream/bento-official-skill.… → references/upstream/bento-agents.md → references/upstream/bento-format.md
  • The user explicitly asks for bento/slides
  • SKILL.md covers Router Rules, Required Sources, Compact Workflow and Authoring Rules, plus 3 more sections
  • Calls python3

What it does

Qiaomu Bento Ppt is an agent skill from joeseesun/qiaomu-bento-ppt. Use the standalone qiaomu-bento-ppt skill to create or edit qiaomu-style bento presentations as self-contained .bento.html files from briefs, notes, reports, URLs, data, or existing bento decks. Use this skill when the user explicitly asks for bento/slides, a .bento.html deck, an offline-editable single-file HTML presentation, or invokes qiaomu-bento-ppt. It applies a proposal-first presentation workflow, ships a pinned official bento shell and authoring references inside the skill, builds through the plaintext…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 60 other files, including scripts, reference files and assets (for example `.github/workflows/sync-bento-upstream.yml`, `NOTICE.md` and `README.md`).

It sits in Documents & Office, covering PowerPoint presentations, Slides and decks and HTML artifacts. It works with Microsoft PowerPoint. The repository describes itself as: Use the standalone qiaomu-bento-ppt skill to create or edit qiaomu-style bento presentations as self-contained .bento.html files from briefs, notes, r. The licence is MIT.

When your agent uses it

  • The user explicitly asks for bento/slides
  • A .bento.html deck
  • An offline-editable single-file HTML presentation
  • Invokes qiaomu-bento-ppt

Example prompts

  • “/qiaomu-bento-ppt”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. references/upstream/bento-official-skill.md
  2. references/upstream/bento-agents.md
  3. references/upstream/bento-format.md

What it can do on your machine

Read from SKILL.md and the folder at commit 55c63c8. 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:

    • python3

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

  • Network

    Links to these hosts (documentation or services it may open):

    • x.com
    • github.com

    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

Qiaomu Bento Ppt loads about 1.3k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 203 tokens; SKILL.md has 268 words of instructions outside code blocks.

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

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 joeseesun/qiaomu-bento-ppt at commit 55c63c8, republished under its MIT licence (© joeseesun). 268 words, ~1,260 tokens.

Download SKILL.mdSave it as .claude/skills/qiaomu-bento-ppt/SKILL.md (or your agent's skills folder). This skill also uses 52 other files; get the full folder from GitHub.
name
qiaomu-bento-ppt
description
Use the standalone qiaomu-bento-ppt skill to create or edit qiaomu-style bento presentations as self-contained .bento.html files from briefs, notes, reports, URLs, data, or existing bento decks. Use this skill when the user explicitly asks for bento/slides, a .bento.html deck, an offline-editable single-file HTML presentation, or invokes qiaomu-bento-ppt. It applies a proposal-first presentation workflow, ships a pinned official bento shell and authoring references inside the skill, builds through the plaintext #bento-doc contract without requiring the original bento repository, and validates structure, identity, shell integrity, visual heuristics, and rollback boundaries. Do not use for conventional .pptx delivery, generic bento source development, or bento/spaces and bento/dash work.
metadata.author
向阳乔木
metadata.copyright
Copyright (c) 向阳乔木
metadata.upstream
https://github.com/nyblnet/bento

qiaomu bento ppt

把资料转成可编辑、可演示、可离线分发的单文件 bento/slides deck。

Router Rules

  • 触发:用户明确提到 bento、.bento.html、单文件 HTML 演示文稿、离线可编辑 deck,或点名 $qiaomu-bento-ppt。
  • 近邻:只说“做 PPT”且未指定格式时,优先使用通用 PPT skill;先确认是否接受 bento 格式。
  • 不触发:明确要求 .pptx、Keynote、Google Slides;开发 bento 平台源码;制作 bento/spaces、bento/dash 或 bento/vault。
  • 编辑已有 deck 时保留 docId、未知字段、collab 数据和原始 HTML shell;只改 #bento-doc。
  • 新建 deck 时只生成一次 docId。禁止把既有文档当“新文档”重新生成身份。
  • 不发布、不部署、不签名,不读取 ~/.bento/release-key.json。

Required Sources

开始制作前读取 references/workflow.md 和 references/upstream-contract.md。

本 skill 自带固定版本的官方资料,按顺序读取:

  1. references/upstream/bento-official-skill.md
  2. references/upstream/bento-agents.md
  3. references/upstream/bento-format.md

当前固定 release、commit、文件来源与 SHA-256 记录在 upstream.lock.json。普通 deck 任务禁止临时联网换最新版;只有用户明确提出 维护/同步上游时,才运行:

bash
python3 scripts/sync_upstream.py --report reports/upstream-sync-check.json

需要刷新时加 --update。脚本只接受同一个官方 GitHub release 的完整快照, 全部暂存并验证后才替换;随后必须重跑 standalone、identity、shell、fixture 和 browser gates。定期 GitHub workflow 只创建 PR,不直接更新 main。

用下面的命令检查独立资产:

bash
python3 scripts/bento_deck.py locate

正常结果必须包含 "standalone": true。原始 bento checkout 不是前置条件; 只有更新兼容性检查时才可选传入 --repo。

Compact Workflow

  1. 判定交付物:确认新建还是编辑、语言、受众、场景、时长、比例、是否必须完全离线,以及用户是否明确要求跳过方案确认。
  2. 先做方案:广义主题先给 1a / 2b / 3c 选择卡和默认建议;形成 source-grounded deck-plan.md。用户说“直接生成/跳过确认”时可继续。
  3. 读取官方规范:使用 skill 内置的官方 bento skill/agent/format 快照,禁止凭记忆发明字段。
  4. 提取或起草 JSON:
    • 编辑:python3 scripts/bento_deck.py extract input.bento.html --output deck.json
    • 新建:从官方最小文档骨架起草;不带 collab、template、readonly。
  5. 内容映射:数字→chart,规格/对比→table,连续变化→morph,展开细节→state slide,主视觉→image+scrim+ken-burns,流程→path/dash-march,关键数字→countUp。
  6. 构建新文件:默认不覆盖任何输入。
bash
python3 scripts/bento_deck.py build deck.json \
  --output result.bento.html \
  --new-document \
  --report reports/deck-validation.json

编辑已有 deck 时去掉 --new-document,用原文件同时锚定身份和 shell:

bash
python3 scripts/bento_deck.py build deck.json \
  --identity-source input.bento.html \
  --output input.updated.bento.html \
  --report reports/deck-validation.json

脚本会拒绝 deck.json 与原文件 docId 不一致的构建。只有用户明确要求时 才加 --overwrite。

  1. 验证:结构校验、bento shell gate、真实浏览器打开、编辑态与演示态检查。视觉任务不能只以脚本通过作为完成证据。
  2. 交付:给出 .bento.html、deck-plan.md、可选 deck.json、验证结果和仍属 missing evidence 的项目。

Authoring Rules

  • 默认 1280×720;遵循实际 doc.size。常规内容保留约 96px 侧边距。
  • 每页一个视觉主语;画面与字幕/正文不要完整复读同一句。
  • 一套主色、最多两套字体。不要用左侧彩色竖线、默认网格或施工线制造廉价层级。
  • 使用真实图片、图标和数据;外部 URL 媒体会破坏离线承诺,必须明确说明。
  • 同一对象跨页变化时使用稳定、确定性的 id;同一页的有效 morph key 不得重复。
  • 每页写 speaker notes。控制文字密度,数字能图表化时不要堆文字。
  • chart option 必须是纯 JSON;bar/line 数据用纯数字;禁止函数 formatter。
  • 写入文档块时所有 < 转义为 \u003c,文档块中不得出现字面 script 结束标签。

Gate Ladder

  • Route gate:触发和近邻边界通过 evals/trigger_cases.json。
  • Structure gate:scripts/bento_deck.py validate 无 error。
  • Shell gate:生成文件必须通过内部 gate;可选 checkout 存在时再跑其 scripts/shell-gate.mjs 做兼容性复核。
  • Identity gate:编辑时 docId 与源文件一致;新建时只 mint 一次。
  • Quality gate:无越界、关键文字过小、空 notes、断链、无动效等未解释 warning。
  • Browser gate:真实打开后检查封面、至少一页内容页、演示模式、字体/图片/图表和无横向溢出。
  • Rollback boundary:默认写新文件;源 .bento.html 与源资料保持不变。
  • Upstream gate:upstream.lock.json 与四个内置快照的 SHA-256 必须一致;自动同步只能开 PR,合并前仍需浏览器复核。
  • 缺少浏览器、人工审阅、外部媒体可用性或发布安装证明时标为 missing evidence,不得写成“已验证”。

Output Contract

  1. deck-plan.md:受众、目标、叙事弧、逐页结构、素材映射、视觉方向、证据来源。
  2. deck.json:纯 bento/slides 文档数据;编辑场景保留身份和未知字段。
  3. <title>.bento.html:可独立打开、编辑和演示的单文件交付物。
  4. reports/deck-validation.json:errors、warnings、shell gate 和身份结果。
  5. 简短交付说明:路径、页数、离线边界、已验证项、missing evidence。

Permissions And Exclusions

  • 允许:读取用户指定资料和 skill 内置 shell/规范;在任务输出目录写计划、JSON、报告和新 deck;运行 Python 校验与本地浏览器。
  • 需用户明确授权:手动联网更新 shell/规范、覆盖既有 deck、把大型媒体改成外链、修改 bento 项目源码。仓库维护者启用的定期同步 workflow 仅限官方 release 元数据和快照,并只创建待审 PR。
  • 禁止:发布/部署/release、触碰签名密钥、向 main 直接推送、把 token/cookie/账号写入 deck 或报告。

版权与联系:Copyright (c) 向阳乔木 · X · GitHub

© joeseesun, MIT. 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 52 other files (scripts, references, assets) in the repository root of joeseesun/qiaomu-bento-ppt.

  • SKILL.md
  • .github/workflows/sync-bento-upstream.yml
  • .gitignore
  • LICENSE
  • NOTICE.md
  • README.md
  • THIRD_PARTY_LICENSES/bento-MIT.txt
  • agents/interface.yaml
  • assets/bento/Bento_Slides.bento.html
  • assets/qiaomu-profile/qiaomu_avatar.jpeg
  • assets/qiaomu-profile/qiaomu_reward_qr.png
  • assets/qiaomu-profile/qiaomu_wechat_public_account_qr.jpg
  • docs/assets
  • … and 40 more

Open the folder on GitHubat commit 55c63c8

Compare with similar skills

Qiaomu Bento Ppt 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.

Qiaomu Bento Ppt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qiaomu Bento Ppt this skilljoeseesun/qiaomu-bento-ppt127—~1.3kAutomated safety check: PassMIT
Ky Markdown RebuilderKyrieCheungYep/ky-markdown-rebuilder117—~5.7kAutomated safety check: PassNone
PPT as CodeRussell-cell/PPT-as-code190—~11kAutomated safety check: PassMIT
Sci HTMLShZhao27208/Aut_Sci_Write209—~1.4kAutomated safety check: NotesMIT
Superloopy Slidesbeefiker/superloopy1111 repos~8.8kAutomated safety check: PassMIT
Ambiguity Reportlawve-ai/awesome-legal-skills847—~4.6kAutomated safety check: PassApache-2.0

Similar skills

  • Ky Markdown Rebuilder

    KyrieCheungYep/ky-markdown-rebuilder

    Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.

    117 GitHub stars~5.7k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • PPT as Code

    Russell-cell/PPT-as-code

    Plans and builds HTML-based web presentations through staged quick, basic or advanced workflows, with optional visualization planning, motion, a workbench and PPTX export handoff.

    190 GitHub stars~11k tokensUpdated 6 mo ago
    Documents & OfficeAuto-check passed
  • Sci HTML

    ShZhao27208/Aut_Sci_Write

    Generate academic presentation-style HTML slide decks and browser reports from PDFs, structured text, Markdown, paper summaries, outlines, or research notes.

    209 GitHub stars~1.4k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Superloopy Slides

    beefiker/superloopy

    Creates zero-dependency, animation-rich HTML slide decks that run in the browser, with style presets, PowerPoint conversion and PDF export, proven by a real-browser render.

    111 GitHub starsUsed in 1 repo~8.8k tokens
    Documents & OfficeAuto-check passed
  • Ambiguity Report

    lawve-ai/awesome-legal-skills

    Turn an interpretive-ambiguity audit of a legal text — contract, statute, regulation, or judicial opinion — into a polished deliverable.

    847 GitHub stars~4.6k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed
  • Data Viz Deck

    thatrebeccarae/claude-marketing

    Transform audit data, performance reports, and structured analyses into polished visual deliverables.

    161 GitHub stars~1.8k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed

Questions about Qiaomu Bento Ppt

What does Qiaomu Bento Ppt do?

Use the standalone qiaomu-bento-ppt skill to create or edit qiaomu-style bento presentations as self-contained .bento.html files from briefs, notes, reports, URLs, data, or existing bento decks. Qiaomu Bento Ppt is an agent skill from joeseesun/qiaomu-bento-ppt.html files from briefs, notes, reports, URLs, data, or existing bento decks.

When should I use Qiaomu Bento Ppt?

Qiaomu Bento Ppt fits situations like: the user explicitly asks for bento/slides; A .bento.html deck; an offline-editable single-file HTML presentation; invokes qiaomu-bento-ppt.

How do I install Qiaomu Bento Ppt in Claude Code?

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

How do I install Qiaomu Bento Ppt in Codex?

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

Can I use Qiaomu Bento Ppt 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 joeseesun/qiaomu-bento-ppt --skill qiaomu-bento-ppt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qiaomu-bento-ppt, .gemini/skills/qiaomu-bento-ppt, .github/skills/qiaomu-bento-ppt and .opencode/skills/qiaomu-bento-ppt in your project.

What does Qiaomu Bento Ppt need to run?

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

Does Qiaomu Bento Ppt access the network?

SKILL.md names 2 domains. As links in the text: x.com and github.com. This is read from the text; nothing was executed.

Is Qiaomu Bento Ppt 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 Qiaomu Bento Ppt use?

Qiaomu Bento Ppt is published under the MIT 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 Qiaomu Bento Ppt use?

About 1.3k tokens (SKILL.md is roughly 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 12k tokens, read only when the agent opens those files.

What are the alternatives to Qiaomu Bento Ppt?

Skills that share tags, products or a category with Qiaomu Bento Ppt: Ky Markdown Rebuilder (KyrieCheungYep/ky-markdown-rebuilder, 117 stars), PPT as Code (Russell-cell/PPT-as-code, 190 stars), Sci HTML (ShZhao27208/Aut_Sci_Write, 209 stars) and Superloopy Slides (beefiker/superloopy, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qiaomu Bento Ppt?

joeseesun (a GitHub user) maintains it in joeseesun/qiaomu-bento-ppt, which has 127 GitHub stars. The repository was last updated on July 27, 2026.

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