# Nature Image2ppt

Reconstruct slide images, screenshots, scanned PDFs, or image-only PPTX files as...

- Repository: https://github.com/Yuan1z0825/nature-skills (51695 stars)
- Category: Documents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Yuan1z0825/nature-skills --skill nature-image2ppt -g -a claude-code -y`
Codex: `npx skills add Yuan1z0825/nature-skills --skill nature-image2ppt -g -a codex -y`
Cursor: `npx skills add Yuan1z0825/nature-skills --skill nature-image2ppt -g -a cursor -y`
Gemini CLI: `npx skills add Yuan1z0825/nature-skills --skill nature-image2ppt -g -a gemini-cli -y`

## Description

Reconstruct slide images, screenshots, scanned PDFs, or image-only PPTX files as object-level editable PowerPoint. Use for 图片转可编辑PPT、截图还原PPT and diagram reconstruction; not authoring a new deck from research notes.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Nature Image2PPT

Use this directory as the complete runtime. Run deterministic actions only through:

```bash
python <image2ppt-root>/cli/image2ppt/cli.py <command> ...
```

Use Python 3.10 or later with `requirements.txt` installed. When a dedicated
environment exists, substitute `<image2ppt-root>/.venv/bin/python` on macOS/Linux
or `<image2ppt-root>/.venv/Scripts/python.exe` on Windows for every `python`
command below. Do not continue after a failed `doctor`; install only the reported
missing dependency, then rerun it.

Do not discover or invoke another Skill, CLI, Prompt, Schema, module, or state machine.

## Read the local contracts progressively

Always read `references/workflow.md`. Read `references/runtime-dependencies.md`
only for setup or `doctor` failures, and read
`references/ocr-text-hints-contract.md` only when choosing or troubleshooting OCR.

Before writing a page manifest, read `references/page-decision-tree.md` and
`references/manifest-schema.md`. Add only the references needed by that page:

- structured or compound page: `references/region-decomposition.md` and
  `references/object-routing.md`;
- arrows: `references/manifest-arrow-extension.md`;
- raster assets or image-backend work: `references/assets-provenance-contract.md`.

Before accepting or delivering output, read `references/qa-contract.md`.

## Preserve the single source of truth

The rest: https://github.com/Yuan1z0825/nature-skills/blob/HEAD/skills/nature-image2ppt/SKILL.md