| name | q-infographics |
| description | Convert documents into business stories and infographics. Use for turning reports, documents, or text into visual summaries or infographics. |
Q-Infographics
Transform source documents into business stories and infographic images.
If in plan mode: write a brief plan — "Run q-infographics skill: convert source
document to markdown, generate business story via Gemini, generate infographic image."
— then exit plan mode immediately. Do NOT attempt document conversion, story generation,
or image generation while plan mode is active.
Script Directory
Agent execution instructions:
- Determine this SKILL.md file's directory path as
SKILL_DIR.
- Script path =
${SKILL_DIR}/scripts/<script-name>.
- Prompt path =
${SKILL_DIR}/references/<prompt-name>.
| Resource | Purpose |
|---|
scripts/gen_story.py | Generate business story from document via Gemini API |
scripts/gen_image.py | Generate infographic image via GPT Image 2 (default) or Gemini |
references/story.txt | Story generation prompt template |
references/image.txt | Infographic generation prompt template |
Dependencies
openai
google-genai
Pillow
markitdown
Install: pip install openai google-genai Pillow markitdown
Default infographic model is gpt-image-2 (requires OPENAI_API_KEY). Set IMAGE_MODEL=gemini or pass --model gemini to gen_image.py to use gemini-3-pro-image-preview (requires GEMINI_API_KEY). Story generation (gen_story.py) always uses Gemini.
Load keys from .env:
PowerShell (Windows):
$env:GEMINI_API_KEY = (Get-Content path\to\.env | Where-Object { $_ -match '^GEMINI_API_KEY=' } | Select-Object -First 1).Split('=',2)[1]
Bash (macOS/Linux):
export $(cat /path/to/.env | xargs)
References
- references/prompts_reference.md — story and image prompt descriptions and key elements
Core Principles
- Review checkpoint after each step — display outputs and get user confirmation before proceeding
- Output files use source filename with
_INFO suffix (e.g., MY_REPORT.pdf → MY_REPORT_INFO.jpg)
- Logo auto-overlaid in bottom-right corner (~6% of image width); customize via
assets/Logo_Q.png
Workflow
| Step | Action | Command / Reference |
|---|
| 1 | Convert source document to markdown; show first ~50 lines for confirmation | markitdown <input_file> -o <OUTPUT.md> |
| 2 | Generate business story; show prompt and full output for review | python "${SKILL_DIR}/scripts/gen_story.py" <INPUT.md> "${SKILL_DIR}/references/story.txt" > STORY_OUTPUT.md |
| 3 | Generate infographic image; display result for review | python "${SKILL_DIR}/scripts/gen_image.py" STORY_OUTPUT.md "${SKILL_DIR}/references/image.txt" <SOURCE_NAME>_INFO |
Customization
- Story style: Edit
${SKILL_DIR}/references/story.txt — see references/prompts_reference.md
- Infographic style: Edit
${SKILL_DIR}/references/image.txt — see references/prompts_reference.md
Scope
Include: Document-to-story conversion, infographic generation, logo branding.
Exclude: Slide decks (use q-presentations), data visualization, chart generation.
Checklist
