Skip to content

PPTX Slide Specification

Writes precise, editable PowerPoint slide layouts as coordinate-explicit JSON specs

Repository
wshobson/agents
Stars
42,095
Licence
MIT
Files
2 files

What it does

This skill teaches an AI agent to write a detailed JSON blueprint for a PowerPoint deck in which every object (text, shapes, lines, tables, images) has an exact position and size in inches, so the slides stay editable and do not rely on a renderer to guess layout. It sets rules such as keeping content inside a safe margin, keeping body text at 9 pt or larger, giving images alt text, and recording sources for claims. It also explains how a build script should construct the slides from that specification.

Great for

  • Developers or automation builders who generate PowerPoint files programmatically and need predictable placement
  • Teams producing many decks from structured content who want consistent grids and accessibility metadata

Skip it if

  • People who just want a finished slide deck by typing a topic; this skill produces a specification, not the .pptx itself, and needs a separate builder script (the files do not supply one)
  • Layouts that depend on automatic text fitting or renderer-side adjustments, since the contract forbids those behaviours by design

Try asking

  • “Write a coordinate-explicit JSON spec for a five-slide quarterly results deck with native tables and charts placed on a shared grid”
  • “Repair an existing layout_tree JSON where objects overlap the footer rail and text is below 9 pt”
  • “Add accessibility metadata, alt text and source_ref fields to a deck specification”
Step-by-step guide: how to use PPTX Slide SpecificationInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    pptx-slide-specification.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip pptx-slide-specification.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip pptx-slide-specification.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask for the layout_policy values (safe margin, footer top, minimum gap) up front so the specification is consistent from the start
  • Pair the spec with a builder script and open the output in PowerPoint to confirm editability and placement
  • Provide your content and sources in the request so source_ref fields can be filled accurately

What's inside

  • references/layout-contract.md
  • SKILL.md

Redistributed unmodified from wshobson/agents under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.