Agent skill

Office PPT Design Rules

by huiliyi37 in huiliyi37/Tianshu-harness

Sets design rules for building PowerPoint decks with the pptx_create and pptx_read tools: a dominant color, varied layouts, readable type and a read-back check.

Apache-2.0Auto-check passedDocuments & Office

SKILL.md written in Chinese; this summary is our English description.

Install Office PPT Design Rules

skills CLI
$ npx skills add huiliyi37/Tianshu-harness --skill office-ppt -a claude-code

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

GitHub CLI
$ gh skill install huiliyi37/Tianshu-harness office-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).

Manual copy
$ git clone --depth 1 https://github.com/huiliyi37/Tianshu-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/office-ppt/skills .claude/skills/office-ppt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

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

Facts

Skill name
office-ppt
GitHub stars
1.1k
Token cost
~401 tokens
SKILL.md length
126 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Sets design rules for building PowerPoint decks with the pptx_create and pptx_read tools: a dominant color, varied layouts, readable type and a read-back check.

  • Works in 7 steps: 配色主导原则 → 每页必须有视觉元素 → 布局要变化 → …
  • Creating a PowerPoint deck from an outline, report or talk script
  • SKILL.md covers 设计纪律, 工具速查 and 其他经验
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

These rules, adapted from the Anthropic pptx skill under Apache 2.0, guide the agent when it builds decks through the `pptx_create` and `pptx_read` tools. They ask for one dominant color covering roughly 60 to 70 percent of the visual area, one or two supporting colors and a single sharp accent, with blue never the automatic choice. A shared `theme` object carries the title, text, background and accent colors and the font face for the whole deck.

Every slide needs a visual element such as an image, chart, icon or color block, and layouts should alternate between two-column, table, chart and large-number callouts. Titles run 36 to 44 pt, body text 14 to 16 pt and captions 10 to 12 pt. There are no decorative lines under titles and no low-contrast color pairs. After generating, the agent reads the file back with `pptx_read` to check completeness and to find leftover placeholders such as lorem, TBD or TODO.

When your agent uses it

  • Creating a PowerPoint deck from an outline, report or talk script
  • Building slides that mix charts, tables and speaker notes
  • Rewriting an existing .pptx so each slide has a visual element
  • Checking a generated deck for missing content or leftover placeholders

Example prompts

  • “Build a quarterly results deck with a bar chart of revenue by region and speaker notes on each slide.”
  • “Read the existing sales-pitch.pptx and rewrite its slides so none of them is only a title and bullets.”
  • “Outline a product launch presentation first, then generate it as a .pptx with a warm green theme.”

Requirements

  • The `pptx_create` and `pptx_read` tools from the office-ppt plugin

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 配色主导原则
  2. 每页必须有视觉元素
  3. 布局要变化
  4. 字号对比
  5. 标题下绝不加装饰线
  6. 低对比是大忌
  7. 交付前自查(必做)

What it can do on your machine

Read from SKILL.md and the folder at commit 29bf77c. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Office PPT Design Rules loads about 401 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 126 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~401

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from huiliyi37/Tianshu-harness at commit 29bf77c, republished under its Apache-2.0 licence (© huiliyi37). 126 words, ~401 tokens.

Download SKILL.mdSave it as .claude/skills/office-ppt/SKILL.md (or your agent's skills folder).
name
office-ppt
description
PowerPoint 演示文稿生成纪律 — 用 pptx_create/pptx_read 产出有设计感、零 AI 味的 .pptx(PPT、幻灯片、deck、演讲稿、汇报)
triggers
ppt, pptx, 幻灯片, 演示文稿, deck, slides, 演讲, presentation, 汇报, 课件

Office PPT(演示文稿生成)

设计纪律改编自 anthropics/skills 的 pptx skill(Apache 2.0),适配本插件的 pptx_create / pptx_read 工具。

设计纪律

1. 配色主导原则
  • 一个主色占 60–70% 视觉面积,1–2 个辅助色,再加一个锐利的点缀色(accent)——不要平均分配。
  • 不要默认蓝。先想主题气质(暖橙?墨绿?单色灰?),蓝是最后的选择。
  • 用 theme 参数统一注入:{ titleColor, textColor, bgColor, accentColor, fontFace },全 deck 一致。
2. 每页必须有视觉元素

图(image slide)、图表(chart slide)、图标、色块——至少其一。拒绝纯 title + bullets 的页面,那是 AI 味的直接来源。

3. 布局要变化
  • 交替使用 two-column、table、chart、大数字 callout、对比栏,不要连续三页同一布局。
  • body 一律左对齐;只有标题可以居中(且仅 title/section 页)。
4. 字号对比
  • 标题 36–44pt bold(本工具默认标题 36–40pt)。
  • 正文 14–16pt。
  • 说明/来源/脚注 10–12pt,用 muted 色(accentColor)。
5. 标题下绝不加装饰线

标题下方画一条装饰横线是 AI 生成 deck 的头号标志。用留白或底色区块来分隔层级,不用线。

6. 低对比是大忌

浅底浅字、深底深字都禁止。正文与背景的对比度必须清晰可读——拿不准就用深字浅底。

7. 交付前自查(必做)

生成后必须用 pptx_read 读回自查:

  • 内容完整性:每页标题/正文是否齐全,页数是否符合预期。
  • 占位符残留:搜索 lorem、xxxx、TBD、TODO、「待补充」——发现一个修一个。

口头说「内容应该没问题」不算交付。

工具速查

工具何时用
pptx_create从 slide 定义生成 .pptx;slide type: title / section / content / two-column / image / table / chart;每个 slide 可带 notes 写演讲备注
pptx_read读回 .pptx 文本(include_notes: true 连备注一起读),用于自查与改写现有 deck

其他经验

  • 演讲备注(notes)写给讲者看的提示,不要把幻灯片正文复制一遍。
  • chart slide 数据结构:{ type: 'chart', chart: 'bar'|'line'|'pie', data: [{ name, labels: [...], values: [...] }] };饼图只传一个 series。
  • 大 deck 先列大纲(每页一句话标题 + 视觉元素类型)再生成,避免中途返工。

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

Files

Just SKILL.md in plugins/office-ppt/skills of huiliyi37/Tianshu-harness.

Open the folder on GitHubat commit 29bf77c

Compare with similar skills

Office PPT Design Rules 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.

Office PPT Design Rules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Office PPT Design Rules this skillhuiliyi37/Tianshu-harness1.1k—~401Automated safety check: PassApache-2.0
PPT Masterhugohe3/ppt-master59k1 repos~2.5kAutomated safety check: PassMIT
PowerPoint Decksanthropics/skills180k4 repos~5.2kAutomated safety check: PassProprietary
PPTXrvdbreemen/OTGW-firmware20734 repos~2.3kAutomated safety check: PassProprietary
Dashi PPT Presentation Generatorchuspeeism/dashi-ppt-skill9.3k—~3.9kAutomated safety check: PassAGPL-3.0
Image To Editable Pptningzimu/image-to-editable-ppt-skill2.9k—~4.3kAutomated safety check: PassMIT

Similar skills

  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    59k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed
  • PowerPoint Decks

    anthropics/skills

    Official

    Creates, edits, reads and validates .pptx and .potx files, using pptxgenjs for new decks and direct XML edits for existing ones, with helper scripts for thumbnails and checks.

    180k GitHub starsUsed in 4 repos~5.2k tokens
    Documents & OfficeAuto-check passed
  • PPTX

    rvdbreemen/OTGW-firmware

    Use this skill any time a .pptx file is involved in any way — as input, output, or both.

    207 GitHub starsUsed in 34 repos~2.3k tokens
    Documents & OfficeAuto-check passed
  • Dashi PPT Presentation Generator

    chuspeeism/dashi-ppt-skill

    Generates browser-editable HTML slide decks from a natural-language brief using preset visual themes, with export to PPTX or PDF.

    9.3k GitHub stars~3.9k tokensUpdated 28 days ago
    Documents & OfficeAuto-check passed
  • Image To Editable Ppt

    ningzimu/image-to-editable-ppt-skill

    Rebuild slide images, scanned or image-based PPT/PPTX files, and PDF decks into object-level editable PowerPoint (.pptx), preserving speaker notes when supplied.

    2.9k GitHub stars~4.3k tokensUpdated 25 days ago
    Documents & OfficeAuto-check passed
  • Image-Based PPT Deck Generator

    ningzimu/codex-ppt-skill

    Builds visually unified PowerPoint decks from articles, reports, papers, notes or outlines, with every slide generated as a full 16:9 image and assembled into a .pptx.

    6.6k GitHub stars~2.6k tokensUpdated yesterday
    Documents & OfficeAuto-check: notes

More from huiliyi37/Tianshu-harness

  • Agent Harness Testing Methodology

    huiliyi37/Tianshu-harness

    Guides an agent through probing an unfamiliar project's test setup, then choosing a red-light-first testing strategy matched to the task type.

    1.1k GitHub stars~1k tokensUpdated today
    Auto-check: notes
  • Visual Acceptance Review

    huiliyi37/Tianshu-harness

    Chinese-language final-check method for UI visual changes before delivery, using multi-theme screenshot matrices, pixel-level evidence and a CSS cascade checklist.

    1.1k GitHub stars~601 tokensUpdated today
    Auto-check passed
  • Frontend Prototype Workflow

    huiliyi37/Tianshu-harness

    Asks one clarifying question at a time, then builds two or three single-file HTML prototypes checked across phone, tablet, and desktop widths.

    1.1k GitHub stars~415 tokensUpdated today
    Auto-check passed
  • Word Document Generator

    huiliyi37/Tianshu-harness

    Generates and reads Word (.docx) documents such as reports, contracts and bids from heading, paragraph, table, code and list blocks, with a centered title.

    1.1k GitHub stars~252 tokensUpdated today
    Auto-check passed
  • Office Excel

    huiliyi37/Tianshu-harness

    Excel 电子表格读写与编辑最佳实践 — 用 xlsxread/xlsxwrite/xlsxedit 处理 .xlsx 时遵守的公式、数字格式与可维护性纪律

    1.1k GitHub stars~340 tokensUpdated today
    Auto-check passed
  • Office PDF Generator and Reader

    huiliyi37/Tianshu-harness

    Generates formal PDFs from structured content blocks with automatic CJK font handling and page numbers, and reads text back out of existing PDFs.

    1.1k GitHub stars~334 tokensUpdated today
    Auto-check passed

Questions about Office PPT Design Rules

What does Office PPT Design Rules do?

Sets design rules for building PowerPoint decks with the pptx_create and pptx_read tools: a dominant color, varied layouts, readable type and a read-back check. 0, guide the agent when it builds decks through the `pptx_create` and `pptx_read` tools. They ask for one dominant color covering roughly 60 to 70 percent of the visual area, one or two supporting colors and a single sharp accent, with blue never the automatic choice.

When should I use Office PPT Design Rules?

Office PPT Design Rules fits situations like: creating a PowerPoint deck from an outline, report or talk script; building slides that mix charts, tables and speaker notes; rewriting an existing .pptx so each slide has a visual element; checking a generated deck for missing content or leftover placeholders.

How do I install Office PPT Design Rules in Claude Code?

Run `npx skills add huiliyi37/Tianshu-harness --skill office-ppt -a claude-code`. Or copy the skill folder (plugins/office-ppt/skills in huiliyi37/Tianshu-harness) into .claude/skills/office-ppt in your project. Claude Code loads it when a task matches its description.

How do I install Office PPT Design Rules in Codex?

Run `npx skills add huiliyi37/Tianshu-harness --skill office-ppt -a codex`. Or copy the skill folder (plugins/office-ppt/skills in huiliyi37/Tianshu-harness) into .agents/skills/office-ppt in your project. Codex loads it when a task matches its description.

Can I use Office PPT Design Rules 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 huiliyi37/Tianshu-harness --skill office-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/office-ppt, .gemini/skills/office-ppt, .github/skills/office-ppt and .opencode/skills/office-ppt in your project.

What does Office PPT Design Rules need to run?

SKILL.md names no scripts, command-line tools or credentials: Office PPT Design Rules is instructions for the agent only. Our summary lists: The `pptx_create` and `pptx_read` tools from the office-ppt plugin.

Does Office PPT Design Rules 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 Office PPT Design Rules 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. Review the folder before installing.

What licence does Office PPT Design Rules use?

Office PPT Design Rules is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Office PPT Design Rules use?

About 401 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Office PPT Design Rules?

Skills that share tags, products or a category with Office PPT Design Rules: PPT Master (hugohe3/ppt-master, 59k stars), PowerPoint Decks (anthropics/skills, 180k stars), PPTX (rvdbreemen/OTGW-firmware, 207 stars) and Dashi PPT Presentation Generator (chuspeeism/dashi-ppt-skill, 9.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Office PPT Design Rules?

huiliyi37 (a GitHub user) maintains it in huiliyi37/Tianshu-harness, which has 1,091 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 11, 2026.

Source: huiliyi37/Tianshu-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.