Agent skill

Q-Presentations Slide Deck Generator

by TyrealQ in TyrealQ/q-skills

Generates branded slide deck images from written content, with a content analysis step, a layout catalog and scripts that merge the slides into PowerPoint or PDF.

MITAuto-check passedDocuments & Office

Install Q-Presentations Slide Deck Generator

skills CLI
$ npx skills add TyrealQ/q-skills --skill q-presentations -a claude-code

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

GitHub CLI
$ gh skill install TyrealQ/q-skills q-presentations --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/TyrealQ/q-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/q-presentations .claude/skills/q-presentations && 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
q-presentations
GitHub stars
108
Token cost
~1.1k tokens
SKILL.md length
418 words
Files
45 (incl. scripts, references, assets)
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Generates branded slide deck images from written content, with a content analysis step, a layout catalog and scripts that merge the slides into PowerPoint or PDF.

  • Works in 2 steps: Determine this SKILL.md file's directory… → Script path = ${SKILL_DIR}/scripts/.
  • Turning written content into a branded slide deck
  • SKILL.md covers Script Directory, Dependencies, References and Core Principles, plus 5 more sections
  • Calls pip and npx; needs OPENAI_API_KEY and GEMINI_API_KEY

What it does

Built on the baoyu-slide-deck project, this skill turns written content into a sequence of slide images rather than a traditional template-based deck. A bundled script generates each slide image through GPT Image 2 by default, needing an OPENAI_API_KEY, or through Gemini's image model with a GEMINI_API_KEY, after which another script overlays a Dr. Q logo and Bun-based TypeScript scripts merge the images into a PowerPoint file or a PDF.

Its reference files cover a content analysis framework, an outline template, design guidelines for audience, typography and color, a layout catalog with an overlay-safe policy and fallback rules, a base image-generation prompt, preset-to-dimension mappings and per-style specifications, plus a schema for saved preferences. Core principles state that each slide should be self-explanatory for reading as well as presenting, that the flow stay clear when scrolled through, and that style stay consistent across the whole deck. In plan mode the skill only writes a short plan and exits, deferring the actual analysis, image generation and file merging until plan mode ends.

When your agent uses it

  • Turning written content into a branded slide deck
  • Generating slide images for a deck that should read well on its own
  • Merging a set of generated slide images into a PowerPoint or PDF file

Example prompts

  • “Turn this research summary into a 10-slide deck with the Dr. Q logo and export it as a PDF.”
  • “Generate slide images for this outline using Gemini instead of GPT Image 2.”
  • “Modify slide 4 of the deck to add the new chart and re-merge into PowerPoint.”

Requirements

  • Python with openai, google-genai, Pillow and python-dotenv
  • Bun runtime (Node.js 18+)
  • An OPENAI_API_KEY or GEMINI_API_KEY depending on the image model

Workflow steps

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

  1. Determine this SKILL.md file's directory path as SKILL_DIR.
  2. Script path = ${SKILL_DIR}/scripts/.

What it can do on your machine

Read from SKILL.md and the folder at commit d8aaee7. 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/, which the agent can run.

    Shell commands in SKILL.md call:

    • pip
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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
    • GEMINI_API_KEY

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

Context cost

Q-Presentations Slide Deck Generator loads about 1.1k tokens when it runs, and up to ~26k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 418 words of instructions outside code blocks.

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

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 TyrealQ/q-skills at commit d8aaee7, republished under its MIT licence (© TyrealQ). 418 words, ~1,134 tokens.

Download SKILL.mdSave it as .claude/skills/q-presentations/SKILL.md (or your agent's skills folder). This skill also uses 44 other files; get the full folder from GitHub.
name
q-presentations
description
Generate professional slide deck images from content with smart logo branding. Use for creating slides, presentations, decks, or PPT output.

Q-Presentations

Generate slide deck images from content with layout-driven overlay safety and smart logo branding. Built on baoyu-slide-deck.

If in plan mode: write a brief plan — "Run q-presentations skill: analyze content, confirm style/audience preferences, generate outline and prompts, generate slide images, overlay logo, merge to PPTX/PDF." — then exit plan mode immediately. Do NOT attempt content analysis, image generation, or file merging while plan mode is active.

Script Directory

Agent execution instructions:

  1. Determine this SKILL.md file's directory path as SKILL_DIR.
  2. Script path = ${SKILL_DIR}/scripts/<script-name>.
ScriptPurpose
scripts/gen_slide.pyGenerate slide images via GPT Image 2 (default) or Gemini
scripts/overlay_logo.pyApply Dr. Q logo overlay
scripts/merge-to-pptx.tsMerge slides into PowerPoint (Bun/TS)
scripts/merge-to-pdf.tsMerge slides into PDF (Bun/TS)

Dependencies

Install: pip install openai google-genai Pillow python-dotenv | Bun runtime (via npx -y bun, Node.js 18+).

Default image model is gpt-image-2 (requires OPENAI_API_KEY). Set IMAGE_MODEL=gemini or pass --model gemini to gen_slide.py to use gemini-3-pro-image-preview (requires GEMINI_API_KEY).

References

  • references/options.md — CLI options, usage examples, and partial workflows
  • references/workflow_detailed.md — full 10-step workflow with substeps and commands
  • references/analysis-framework.md — content analysis for presentations
  • references/outline-template.md — outline structure and format
  • references/modification-guide.md — edit, add, delete slide workflows
  • references/content-rules.md — content and style guidelines
  • references/design-guidelines.md — audience, typography, colors, visual elements
  • references/layouts.md — layout catalog, overlay-safe policy, fallback rules
  • references/base-prompt.md — base prompt for image generation
  • references/dimensions/presets.md — preset-to-dimension mapping
  • references/styles/*.md — per-style specifications
  • references/config/preferences-schema.md — EXTEND.md structure

Core Principles

  • Each slide self-explanatory (designed for reading and sharing, not only presenting)
  • Flow clear in scroll view; context present on each slide
  • Consistent style across the full deck
  • Never include photorealistic images of prominent individuals
  • Never include placeholder slides for author/date metadata
Show full SKILL.md (158 more words)Show less

Style System

16 presets available (default: blueprint). Full specs in references/dimensions/presets.md and references/styles/*.md.

Workflow

Full step details: references/workflow_detailed.md

StepActionKey references
0Skill announcement—
1Analyze content, load EXTEND.md preferencesreferences/analysis-framework.md, references/config/preferences-schema.md
2Confirm style, audience, video overlay, logoreferences/options.md
3Generate outline with layout selectionreferences/outline-template.md, references/layouts.md
4Review outline (conditional)—
5Generate per-slide promptsreferences/base-prompt.md, references/content-rules.md
6Review prompts (conditional)—
7Generate slide imagesscripts/gen_slide.py
7.5Logo overlayscripts/overlay_logo.py
8Merge to PPTX/PDFscripts/merge-to-pptx.ts, scripts/merge-to-pdf.ts
9Output summary—

For editing existing decks: references/modification-guide.md. For audience and visual hierarchy: references/design-guidelines.md.

File Management

Output directory: slide-deck/{topic-slug}/ containing source-{slug}.{ext}, outline.md, prompts/ (numbered .md files), numbered slide .png files, {topic-slug}.pptx, and {topic-slug}.pdf.

Language Handling

Detection priority: --lang flag > EXTEND.md > user conversation language > source content language. All user-facing responses use the user's preferred language; technical names remain in English.

Scope

Include: Slide deck generation from content with logo branding and video-overlay-aware layouts. Exclude: Slide editing in PowerPoint, animation, speaker notes.

© TyrealQ, MIT. 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 44 other files (scripts, references, assets) in skills/q-presentations of TyrealQ/q-skills.

  • SKILL.md
  • assets/Logo_Q.png
  • references/analysis-framework.md
  • references/base-prompt.md
  • references/config/preferences-schema.md
  • references/content-rules.md
  • references/design-guidelines.md
  • references/dimensions/density.md
  • references/dimensions/mood.md
  • references/dimensions/presets.md
  • references/dimensions/texture.md
  • references/dimensions/typography.md
  • references/layouts.md
  • references/modification-guide.md
  • references/options.md
  • references/outline-template.md
  • references/styles
  • … and 28 more

Open the folder on GitHubat commit d8aaee7

Compare with similar skills

Q-Presentations Slide Deck Generator 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.

Q-Presentations Slide Deck Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Q-Presentations Slide Deck Generator this skillTyrealQ/q-skills108—~1.1kAutomated safety check: PassMIT
Nano BananaEvoScientist/EvoSkills4762 repos~3.5kAutomated safety check: PassApache-2.0
Gpt Image2 PptJuneYaooo/gpt-image2-ppt-skills1.3k—~8.9kAutomated safety check: NotesApache-2.0
Gpt Image2 Pptninehills/skills280—~6.9kAutomated safety check: NotesApache-2.0
Gpt Image 2 Paper Ppt Imagesdracohu2025-cloud/draco-skills-collection227—~3.9kAutomated safety check: PassMIT
Skywork Pptaiskillstore/marketplace430—~1.9kAutomated safety check: PassNone

Similar skills

  • Nano Banana

    EvoScientist/EvoSkills

    Generate professional presentation slides and high-quality illustrations using Gemini image generation API (Nano Banana 2), with interactive browser-based review and iterative editing.

    476 GitHub starsUsed in 2 repos~3.5k 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
  • Gpt Image2 Ppt

    ninehills/skills

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

    280 GitHub stars~6.9k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check: notes
  • Gpt Image 2 Paper Ppt Images

    dracohu2025-cloud/draco-skills-collection

    A skill your agent uses when generating PPT-style image slides, poetic presentation covers, quiet paper-texture visual pages, report pages, invitations, social cards, or slide-image sets with…

    227 GitHub stars~3.9k tokensUpdated 22 days ago
    Documents & OfficeAuto-check passed
  • Skywork Ppt

    aiskillstore/marketplace

    Generate PPTs from topics or templates, edit existing presentations via natural language, or perform local file operations (delete/reorder/merge slides).

    430 GitHub stars~1.9k tokensUpdated today
    Documents & OfficeAuto-check passed
  • SenseNova PPT Creative Renderer

    OpenSenseNova/SenseNova-Skills

    Turns an approved slide outline into a full-page image for every slide, one 16:9 PNG per page, and optionally packages the set into a PPTX.

    5.7k GitHub stars~1.2k tokensUpdated today
    Documents & OfficeAuto-check passed

More from TyrealQ/q-skills

All 16 skills in this repo
  • Q-Infographics

    TyrealQ/q-skills

    Converts a report or other document into a business story and then an infographic image, pausing for your review after each step.

    108 GitHub stars~814 tokensUpdated 15 days ago
    Auto-check: notes
  • Runs exploratory data analysis on tabular data after you confirm each column's measurement level, then writes CSV tables and a narrative summary.

    108 GitHub stars~1.1k tokensUpdated 15 days ago
    Auto-check passed
  • Extracts pixel, video-frame, speech, music and visual-semantic features from image, video and audio files for research datasets, using local tools or the Gemini API.

    108 GitHub stars~2k tokensUpdated 15 days ago
    Auto-check: notes
  • Consolidates BERTopic, LDA or NMF topic output into a theory-driven classification framework and writes the final labels back to an Excel file.

    108 GitHub stars~1k tokensUpdated 15 days ago
    Auto-check passed
  • Audits a repository's file layout and project documentation against a written convention file, then proposes moves, deletions and doc fixes as an approved plan before touching anything.

    108 GitHub stars~4.4k tokensUpdated 15 days ago
    Auto-check: notes
  • Commit

    TyrealQ/q-skills

    Stage and commit uncommitted changes with conventional commit messages.

    108 GitHub stars~1.1k tokensUpdated 15 days ago
    Auto-check: notes

Questions about Q-Presentations Slide Deck Generator

What does Q-Presentations Slide Deck Generator do?

Generates branded slide deck images from written content, with a content analysis step, a layout catalog and scripts that merge the slides into PowerPoint or PDF. Built on the baoyu-slide-deck project, this skill turns written content into a sequence of slide images rather than a traditional template-based deck. A bundled script generates each slide image through GPT Image 2 by default, needing an OPENAI_API_KEY, or through Gemini's image model with a GEMINI_API_KEY, after which another script overlays a Dr.

When should I use Q-Presentations Slide Deck Generator?

Q-Presentations Slide Deck Generator fits situations like: turning written content into a branded slide deck; generating slide images for a deck that should read well on its own; merging a set of generated slide images into a PowerPoint or PDF file.

How do I install Q-Presentations Slide Deck Generator in Claude Code?

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

How do I install Q-Presentations Slide Deck Generator in Codex?

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

Can I use Q-Presentations Slide Deck Generator 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 TyrealQ/q-skills --skill q-presentations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/q-presentations, .gemini/skills/q-presentations, .github/skills/q-presentations and .opencode/skills/q-presentations in your project.

What does Q-Presentations Slide Deck Generator need to run?

Going by SKILL.md and its folder, Q-Presentations Slide Deck Generator needs the command-line tools its instructions call (pip and npx) and credentials named OPENAI_API_KEY and GEMINI_API_KEY. Our summary lists: Python with openai, google-genai, Pillow and python-dotenv; Bun runtime (Node.js 18+); An OPENAI_API_KEY or GEMINI_API_KEY depending on the image model.

Does Q-Presentations Slide Deck Generator access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Q-Presentations Slide Deck Generator 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 Q-Presentations Slide Deck Generator use?

Q-Presentations Slide Deck Generator 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 Q-Presentations Slide Deck Generator use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 25k tokens, read only when the agent opens those files.

What are the alternatives to Q-Presentations Slide Deck Generator?

Skills that share tags, products or a category with Q-Presentations Slide Deck Generator: Nano Banana (EvoScientist/EvoSkills, 476 stars), Gpt Image2 Ppt (JuneYaooo/gpt-image2-ppt-skills, 1.3k stars), Gpt Image2 Ppt (ninehills/skills, 280 stars) and Gpt Image 2 Paper Ppt Images (dracohu2025-cloud/draco-skills-collection, 227 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Q-Presentations Slide Deck Generator?

TyrealQ (a GitHub user) maintains it in TyrealQ/q-skills, which has 108 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 23, 2026.

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