Agent skill

Ppt Image First

by NyxTides in NyxTides/ppt-image-first

Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs.

Apache-2.0Auto-check passedDocuments & Office

Install Ppt Image First

skills CLI
$ npx skills add NyxTides/ppt-image-first --skill ppt-image-first -a claude-code

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

GitHub CLI
$ gh skill install NyxTides/ppt-image-first ppt-image-first --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

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

Facts

Skill name
ppt-image-first
GitHub stars
1.2k
Token cost
~1.6k tokens
SKILL.md length
753 words
Files
28 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs.

  • Works in 5 steps: Intake: clarify lightly, identify… → Content basis: create or extract… → Style preview: align style boundaries,… → …
  • The user asks to create a PPT
  • SKILL.md covers I/O Contract, Workflow Phases, Progressive Loading and Working Principles, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Ppt Image First is an agent skill from NyxTides/ppt-image-first. Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs. Use when the user asks to create a PPT, presentation, deck, 答辩稿, 路演 deck, 产品介绍 PPT, 汇报 PPT, or when the user has only a topic or rough materials and needs help clarifying structure, style, and page planning before generation.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 34 other files, including scripts, reference files and assets (for example `README.en.md`, `README.md` and `assets/candidate_picker_shell/build_candidate_picker_html.py`).

It sits in Documents & Office, covering Slides and decks and PowerPoint presentations. It works with Microsoft PowerPoint. The repository describes itself as: PPT image-first skill for Codex/Claude Code/Opencode CLI. The licence is Apache-2.0.

When your agent uses it

  • The user asks to create a PPT
  • The user has only a topic
  • Rough materials and needs help clarifying structure
  • Page planning before generation

Example prompts

  • “/ppt-image-first”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Intake: clarify lightly, identify anchors, output a short baseline judgment, then get 需求确认.
  2. Content basis: create or extract content_report.md unless the user already supplied complete report-like content; show a synthesized…
  3. Style preview: align style boundaries, propose directions, generate 首页 / 目录页 / 正文页 previews for each direction, support refinement, then…
  4. Planning lock: run 风格反演确认, then write design_spec.md, slide_blueprint.md, and spec_lock.md in that order; summarize and get 生成前确认.
  5. Generation review: generate page visuals, optionally run candidate selection, open the review HTML, retouch as needed, and export the…

What it can do on your machine

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

    Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.

    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

Ppt Image First loads about 1.6k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 104 tokens; SKILL.md has 753 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~104
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from NyxTides/ppt-image-first at commit 87a300a, republished under its Apache-2.0 licence (© NyxTides). 753 words, ~1,580 tokens.

Download SKILL.mdSave it as .claude/skills/ppt-image-first/SKILL.md (or your agent's skills folder). This skill also uses 27 other files; get the full folder from GitHub.
name
ppt-image-first
description
Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs. Use when the user asks to create a PPT, presentation, deck, 答辩稿, 路演 deck, 产品介绍 PPT, 汇报 PPT, or when the user has only a topic or rough materials and needs help clarifying structure, style, and page planning before generation.

PPT Image First

Use this skill to turn a vague PPT request into a generation-ready, image-first deck plan.

I/O Contract

  • Input: a PPT topic, rough goal, existing notes/materials, or complete report-like narrative.
  • Optional anchors: audience, page count or duration, school/company/lab/course/brand identity, use occasion, source files, and style constraints.
  • Output: a confirmed content basis, visual style previews, deck specs, generated page visuals, review surface, and final PPT after approval.
  • Confirmation gates: 需求确认, 风格确认, 生成前确认, and final review approval.
  • Default ratio: generate preview images and final page visuals in 16:9 unless the user explicitly requests another ratio.

Workflow Phases

Follow these phases in order and do not skip the confirmation gates:

  1. Intake: clarify lightly, identify anchors, output a short baseline judgment, then get 需求确认.
  2. Content basis: create or extract content_report.md unless the user already supplied complete report-like content; show a synthesized judgment, not the raw file by default.
  3. Style preview: align style boundaries, propose directions, generate 首页 / 目录页 / 正文页 previews for each direction, support refinement, then get 风格确认.
  4. Planning lock: run 风格反演确认, then write design_spec.md, slide_blueprint.md, and spec_lock.md in that order; summarize and get 生成前确认.
  5. Generation review: generate page visuals, optionally run candidate selection, open the review HTML, retouch as needed, and export the final PPT only after approval.

Read references/workflow.md for stage-by-stage execution details.

Progressive Loading

  • Intake and baseline: read references/conversation_framework.md only when you need the conversation-first intake pattern.
  • Style proposals: read references/style-system.md when producing proposal cards or interpreting V1-V8 internally.
  • Preview/review UI: read references/preview-flow.md before producing style previews, candidate-picker pages, or review pages.
  • Content basis: read templates/content_report_reference.md before writing content_report.md.
  • Planning files: read templates/design_spec_reference.md, templates/slide_blueprint_reference.md, and templates/spec_lock_reference.md immediately before writing those files.

Working Principles

  • Treat the user like a client and yourself like the proposing design agent.
  • Do not force the user to configure design parameters manually; translate their natural-language intent into design decisions.
  • Ask for real-world identity anchors when relevant, but treat them as grounding context rather than style questions.
  • Keep intake lightweight; do not turn content basis or style alignment into a long questionnaire.
  • Use style vectors internally, but present front-stage options as concise proposal cards plus image previews.
  • Use the content basis for previews and planning rather than generic placeholder structures.
  • Mark inferred claims carefully; do not present unsupported precise data, experiment results, citations, or institutional conclusions as user-provided facts.
  • Show summaries, proposal cards, previews, and review surfaces by default; show raw planning files only when useful or requested.
Show full SKILL.md (346 more words)Show less

Hard Rules

  • Preview-first: final style confirmation should be based on generated 首页 / 目录页 / 正文页 previews, not text-only choices.
  • Shells are mandatory: use assets/preview_shell/index.html, assets/candidate_picker_shell/index.html, and assets/review_shell/index.html as the base UIs for their stages.
  • Open the local preview, candidate-picker, review, and final PPT files immediately when those stages produce them; if opening fails, state the blocker and provide the path.
  • Do not write slide_blueprint.md before style direction and 风格反演确认 are complete.
  • Keep generation image-first when the confirmed direction depends on generated page visuals; do not silently fall back to shape-by-shape PPT construction or hand-drawn code substitutes.
  • User-requested edits such as adding, replacing, correcting, or supplementing visible text are still image-generation/editing tasks by default. Do not use PIL, Pillow, canvas, SVG, HTML screenshots, PPT native text boxes, or deterministic overlays to patch final page visuals unless the user explicitly asks for a code/PPT-overlay workaround.
  • Treat generated page visuals as complete by default; post-generation overlays default to zero unless they are traceable to approved blueprint fields.
  • Keep slide identifiers, candidate codes, filenames, and generation batch labels outside the image-generation prompt body. They may appear in planning files, filenames, mapping tables, review UI, and chat instructions, but the prompt sent to the image model should contain only audience-facing content and visual direction.
  • Review payloads should carry lightweight coordinate markup, not base64 preview images. When a user pastes review JSON with markup, first render the marked review images locally with scripts/render_review_markup.py, then use the marked images plus separate text comments as the retouch/regeneration reference.
  • Before full generation, ask whether the user wants one final image per slide or multiple final candidates per slide.
  • Do not export the final PPT immediately after first-pass generation; export only after the reviewed pages are approved.

Output Hierarchy

Use these layers consistently:

  • content_report.md = upstream content basis when the user did not provide complete report-like material.
  • design_spec.md = global deck rationale and confirmed visual system.
  • slide_blueprint.md = page-by-page intent and content plan.
  • spec_lock.md = execution constraints and final generation guardrails.

content_report.md supports the 3 core planning files; it does not replace them. spec_lock.md is always the last core planning file.

© NyxTides, 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

SKILL.md and 27 other files (scripts, references, assets) in the repository root of NyxTides/ppt-image-first.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.en.md
  • README.md
  • assets/candidate_picker_shell/build_candidate_picker_html.py
  • assets/candidate_picker_shell/index.html
  • assets/preview_shell/build_preview_html.py
  • assets/preview_shell/index.html
  • assets/review_shell/build_review_html.py
  • assets/review_shell/index.html
  • docs/demo/ppt-image-first-demo-deck.pptx
  • docs/images/sample-meteorology-defense-deck.png
  • docs/images/sample-red-campus-deck.png
  • … and 14 more

Open the folder on GitHubat commit 87a300a

Compare with similar skills

Ppt Image First 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.

Ppt Image First compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ppt Image First this skillNyxTides/ppt-image-first1.2k—~1.6kAutomated safety check: PassApache-2.0
Image To Editable Pptningzimu/image-to-editable-ppt-skill2.8k—~4.3kAutomated safety check: PassMIT
Slidesfcakyon/claude-codex-settings1.2k1 repos~1.1kAutomated safety check: PassMIT
Gpt Image2 PptJuneYaooo/gpt-image2-ppt-skills1.3k—~8.9kAutomated safety check: NotesApache-2.0
HTML Slide To PPTXmucsbr/ppt-agent-workflow-san643—~1.1kAutomated safety check: PassNone
Paper Deckzsyggg/paper-craft-skills1.3k—~1.4kAutomated safety check: PassNone

Similar skills

  • 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.8k GitHub stars~4.3k tokensUpdated 21 days ago
    Documents & OfficeAuto-check passed
  • Slides

    fcakyon/claude-codex-settings

    Create and edit presentation slide decks (.pptx) with PptxGenJS, bundled layout helpers, and render/validation utilities.

    1.2k GitHub starsUsed in 1 repo~1.1k tokens
    Documents & OfficeAuto-check passed
  • Gpt Image2 Ppt

    JuneYaooo/gpt-image2-ppt-skills

    Generate visually striking PPT slides via OpenAI's gpt-image-2 -- use any style in styles/<collection/STYLEID.md or mimic a user-supplied .pptx template; outputs high-res slide PNGs and a 16:9 .pptx.

    1.3k GitHub stars~8.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • HTML Slide To PPTX

    mucsbr/ppt-agent-workflow-san

    Convert structured single-slide or small deck HTML files into editable PPTX slides with native text boxes, shapes, chips, arrows, and panels.

    643 GitHub stars~1.1k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Paper Deck

    zsyggg/paper-craft-skills

    将论文、技术文章或知识内容制作成高真实感的 AIGC 幻灯片。先做叙事结构和逐页视觉导演,再调用生图模型生成每一页 16:9 slide image,最后合成为 PPTX/PDF。适合论文汇报、组会、公开课、技术分享、商业化研究展示;当用户提到“论文PPT”“AI生成PPT”“不像AI的PPT”“高质感幻灯片”“逐页生图PPT”时使用。

    1.3k GitHub stars~1.4k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • Ppt Agent

    sunbigfly/ppt-agent-skills

    专业 PPT 演示文稿全流程 AI 生成助手。模拟顶级 PPT 设计公司的完整工作流(需求调研到资料搜集到大纲策划到策划稿到设计稿),输出高质量 HTML 格式演示文稿。当用户提到制作 PPT、做演示文稿、做 slides、做幻灯片、做汇报材料、做培训课件、做路演 deck、做产品介绍页面时触发此技能。即使用户只说"帮我做个关于 X 的介绍"或"我要给老板汇报…

    905 GitHub stars~5.6k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed

Questions about Ppt Image First

What does Ppt Image First do?

Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs. Ppt Image First is an agent skill from NyxTides/ppt-image-first. Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs.

When should I use Ppt Image First?

Ppt Image First fits situations like: the user asks to create a PPT; the user has only a topic; rough materials and needs help clarifying structure; page planning before generation.

How do I install Ppt Image First in Claude Code?

Run `npx skills add NyxTides/ppt-image-first --skill ppt-image-first -a claude-code`. Or copy the skill folder (the NyxTides/ppt-image-first repository) into .claude/skills/ppt-image-first in your project. Claude Code loads it when a task matches its description.

How do I install Ppt Image First in Codex?

Run `npx skills add NyxTides/ppt-image-first --skill ppt-image-first -a codex`. Or copy the skill folder (the NyxTides/ppt-image-first repository) into .agents/skills/ppt-image-first in your project. Codex loads it when a task matches its description.

Can I use Ppt Image First 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 NyxTides/ppt-image-first --skill ppt-image-first -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ppt-image-first, .gemini/skills/ppt-image-first, .github/skills/ppt-image-first and .opencode/skills/ppt-image-first in your project.

What does Ppt Image First need to run?

Going by SKILL.md and its folder, Ppt Image First needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Ppt Image First 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 Ppt Image First 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ppt Image First use?

Ppt Image First is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ppt Image First use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Ppt Image First?

Skills that share tags, products or a category with Ppt Image First: Image To Editable Ppt (ningzimu/image-to-editable-ppt-skill, 2.8k stars), Slides (fcakyon/claude-codex-settings, 1.2k stars), Gpt Image2 Ppt (JuneYaooo/gpt-image2-ppt-skills, 1.3k stars) and HTML Slide To PPTX (mucsbr/ppt-agent-workflow-san, 643 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ppt Image First?

NyxTides (a GitHub user) maintains it in NyxTides/ppt-image-first, which has 1,223 GitHub stars. The repository was last updated on May 8, 2026.

Source: NyxTides/ppt-image-first on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.