102.7K+Download
Skip to the usage guide
pptx-slide-specificationby Seth Hobson

PPTX Slide Specification Skill.

A Claude Code and Codex skill for PPT and slide decks: authors coordinate-explicit JSON specifications for editable PPTX decks.

  • Presentations
  • PPTX
Download OpenDesignView usage guide
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-slide-specification/SKILL.mdSKILL.md
--- name: pptx-slide-specification description: Use when authoring or repairing a coordinate-explicit JSON specification for an editable PPTX deck. --- ## Required contract ## Authoring rules ## Build contract
Front matter and section headings read from the upstream file on 2026-09-14 · 1,954 characters in full

01 What it does

What the pptx-slide-specification Skill Does in Claude Code and Codex

Summary, workflow and outputs, all read from the skill's SKILL.md.

From the SKILL.mdRead 2026-09-14 · not a recorded run

In the Skill's Own Terms

This skill authors coordinate-explicit JSON specifications for editable PowerPoint decks where every element has final inch-based bounding boxes, stable IDs, styles, z-indexes, and classifications. No renderer may decide placement or shrink text after specification. The root JSON contains summary and slides; each slide has a stable ID, message-led title, accessibility reading order, and complete layout_tree.

Production summaries declare safe margins, content and footer boundaries, minimum gaps and accessibility metadata. Labels and values from supporting visuals are recreated as native objects, while meaningful images can remain images with alt text. The builder must honor the specified geometry without automatic text shrinking.

What it produces

  • JSON specification with summary and slides containing coordinate-explicit layout trees
See the example prompt ↗

How It Works

  1. 01
    Author Final Coordinates in Layout_tree

    Write absolute inch-based bounding boxes directly into the layout tree. No renderer may decide placement, shrink text, or infer layout after the audit.

  2. 02
    Declare Complete Structure per Slide

    Each slide must have a stable ID, message-led title, accessibility reading order, and a complete layout_tree that declares slide size, root group, and all objects.

  3. 03
    Specify All Object Properties Explicitly

    Every meaningful object must declare id, kind, role, classification, content, style, bbox, and z_index with final inch bboxes and styles.

  4. 04
    Builder Maps to Blank Slide Layout

    A task-local builder starts from a blank slide layout and maps all bboxes with Inches().

02 Find your fit

When to Use the pptx-slide-specification Skill

Use the pptx-slide-specification skill in Claude Code or Codex when the job is PPT and slide decks of this kind. Fit and limits below are taken from the skill's own file.

Good Fit

  • Authoring a coordinate-explicit JSON specification for an editable PPTX deck

Know the Boundaries

  • The primary deliverable is a JSON specification. A task-local builder and separate rendering checks are needed to turn it into, and verify, an editable PPTX.

What to Provide

  • Deck content and layout constraintsProvide the slide messages, source data, assets, slide dimensions, theme and safe-margin/footer requirements. For repairs, include the existing JSON and the layout defect.

03 Inside the skill

Rules the pptx-slide-specification Skill Gives Claude Code and Codex

7 concrete instructions, defaults and limits the SKILL.md sets for the agent — the part of the file that changes the result.

  1. Use Stable Readable IDs and Positive Dimensions

    All IDs must be stable and readable. Use absolute groups and positive inch dimensions throughout the specification.

  2. Keep Content Inside Safe Margin and Above Footer

    Normal content must stay inside the safe margin and above the footer rail. Only background layout_design objects may be full bleed.

  3. Minimum Content Text Size Is 9pt

    Keep content text at 9 pt or greater. Shorten, resize, or split dense content before reducing type size.

  4. Use Native Objects for All Content

    Use native text, shape, line, table, and image objects. Recreate labels and values from any supporting visual as native objects instead of leaving them in images.

  5. Provide Accessibility and Source Metadata

    Give meaningful images alt text. Record source_ref for sourced claims. Production summary must contain accessibility metadata.

  6. Include Explicit Layout_policy in Summary

    Production summary must contain an explicit layout_policy that specifies safe margin, content bottom, footer top, and minimum gap.

  7. Builder Rejects Invalid Geometry

    The builder must reject zero or negative geometry before adding an object to ensure all shapes have valid dimensions.

04 Put it to work

Install pptx-slide-specification in Claude Code or Codex

One npx skills add command, then a first task in your agent and a checklist for the result.

Add pptx-slide-specification to Claude Code, Codex or Your Agent

Run in your project; the installer asks which agent to add it to.

Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-slide-specification

Generic skills CLI form for plugins/pptx-deck-creation/skills/pptx-slide-specification/SKILL.md; the repository may document its own path.

Give the Skill a First PPT and Slide Decks Task

Written in the skill's own terms; replace the bracketed parts with your material.

Starter prompt
Create a PPTX specification for a [quarterly performance review] deck with [5 slides]. Include a title slide, three data slides showing [revenue trends, customer acquisition, and operational metrics], and a closing slide with next steps. Use a [corporate] layout with consistent spacing and ensure all chart labels are native text objects at minimum 9pt.

Editorial starter example based on the source workflow; not a recorded run.

Check the First Result

Before accepting the output, look for these in the transcript and the files:

  • Use stable readable IDs, absolute groups, and positive inch dimensions.
  • Keep normal content inside the safe margin and above the footer rail. Only background layout_design objects may be full bleed.
  • Use native text, shape, line, table, and image objects. Recreate labels and values from any supporting visual as native objects.
  • Give meaningful images alt text. Record source_ref for sourced claims.
  • Keep content text at 9 pt or greater; shorten, resize, or split dense content before reducing type.
  • Use shared grids, consistent gaps, explicit color, explicit font size, and an intentional z-order.

In OpenDesign check your installed version’s skill list and supported tools. If this skill is absent, consult the current import guide and the upstream setup instructions. The source review is not a live compatibility test.

Download OpenDesignRead the quickstart

05 Open source, traceable

Source, License and Verification

Where this page's facts come from, and when they were last checked.

Author
Seth Hobson
Repository
github.com/wshobson/agents Branch main
Skill file
plugins/pptx-deck-creation/skills/pptx-slide-specification/SKILL.md Content checksum recorded at verification; commit 4236bb9
License
MIT From LICENSE.
Repository stars
39,635 GitHub snapshot taken 2026-09-14 for the whole wshobson/agents repository, which contains 18 skills in this catalog. Not a rating or usage count for pptx-slide-specification.
Verified by OpenDesign
2026-09-14 Source file, path, license text and star count were checked. Not bundled in OpenDesign main (checked 2026-08-28); a live run has not been recorded on this page.

Inside the SKILL.md

  1. Required contractDefines root JSON structure, slide requirements, layout tree contents, and required object fields
  2. Authoring rulesSpecifies ID conventions, margin rules, native object usage, accessibility requirements, type size minimums, and consistency standards
  3. Build contractExplains how builder processes specification from blank layouts, explicit property settings, and geometry validation
The Skill's Own Description
“Use when authoring or repairing a coordinate-explicit JSON specification for an editable PPTX deck.”

Front-matter description from SKILL.md. The full file is about 1,954 characters. Read the full file on GitHub.

PPTX Slide Specification

Run pptx-slide-specification on a Real PPT and Slide Decks Task.

Start with the example task above, supply the listed inputs and check the required tools. Review the output against the checklist before using it in a project.

Download OpenDesignBrowse all skills
Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-slide-specification