bggg-creator-image2ppt

Original：🇨🇳 Chinese

Translated

3 scripts

A Codex skill that converts images, screenshots, posters, PPT page screenshots, HTML or SVG design drafts into editable PPTX. This skill should be used when users need image2ppt, image2pptx, image-to-PPT, screenshot-to-PPT, PNG/JPEG to editable slides, HTML/SVG to PPTX, splitting design drafts into image components and text boxes then assembling into PowerPoint, or want to reuse Codex's built-in image generation capability to rebuild flat designs into multi-element editable PPTs. When processing binary images in Codex, it defaults to integrating with the imagegen skill: first use Codex's visual understanding to analyze the layout, then use the built-in image generation/editing capability to generate or clean multiple component images, and finally use this skill's scripts to assemble the PPTX.

4installs

Sourcebinggandata/bggg-skills

Added on2026-05-05

NPX Install

npx skill4agent add binggandata/bggg-skills bggg-creator-image2ppt

SKILL.md Content (Chinese)

View Translation Comparison →

BGGG Creator Image2PPT

Use this skill to convert flat visual drafts into editable

.pptx

files. The core design is "first form a structured manifest, then generate PPTX via scripts."

Binary image input: Codex is responsible for identifying layout, text and components; it defaults to calling the
```
imagegen
```
skill to generate or clean component images such as backgrounds, decorations, products, charts, etc.; text is restored to PowerPoint text boxes as much as possible.
HTML/SVG input: Prioritize parsing code structures into native PPT elements; complex nodes are downgraded to image components.
All intermediate images, manifests, diagnostics and outputs must be placed in the
```
projects/YYYYMMDD_slug/
```
directory of this skill.

Codex Default Strategy

When processing binary images such as PNG/JPEG/WebP in Codex, the following sequence is executed by default:

Use Codex's visual capability to observe the source image, list objects such as slide size, background, title, body text, icons, photos, charts, decorations, shadows, masks, etc.
For editable text, directly write it into the
```
text
```
element of the manifest; do not only render text as images.
For backgrounds, photos, icons, complex illustrations, charts, textures, and backgrounds that need to be completed after occlusion, use the
```
imagegen
```
skill to generate, clean or rebuild independent component images.
Copy the images generated by
```
imagegen
```
to the
```
imagegen_assets/
```
or
```
component_images/
```
directory of the current project; do not let the project depend on temporary outputs from
```
$CODEX_HOME
```
.

Write

manifest.json

, then use

scripts/image2pptx.py build

to generate PPTX.

Verify that the PPTX can be reopened by
```
python-pptx
```
, and record the number of layers/text/images and known limitations.

If the user explicitly requests "no redrawing" or "retain original pixels", the original image can be cropped or used as a full-canvas transparent PNG as a component image; but by default, Codex imagegen capability should still be used to assist background cleaning, missing area completion and component purification.

Project Directory Convention

Create an independent project directory for each conversion:

text

bggg-creator-image2ppt/
└── projects/
    └── YYYYMMDD_slug/
        ├── original_inputs/
        ├── component_images/
        ├── imagegen_assets/
        ├── diagnostics/
        ├── manifest.json
        ├── output.pptx
        ├── summary.json
        └── process_notes.md

Initialization:

bash

python3 bggg-creator-image2ppt/scripts/init_project.py pitch_deck \
  --source /path/to/reference.png \
  --date 20260504

Binary Image to PPTX Workflow

Initialize the project and copy the source image to
```
original_inputs/
```
.
Identify page structure:
- Canvas ratio and approximate size.
- Whether the background is solid color, gradient, photo or complex illustration.
- Content, position, font size, color, weight, alignment of each text segment.
- Boundaries, hierarchy and whether transparent background is needed for component images.
Default to using
```
imagegen
```
to generate or edit components:
- Background: Complete canvas, no text, no foreground components.
- Photos/products/people/icons/complex decorations: Clean edges, transparent background if necessary.
- Charts: Reconstruct natively with shapes and text if possible; complex charts can be made into image components first.
Place component images into
```
component_images/
```
or
```
imagegen_assets/
```
.
Write the manifest, with elements sorted from bottom to top.

Run:

bash

python3 bggg-creator-image2ppt/scripts/image2pptx.py build \
  --manifest bggg-creator-image2ppt/projects/YYYYMMDD_slug/manifest.json \
  --output bggg-creator-image2ppt/projects/YYYYMMDD_slug/output.pptx \
  --summary bggg-creator-image2ppt/projects/YYYYMMDD_slug/summary.json

Write
```
process_notes.md
```
, indicating whether imagegen was used, which objects are editable text, and which objects are image fallbacks.

HTML/SVG to PPTX Workflow

When HTML/SVG is a code-form PPT, prioritize using the parser:

bash

python3 bggg-creator-image2ppt/scripts/html_svg_to_manifest.py input.svg \
  --output bggg-creator-image2ppt/projects/YYYYMMDD_slug/manifest.json

python3 bggg-creator-image2ppt/scripts/html_svg_to_manifest.py input.html \
  --output bggg-creator-image2ppt/projects/YYYYMMDD_slug/manifest.json

Parsing principles:

Natively restore
```
text
```
,
```
rect
```
,
```
ellipse
```
,
```
line
```
, and simple images.
```
.slide
```
/
```
body
```
elements with absolute positioning in HTML are easiest to convert accurately.
Complex SVG
```
path
```
, filters, gradients, mask, clip-path, foreignObject can be written into diagnostics, and use imagegen or external rendering results as image component fallbacks.
After the parsing script generates the manifest, still use
```
image2pptx.py build
```
to generate the final PPTX.

Manifest Format

The manifest is a cross-source intermediate layer. Coordinates are defaulted to source canvas pixels, and the script will map them to PowerPoint dimensions.

json

{
  "deck": {
    "canvas_width": 1600,
    "canvas_height": 900,
    "slide_width_in": 13.333,
    "name": "Example Deck"
  },
  "slides": [
    {
      "name": "Cover",
      "elements": [
        {
          "kind": "background",
          "fill": "#f7f4ec"
        },
        {
          "kind": "image",
          "name": "Hero Product",
          "file": "component_images/product.png",
          "x": 910,
          "y": 170,
          "w": 520,
          "h": 520,
          "fit": "contain"
        },
        {
          "kind": "text",
          "name": "Title",
          "text": "Walk With Intention",
          "x": 120,
          "y": 180,
          "w": 680,
          "h": 150,
          "font_size_px": 68,
          "font_family": "Arial",
          "bold": true,
          "color": "#17120d",
          "align": "left"
        }
      ]
    }
  ]
}

Common elements:

```
background
```
:
```
fill
```
for solid color or
```
file
```
for background image.

image

:

file

/

path

/

src

,

fit

.

fit

supports

stretch

,

contain

,

cover

.

text

:

text

,

font_size_px

or

font_size_pt

,

font_family

,

color

,

bold

,

italic

,

align

.

shape

:

shape

can be

rect

,

roundRect

,

ellipse

or

line

; supports

fill

,

stroke

,

stroke_width_px

.

```
table
```
: Simple table fallback, use
```
rows
```
array to generate native PPT tables.

Editability Priority

Text boxes: Titles, body text, page numbers, labels, button text are prioritized to be converted into native PPT text.
Basic shapes: Rectangles, rounded rectangles, circles, lines are prioritized to be converted into PPT shapes.
Image components: Photos, illustrations, icons, textures, complex charts as independent image layers.
Full-page background fallback: If it cannot be split cleanly, a base image can be retained, then key text and components are overlaid as editable objects, and limitations are clearly stated.

Output Requirements

At least explain the following when delivering:

Project directory path.
PPTX path.
Manifest and summary paths.
Number of editable text boxes, image components, shapes.
Which components were generated or cleaned by Codex imagegen.
Which complex objects were downgraded to image fallbacks.

bggg-creator-image2ppt

NPX Install

Tags

SKILL.md Content (Chinese)

BGGG Creator Image2PPT

Codex Default Strategy

Project Directory Convention

Binary Image to PPTX Workflow

HTML/SVG to PPTX Workflow

Manifest Format

Editability Priority

Output Requirements