Agent Skills
› fanfan-de/anybox
› PowerPoint PPTX Builder
PowerPoint PPTX Builder
GitHub用于通过代码生成可编辑的 PowerPoint PPTX 文件。支持按幻灯片编写 ESM 模块，利用特定运行时库定义布局元素，并遵循渲染、质量检查到构建的工作流，确保输出符合规范的演示文稿。
Trigger Scenarios
用户需要创建或编辑 PowerPoint 演示文稿
用户要求生成 .pptx 文件或幻灯片
Install
npx skills add fanfan-de/anybox --skill PowerPoint PPTX Builder -g -y
SKILL.md
Frontmatter
{
"name": "PowerPoint PPTX Builder",
"description": "Create editable Microsoft PowerPoint `.pptx` decks locally with code-first slide modules, PNG previews, layout JSON, and strict layout QA. Use when the user wants an Office presentation, slide deck, PPT, PPTX, or PowerPoint artifact."
}
PowerPoint PPTX Builder Skill
Use this skill when the durable output should be an editable Microsoft PowerPoint .pptx file.
Contract
- Use only
@anybox/presentation-runtimefrom this plugin. Do not importpptxgenjsor other presentation libraries directly. - Create one ESM module per slide under
workspaces/<task-id>/slides/. - Each slide module must export
slideXX(presentation, ctx), whereXXmatches the filename, for exampleslide-01.mjsexportsslide01. - Slide modules may create a slide with
presentation.slides.add()and callcomposeSlide(slide, elementTree). - Use editable primitives:
Text,Shape,Image,Layers,Panel,Row, andColumn. - Do not export PPTX directly from slide modules. Rendering, QA, and export are controlled by the plugin scripts.
- Keep assets under
workspaces/<task-id>/assets/. Usectx.assetPath("name.png")for local assets.
Required Workflow
- Draft or update slide modules in
workspaces/<task-id>/slides/. - Run plugin scripts from the active project directory. If the script files are not present in the project, call the installed plugin script with an absolute path;
--workspace workspaces/<task-id>is resolved relative to the current project directory. - Render each changed slide:
node scripts/render_slide.mjs --workspace workspaces/<task-id> --slide slides/slide-01.mjs
- Run layout QA:
node scripts/check_layout_quality.mjs --workspace workspaces/<task-id>
- Build the deck only after previews and QA pass:
node scripts/build_deck.mjs --workspace workspaces/<task-id>
- Deliver only
workspaces/<task-id>/output/final.pptxunless the user explicitly asks for previews or QA artifacts.
Sandbox Notes
Slide modules run in a practical child-process sandbox with an import whitelist, workspace path checks, output directory controls, and timeouts. This is not a strong security boundary. Do not write shell commands, read home directories, read secrets, access the network, or perform side effects in slide modules.
Allowed slide module import:
import {
Presentation,
Layers,
Text,
Shape,
Panel,
Row,
Column,
Image,
composeSlide,
textStyle,
stroke,
fill,
} from "@anybox/presentation-runtime";
Slide Module Example
import {
Layers,
Text,
Shape,
composeSlide,
textStyle,
stroke,
} from "@anybox/presentation-runtime";
export async function slide01(presentation, ctx) {
const slide = presentation.slides.add();
composeSlide(
slide,
Layers({ width: 1280, height: 720 }, [
Shape({
fill: "#F7F4ED",
line: stroke("none"),
position: { left: 0, top: 0 },
width: 1280,
height: 720,
}),
Text("Quarterly Review", {
role: "title",
position: { left: 80, top: 80 },
width: 900,
height: 70,
style: textStyle("font: 44px Arial; weight: 700; color: #17202A"),
}),
]),
);
return slide;
}
Quality Gates
Before final delivery, confirm:
output/final.pptxexists and is non-empty.layout/deck.jsonexists and slide count matches the requested deck.- PNG previews are not blank.
- No elements exceed the canvas.
- Text boxes have no obvious overflow warnings left unresolved.
- Images resolve to existing files or valid data URIs.
- Every slide has a visible title.
preview/contact-sheet.pngexists for deck-level review.
If LibreOffice is unavailable, the build falls back to SVG/PNG/layout QA and records loFinalRenderSkipped in the build summary.
Version History
- 08dc189 Current 2026-07-05 19:04
