Agent skill

Slides Grab Image

by NomaDamas in NomaDamas/slides-grab

Image-native presentation pipeline usable in Codex and Claude Code.

MITAuto-check passedDocuments & Office

Install Slides Grab Image

skills CLI
$ npx skills add NomaDamas/slides-grab --skill slides-grab-image -a claude-code

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

GitHub CLI
$ gh skill install NomaDamas/slides-grab slides-grab-image --agent claude-code

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

Manual copy
$ git clone --depth 1 https://github.com/NomaDamas/slides-grab.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/slides-grab-image .claude/skills/slides-grab-image && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

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

Facts

Skill name
slides-grab-image
GitHub stars
1.2k
Token cost
~2.1k tokens
SKILL.md length
976 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Image-native presentation pipeline usable in Codex and Claude Code.

  • Works in 3 steps: Plan (template-driven dense outline) → Design (per-slide image generation) → Export
  • Visual fidelity to an existing template matters more than editable text
  • SKILL.md covers Mode signal, Core rule: reference-guided…, Prompt structure (use this… and Workflow, plus 2 more sections
  • Calls pdftoppm and codex; needs OPENAI_API_KEY and GOOGLE_API_KEY

What it does

Slides Grab Image is an agent skill from NomaDamas/slides-grab. Image-native presentation pipeline usable in Codex and Claude Code. Generate whole-slide raster images one slide at a time with slides-grab image, passing the reference template page as --reference so the model copies the layout and style and only swaps the content. Use when visual fidelity to an existing template matters more than editable text.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Slides and decks. The repository describes itself as: Best harness + editor + linter for generating slides in Claude Code / Codex - Claude Design Open Source Alternative. The licence is MIT.

When your agent uses it

  • Visual fidelity to an existing template matters more than editable text
  • Tasks that involve Slides and decks

Example prompts

  • “/slides-grab-image”

Requirements

  • A credential in OPENAI_API_KEY
  • A credential in GOOGLE_API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Plan (template-driven dense outline)
  2. Design (per-slide image generation)
  3. Export

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • pdftoppm
    • codex

    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 these keys or tokens, usually read from environment variables:

    • OPENAI_API_KEY
    • GOOGLE_API_KEY
    • GEMINI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Slides Grab Image loads about 2.1k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 976 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from NomaDamas/slides-grab at commit 49bdaed, republished under its MIT licence (© NomaDamas). 976 words, ~2,124 tokens.

Download SKILL.mdSave it as .claude/skills/slides-grab-image/SKILL.md (or your agent's skills folder).
name
slides-grab-image
description
Image-native presentation pipeline usable in Codex and Claude Code. Generate whole-slide raster images one slide at a time with slides-grab image, passing the reference template page as --reference so the model copies the layout and style and only swaps the content. Use when visual fidelity to an existing template matters more than editable text.
metadata.short-description
Image-native pipeline — per-slide raster generation with template reference

slides-grab Image Skill

Generate whole-slide raster images where the generated PNG is the slide. Each slide is generated individually with slides-grab image, passing the matching reference template page image(s) via --reference so the model reproduces the template's layout, colors, fonts, and density — only swapping in the new slide's content. Use this pipeline when the user wants to match an existing corporate template, filled deck, or brand form visually.

Mode signal

The plan stage records mode: image-native in slide-outline.md. The user typically provides a reference template (PPTX, PDF, HTML examples) and says "make slides in this form."

Core rule: reference-guided per-slide generation

  • Generate one slide at a time with slides-grab image. Do NOT use slides-grab generate-images (the batch command auto-assembles garbage prompts from markdown and produces inconsistent output).
  • Always pass at least one reference template page image via --reference <path> (repeatable). The reference page(s) must be the same slide-type (cover, content, closing) from the source template. The model must copy the reference's layout, color bands, typography hierarchy, whitespace, and density — only the text content and any embedded photos change.
  • The prompt must explicitly instruct: "Follow the reference image's layout, composition, color palette, and typography hierarchy exactly. Keep the same band positions, spacing, and visual rhythm. Only replace the text content and photos with the new slide's content below."
  • Pass any real photos/assets to embed as additional --reference images so the model can place them into the template layout.

Prompt structure (use this pattern)

slides-grab image \
  --prompt "Follow the reference image layout exactly — same color bands, same typography hierarchy, same spacing and density. This is a [cover/content/closing] slide. Replace the text with: Title: '<new title>'. Body: '<new body text>'. Bullets: <bullet list>. Keep the template's visual style, fonts, and color palette. Render all text sharp and legible. 16:9, 720pt × 405pt." \
  --slides-dir <path> \
  --reference <template-page-cover.png> \
  --reference <real-photo-to-embed.png>

Key prompt principles:

  • Describe the content to inject, not the visual design — the reference image defines the design.
  • Name the slide type (cover, content, closing, stat) so the model picks the right reference density.
  • List the exact title, body, and bullets as literal strings the model should render.
  • If embedding real photos, name them in the prompt ("place photo-1 in the left grid cell") and pass them as --reference.
  • Require sharp, legible, correctly spelled text.

Workflow

Stage 1 — Plan (template-driven dense outline)

Use the installed slides-grab-plan skill with image-native outline density rules.

  1. Take topic, audience, and tone.
  2. If the user provides a reference template/PDF/PPTX, import it with slides-grab import-template --input <path>. Also render the template pages to PNG (e.g. pdftoppm -png -r 150 <input>.pdf <prefix>) and store under <slides-dir>/.slides-grab/template-previews/. These page renders are the --reference images for Stage 2.
  3. Read the template pages in order (page-01, page-02, ...). For each page, identify its layout type and information density — how many text blocks, data points, bullets, captions, and visual elements it carries. This is the critical step: the outline must match the template's per-slide density, not write a thin HTML-style summary.
  4. Write a dense outline: one outline slide per template page, carrying the full content the user wants — titles, subtitles, body paragraphs, full bullet lists, stat values, table data, captions, and image placement notes — at the volume the template page demonstrates. Image-native slides are single rasters with no HTML structure limits, so they hold more text and data per slide than semantic HTML. Do not under-fill.
  5. Tag each outline slide with template-page: NN so Stage 2 knows which reference image to pass.
  6. Record mode: image-native and style: template-pack in slide-outline.md meta.
  7. Present outline, revise until approved.
Show full SKILL.md (443 more words)Show less
Stage 2 — Design (per-slide image generation)
  1. Read approved slide-outline.md. For each slide, read its template-page: NN tag and pick that exact template page render from .slides-grab/template-previews/page-NN.png as the primary --reference. If the slide has no tag, pick 1–2 layout-similar pages by slide type (cover, content, stat, closing).
  2. For each slide, run slides-grab image with:
    • --prompt containing ALL the content from the outline for that slide — the full title, subtitle, body paragraphs, every bullet, every stat value, every caption — not a summary. Precede the content with "Follow the reference image layout exactly — same color bands, same typography hierarchy, same spacing and density. Only replace the text content with the content below."
    • --reference pointing to the matching template page render(s)
    • --reference for any real photos to embed (member photos, product shots, logos)
    • --slides-dir <path> and --name slide-XX (so the output is assets/slide-XX.png)
    • --image-native so the command also writes the editor-compatible slide-XX.html wrapper and .slides-grab/image-native/slide-XX.json regeneration metadata
    • --provider codex (default; reuses ~/.codex/auth.json, run codex login once, no API key). Alternatives: --provider openai (OPENAI_API_KEY, gpt-image-2), --provider nano-banana (GOOGLE_API_KEY/GEMINI_API_KEY).
  3. Confirm each command reports Created image-native slide wrapper: slide-XX.html. Do not hand-write the wrapper; --image-native keeps the PNG, wrapper, and regeneration metadata contract aligned for slides-grab edit-image.
  4. Run slides-grab validate --slides-dir <path>. Auto-fix failures until it passes.
  5. Run the design gate (../slides-grab-design/references/design-gate.md): capture PNG evidence, run Pass A + Pass B, synthesize verdict. Resolve all Critical findings, re-generate the failing slide, re-render, re-review until Proceed. Record with slides-grab design-gate --slides-dir <path> --verdict proceed --pass-a-report <a.md> --pass-b-report <b.md>.
  6. For revisions, regenerate the specific slide with slides-grab image (same --reference, adjusted --prompt), or launch the image-native editor with slides-grab edit-image --slides-dir <path>.
Stage 3 — Export

Use the installed slides-grab-export skill. Requires a fresh Proceed gate receipt.

  1. Widescreen → slides-grab pdf --slides-dir <path> --output <name>.pdf.
  2. Per-slide PNG → slides-grab png --slides-dir <path> --output-dir <path>/out-png --resolution 2160p.
  3. PPTX/Figma (experimental / unstable) → slides-grab convert / slides-grab figma.

Rules

  • Keep slide size 720pt × 405pt (16:9).
  • Always pass --reference template page images — never generate image-native slides from a text-only prompt. The reference defines the visual design; the prompt defines the content.
  • Generate one slide at a time with slides-grab image. Do not use slides-grab generate-images.
  • slides-grab image --image-native --name slide-XX writes the wrapper and regeneration metadata. Do not hand-write semantic text into wrapper slides.
  • Put generated assets under <slides-dir>/assets/, reference as ./assets/<file>.
  • Allow data: URLs when a slide must be self-contained; never leave remote http(s):// image URLs in saved HTML.
  • Do not present slides for review until slides-grab validate passes.
  • Do not advance to export while any Critical design-gate finding is unresolved.

Reference

  • ../slides-grab-plan/SKILL.md and ../slides-grab-plan/references/
  • ../slides-grab-design/SKILL.md and ../slides-grab-design/references/
  • ../slides-grab-export/SKILL.md and ../slides-grab-export/references/

© NomaDamas, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/slides-grab-image of NomaDamas/slides-grab.

Open the folder on GitHubat commit 49bdaed

Compare with similar skills

Slides Grab Image 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.

Slides Grab Image compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Slides Grab Image this skillNomaDamas/slides-grab1.2k—~2.1kAutomated safety check: PassMIT
Image To Editable Pptningzimu/image-to-editable-ppt-skill2.9k—~4.3kAutomated safety check: PassMIT
Slidesfcakyon/claude-codex-settings1.2k1 repos~1.1kAutomated safety check: PassMIT
Ppt Image FirstNyxTides/ppt-image-first1.2k—~1.6kAutomated safety check: PassApache-2.0
Vibe to Agentic Engineering Frameworkshanraisshan/claude-code-best-practice67k—~3.3kAutomated safety check: PassMIT
Gpt Image2 PptJuneYaooo/gpt-image2-ppt-skills1.3k—~8.9kAutomated safety check: NotesApache-2.0

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.9k GitHub stars~4.3k tokensUpdated 24 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
  • Ppt Image First

    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.

    1.2k GitHub stars~1.6k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Vibe to Agentic Engineering Framework

    shanraisshan/claude-code-best-practice

    Explains the conceptual model behind a presentation on moving from unstructured vibe coding to fully configured agentic engineering, including its 4-level scoring system and slide conventions.

    67k GitHub stars~3.3k tokensUpdated today
    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
  • Compiledeck

    scunning1975/MixtapeTools

    Create and compile beautiful Beamer presentations following the Rhetoric of Decks philosophy.

    474 GitHub starsUsed in 2 repos~3.1k tokens
    Documents & OfficeAuto-check passed

More from NomaDamas/slides-grab

  • Slides Grab HTML

    NomaDamas/slides-grab

    HTML-mode presentation pipeline usable in Codex and Claude Code.

    1.2k GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed
  • Slides Grab

    NomaDamas/slides-grab

    End-to-end presentation workflow usable in Codex and Claude Code.

    1.2k GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed
  • Slides Grab Design

    NomaDamas/slides-grab

    Stage 2 design skill usable in Codex and Claude Code. An agent skill from NomaDamas/slides-grab.

    1.2k GitHub stars~3.7k tokensUpdated 8 days ago
    Auto-check passed
  • Slides Grab Export

    NomaDamas/slides-grab

    Stage 3 conversion skill usable in Codex and Claude Code. An agent skill from NomaDamas/slides-grab.

    1.2k GitHub stars~1k tokensUpdated 8 days ago
    Auto-check passed
  • Slides Grab Plan

    NomaDamas/slides-grab

    Stage 1 planning skill usable in Codex and Claude Code. An agent skill from NomaDamas/slides-grab.

    1.2k GitHub stars~1.8k tokensUpdated 8 days ago
    Auto-check passed
  • Slides Grab Card News

    NomaDamas/slides-grab

    Generate square Instagram-style card news by reusing the slides-grab workflow with card-news mode enabled.

    1.2k GitHub stars~532 tokensUpdated 8 days ago
    Auto-check passed

Questions about Slides Grab Image

What does Slides Grab Image do?

Image-native presentation pipeline usable in Codex and Claude Code. Slides Grab Image is an agent skill from NomaDamas/slides-grab. Image-native presentation pipeline usable in Codex and Claude Code.

When should I use Slides Grab Image?

Slides Grab Image fits situations like: visual fidelity to an existing template matters more than editable text; tasks that involve Slides and decks.

How do I install Slides Grab Image in Claude Code?

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

How do I install Slides Grab Image in Codex?

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

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

What does Slides Grab Image need to run?

Going by SKILL.md and its folder, Slides Grab Image needs the command-line tools its instructions call (pdftoppm and codex) and credentials named OPENAI_API_KEY, GOOGLE_API_KEY and GEMINI_API_KEY. Our summary lists: A credential in OPENAI_API_KEY; A credential in GOOGLE_API_KEY.

Does Slides Grab Image 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 Slides Grab Image 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. Review the folder before installing.

What licence does Slides Grab Image use?

Slides Grab Image is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Slides Grab Image use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Slides Grab Image?

Skills that share tags, products or a category with Slides Grab Image: Image To Editable Ppt (ningzimu/image-to-editable-ppt-skill, 2.9k stars), Slides (fcakyon/claude-codex-settings, 1.2k stars), Ppt Image First (NyxTides/ppt-image-first, 1.2k stars) and Vibe to Agentic Engineering Framework (shanraisshan/claude-code-best-practice, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Slides Grab Image?

NomaDamas (a GitHub organization) maintains it in NomaDamas/slides-grab, which has 1,213 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 1, 2026.

Source: NomaDamas/slides-grab on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.