hackflow-ppt
AI-powered hackathon PPT generator for Claude Code. One /ppt command to analyze your project codebase, choose from 6 stunning visual styles
Open source Open in the app JSON README (API)
About
AI-powered hackathon PPT generator for Claude Code. One /ppt command to analyze your project codebase, choose from 6 stunning visual styles (Gradient Glass, Apple Vision, Google Material, Microsoft Fluent, Vercel Mono, Linear Mesh), and generate 4K presentation slides using Gemini 3.1 Flash Image. Supports custom style creation — describe your vision and AI writes a complete style template. Content is auto-structured around 6 hackathon judging dimensions with storytelling hooks for maximum pitch impact. Outputs a ready-to-present PPTX file.
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- qwwzdyj
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 2
- Last push
- 2026-05-30T08:27:35Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
qwwzdyj/hackflow-ppt-skill/hackflow-ppt
README
# HackFlow PPT Skill
One command to create hackathon-ready PPT decks with Codex built-in image generation.
HackFlow PPT analyzes a project or topic, plans a concise pitch deck, generates one polished 16:9 slide image per page with Codex built-in `gpt-image-2`, and assembles the images into a PPTX locally.
No Gemini, Yunwu, or third-party image API key is required.
## Features
- **Codex built-in image generation** — uses `gpt-image-2` through Codex `image_gen`
- **No external API configuration** — no Gemini/Yunwu key, proxy, or `config.json`
- **6 built-in styles** — Gradient Glass, Apple Vision, Google Quantum, Microsoft Fluent, Vercel Mono, Linear Mesh
- **Project-aware planning** — analyzes your workspace across hackathon judging dimensions
- **Pitch-ready structure** — pain point, solution, features, architecture, metrics, roadmap, Q&A
- **PPTX assembly** — saves slide PNGs and builds a 16:9 PowerPoint deck locally
## Quick Start
### 1. Install
Clone the plugin:
```bash
git clone https://github.com/qwwzdyj/hackflow-ppt-skill.git
cd hackflow-ppt-skill
./install.sh
```
Then install or load this folder as a Codex plugin.
### 2. Use
In Codex, run:
```text
/ppt about this project
```
Or provide a topic directly:
```text
/ppt AI-powered code review tool that catches bugs before they ship
```
The skill will:
1. Analyze the current project or topic.
2. Choose a style, defaulting to `gradient-glass`.
3. Create a slide plan, defaulting to 8 pages for hackathon/project decks.
4. Generate prompts in `.codex/ppt/prompts.json`.
5. Generate slide images through Codex built-in image generation.
6. Assemble `$(basename "$(pwd)")-hackflow-ppt.pptx`.
## Styles
| Style | Description |
| --- | --- |
| `gradient-glass` | Apple Keynote minimalism + glassmorphism + aurora gradients |
| `apple-vision` | Deep space + visionOS spatial layers + subtle halos |
| `google-quantum` | Material You + warm organic shapes + playful 3D ceramics |
| `microsoft-fluent` | Acrylic transparency + Mica effects + Fluent 3D icons |
| `vercel-mono` | Pure black + glowing gradient text + wireframe geometry |
| `linear-mesh` | Gradient mesh aurora + fluid glass + rich color temperature |
## Output
Generated files are written inside the current workspace:
```text
.codex/ppt/
├── plan.json
├── prompts.json
├── slides/
│ ├── slide-01.png
│ └── slide-02.png
└── report.json
<project-name>-hackflow-ppt.pptx
```
## How It Works
```text
/ppt about this project
|
v
Analyze project or topic
|
v
Plan concise pitch deck
|
v
Build slide prompts with selected style
|
v
Generate one 16:9 image per slide with Codex gpt-image-2
|
v
Assemble images into PPTX
```
## File Structure
```text
hackflow-ppt-skill/
├── .codex-plugin/
│ └── plugin.json
├── commands/
│ └── ppt.md
├── skills/
│ └── hackflow-ppt/
│ └── SKILL.md
├── scripts/
│ ├── assemble_pptx.py
│ ├── make_prompts.py
│ ├── requirements.txt
│ └── styles.py
├── install.sh
└── README.md
```
## Requirements
- Codex with built-in image generation available
- Python 3.9+
- `python-pptx` for local PPTX assembly
## License
MIT