agentleFS
JimLiuJimLiu/baoyu-skills/skills/baoyu-infographic/SKILL.md

baoyu-infographic

Skill27k starsChanged 7 months agoMITView on GitHub

Generate professional infographics with 21 layout types and 22 visual styles. Analyzes content, recommends layout×style combinations, and generates publication-ready infographics. Use when user asks to create "infographic", "信息图", "visual summary", "可视化", or "高密度信息大图".

31 other projects use a version of this, 31 of them edited; 31 of 31 edited versions we compared changed its rules.

How people change it

31 of 31 edited versions changed its rules, and some changes recur.

Of the 31 edited versions we compared: 31 made changes of their own.

Rules people drop

  1. Codex via codex exec (codex-imagegen): no native imagegen, but the codex CLI is on PATH with an active codex login → baoyu-image-gen --provider codex-cli (preferred), or the bundled wrapper if baoyu-image-gen is unavailable. …dropped by 31 of 31
  2. ⛔ Raster only: never substitute SVG, HTML/CSS, canvas, or other code-based rendering for a raster image, even for diagram-like content. If no raster backend resolves, go to step 4.dropped by 31 of 31
  3. Prompt file (hard): before invoking any backend, write each image's full, final prompt to its own file under prompts/ (NN-{type}-[slug].md) and pass that file (or its content) to the backend. …dropped by 31 of 31
  4. Default combination: bento-grid + craft-handmade (fallback recommendation only — never bypasses Step 4).dropped by 31 of 31
  5. If user input matches a Keyword Shortcut, apply it (see above).dropped by 31 of 31
  6. When this skill prompts the user, follow this tool-selection rule (priority order):dropped by 24 of 31
  7. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.dropped by 24 of 31
  8. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.dropped by 24 of 31

Rules people add

  1. All text in confirmed languageadded by 31 of 31
  2. 3.1 Check Keyword Shortcuts first: If user input matches a keyword from the Keyword Shortcuts table, auto-select the associated layout and prioritize associated styles as top recommendations. Skip content-based layout inference.added by 26 of 31
  3. When user input contains these keywords, auto-select the associated layout and offer associated styles as top recommendations in Step 3. Skip content-based layout inference for matched keywords.added by 19 of 31
  4. If a shortcut has Prompt Notes, append them to the generated prompt (Step 5) as additional style instructions.added by 19 of 31
  5. A rule we can't quote: its licence doesn't allow itadded by 16 of 31
  6. Load references: Read references/analysis-framework.md from this skill.added by 14 of 31
  7. Q2 — Aspect: Ask for aspect ratio preference (landscape/portrait/square or custom W:H).added by 14 of 31
  8. Load references: Read the selected layout from references/layouts/<layout>.md and style from references/styles/<style>.md.added by 14 of 31

We split this file and each edited version into the rules they give an agent and match them by wording. A version that adds no rule of its own and has not changed since this file last did reads as an older text, so what it lacks is not counted as dropped. We keep no past texts of a file, so that is inferred, and an edited version that started from an older text still counts its gaps as drops.

Adopted by

Steady: 0 new projects took it in the last 4 weeks, none the 4 weeks before.thin data

Week of Sep 20: 0 new projectsWeek of Sep 27: 0 new projectsWeek of Oct 4: 0 new projectsWeek of Oct 11: 0 new projectsWeek of Oct 18: 0 new projectsWeek of Oct 25: 0 new projectsWeek of Nov 1: 0 new projectsWeek of Nov 8: 0 new projects
Sep 2026Oct 2026Nov 2026
New projects taking a version of this file each week, over the 8 weeks our latest run read: only 0 in all, so this is a hint, not a trend.

Most recently taken up by

Who's talking about JimLiu/baoyu-skills

The biggest 5 of 66 mentions linking to the repository that our crawl found. Each line is their own headline.

See all 66

Talked about on GitHub, YouTube, Bluesky and the web (66 times).

On GitHub · 50

45 more on GitHub

On YouTube · 12

7 more on YouTube

On Bluesky · 3

On the web · 1

Used with

Projects with it also use deepl, imagemagick-conversion and 4 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • zephyrwang6Skill

    deepl

    Übersetzt Texte, Dokumente und XLIFF-Dateien via DeepL API. Verwende für Übersetzungen mit /deepl translate, /deepl file oder /deepl xliff.

    Also in 4 projects that use this

  • zephyrwang6Skill

    imagemagick-conversion

    Convert and manipulate images with ImageMagick. Covers format conversion, resizing, batch processing, quality adjustment, and image transformations. Use when user mentions image conversion, resizing images, ImageMagick, magick command, batch image processing, or thumbnail generation.

    Also in 4 projects that use this

  • john-data-chenSkill

    touchdesigner-mcp

    Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.

    Also in 7 projects that use this

  • +3 more from zephyrwang6

The file

Show its rules and text

We split this skill into the rules it gives an agent

15 rules. 0 are common, 6 are distinctive, and 9 are very specific to this project.

  • 0

    Common

    Most of the 31 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 9

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When this skill prompts the user, follow this tool-selection rule (priority order):

    line 16
  2. Distinctive:

    Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each …

    line 19
  3. Distinctive:

    Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call.

    line 20
  4. Very specific:

    Codex via codex exec (codex-imagegen): no native imagegen, but the codex CLI is on PATH with an active codex login → baoyu-image-gen …

    line 32
  5. Distinctive:

    ⛔ Raster only: never substitute SVG, HTML/CSS, canvas, or other code-based rendering for a raster image, even for diagram-like content.

    line 39
  6. Very specific:

    Prompt file (hard): before invoking any backend, write each image's full, final prompt to its own file under prompts/ (NN-{type}-[slug].md) …

    line 43
  7. Distinctive:

    Default: confirm before generation.

    line 72
  8. Very specific:

    Do not start Step 5 or Step 6 until the user confirms the combination/aspect/language/backend choices.

    line 75
  9. Very specific:

    Default combination: bento-grid + craft-handmade (fallback recommendation only — never bypasses Step 4).

    line 169
  10. Very specific:

    When the user's input contains these keywords, use the mapped layout as the leading Step 3 recommendation, promote the listed styles to the …

    line 173
  11. Distinctive:

    If user input matches a Keyword Shortcut, apply it (see above).

    line 229
  12. Very specific:

    Backup rule: if prompts/infographic.md exists, rename to prompts/infographic-backup-YYYYMMDD-HHMMSS.md.

    line 245
  13. Very specific:

    Ensure the full final prompt is persisted at prompts/infographic.md (Step 5) BEFORE invoking the backend.

    line 254
  14. Very specific:

    If infographic.png exists, rename to infographic-backup-YYYYMMDD-HHMMSS.png.

    line 255
  15. Very specific:

    Call the backend with the prompt file and output path.

    line 256

“Common” is measured: kept by at least 6 in 10 of the 31 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Infographic Generator

Two dimensions: layout (information structure) × style (visual aesthetics); any layout combines with any style.

User Input Tools

When this skill prompts the user, follow this tool-selection rule (priority order):

  1. Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, request_user_input, clarify, ask_user, or any equivalent.
  2. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
  3. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.

Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes.

Image Generation Tools

Resolve the image backend in this order:

  1. User names a backend in the current message → use it.
  2. preferred_image_backend in EXTEND.md names a backend available now → use it. ask means ask every run.
  3. Auto-select (preference auto, unset, or the pinned backend is unavailable), first match wins:
    • Codex imagegen skill is in your available skills → you are in Codex and MUST use it: Skill with skill: "imagegen", passing the prompt file's content plus output path and aspect ratio. It outranks non-native skills such as baoyu-image-gen.
    • Codex via codex exec (codex-imagegen): no native imagegen, but the codex CLI is on PATH with an active codex login → baoyu-image-gen --provider codex-cli (preferred), or the bundled wrapper if baoyu-image-gen is unavailable. Load references/codex-imagegen.md only for this branch.
    • Cursor GenerateImage → use it (outranks non-native skills). It has no aspect-ratio parameter, so state the aspect ratio / dimensions in the description prompt; it saves to a tool-managed location, so copy the file to the expected output path (e.g., outputs/.../NN-xxx.png). Reference images go in reference_image_paths.
    • Other runtime-native image tool (e.g., Hermes image_generate) → use it the same way.
    • Exactly one non-native backend installed (e.g., baoyu-image-gen) → use it.
    • Several non-native backends → ask the user once, batched with other initial questions.
  4. None available → tell the user and ask how to proceed.

⛔ Raster only: never substitute SVG, HTML/CSS, canvas, or other code-based rendering for a raster image, even for diagram-like content. If no raster backend resolves, go to step 4.

⛔ No bitmap text patching: never use ImageMagick, Pillow, Canvas, SVG, HTML/CSS, OCR scripts, or any other overlay to cover, rewrite, erase, stroke, or replace labels, headings, callouts, data values, or any other text inside an already generated infographic. Regenerate from a corrected prompt, switch to a layout with less on-image text, or ask the user which imperfect candidate to keep.

Prompt file (hard): before invoking any backend, write each image's full, final prompt to its own file under prompts/ (NN-{type}-[slug].md) and pass that file (or its content) to the backend. It is the reproducibility record and lets you switch backends without rewriting prompts.

Change the pinned backend via ## Changing Preferences below. Tool names above are examples; use the local equivalent in other runtimes.

Reference Images

Accept via --ref <files...>, file paths, or pasted images (guide style, palette, composition, or subject):

  • File path(s) → copy to refs/NN-ref-{slug}.{ext} alongside the output
  • Pasted image with no path → ask for the path (per User Input Tools), or extract style traits verbally as a text fallback
UsageEffect
directPass the file to the backend as a reference image
styleExtract style traits (line treatment, texture, mood) and append to the prompt body
paletteExtract hex colors from the image and append to the prompt body

Record refs in prompts/infographic.md frontmatter:

references:
  - ref_id: 01
    filename: 01-ref-brand.png
    usage: direct

At generation: verify each referenced file exists; if usage: direct AND the backend accepts reference images (e.g., baoyu-image-gen via --ref), pass it via the backend's ref parameter; otherwise embed extracted style/palette traits in the prompt text.

Confirmation Policy

Default: confirm before generation.

  • Explicit skill invocation, a file path, a matched keyword shortcut, EXTEND.md defaults, and the documented default combination are recommendation inputs only — none authorizes skipping confirmation.
  • Do not start Step 5 or Step 6 until the user confirms the combination/aspect/language/backend choices.
  • Skip confirmation only when the current request explicitly says so: --no-confirm, "直接生成", "不用确认", "跳过确认", "按默认出图", or equivalent. Then state the assumed combination/aspect/language/backend in the next user-facing update before generating.

Options

OptionValues
--layout21 options (see Layout Gallery), default: bento-grid
--style22 options (see Style Gallery), default: craft-handmade
--aspectNamed: landscape (16:9), portrait (9:16), square (1:1). Custom: any W:H ratio (e.g., 3:4, 4:3, 2.35:1)
--langen, zh, ja, etc.
--no-confirmSkip Step 4 only when the user explicitly requests direct generation without confirmation
--ref <files...>Reference images (file paths) for style / palette / composition / subject guidance

Layout Gallery (21)

Definitions: references/layouts/<layout>.md.

LayoutBest For
linear-progressionTimelines, processes, tutorials
binary-comparisonA vs B, before-after, pros-cons
comparison-matrixMulti-factor comparisons
hierarchical-layersPyramids, priority levels
tree-branchingCategories, taxonomies
hub-spokeCentral concept with related items
structural-breakdownExploded views, cross-sections
bento-gridMultiple topics, overview (default)
icebergSurface vs hidden aspects
bridgeProblem-solution
funnelConversion, filtering
isometric-mapSpatial relationships
dashboardMetrics, KPIs
periodic-tableCategorized collections
comic-stripNarratives, sequences
story-mountainPlot structure, tension arcs
jigsawInterconnected parts
venn-diagramOverlapping concepts
winding-roadmapJourney, milestones
circular-flowCycles, recurring processes
dense-modulesHigh-density modules, data-rich guides

Style Gallery (22)

Definitions: references/styles/<style>.md.

StyleDescription
craft-handmadeHand-drawn, paper craft (default)
claymation3D clay figures, stop-motion
kawaiiJapanese cute, pastels
storybook-watercolorSoft painted, whimsical
chalkboardChalk on black board
cyberpunk-neonNeon glow, futuristic
bold-graphicComic style, halftone
aged-academiaVintage science, sepia
corporate-memphisFlat vector, vibrant
technical-schematicBlueprint, engineering
origamiFolded paper, geometric
pixel-artRetro 8-bit
ui-wireframeGrayscale interface mockup
subway-mapTransit diagram
ikea-manualMinimal line art
knollingOrganized flat-lay
lego-brickToy brick construction
pop-laboratoryBlueprint grid, coordinate markers, lab precision
morandi-journalHand-drawn doodle, warm Morandi tones
retro-pop-grid1970s retro pop art, Swiss grid, thick outlines
hand-drawn-eduMacaron pastels, hand-drawn wobble, stick figures
retro-popup-popRetro popup collage, vintage UI, thick outlines, flat pop colors

Recommended Combinations

Content TypeLayout + Style
Timeline/Historylinear-progression + craft-handmade
Step-by-steplinear-progression + ikea-manual
A vs Bbinary-comparison + corporate-memphis
Hierarchyhierarchical-layers + craft-handmade
Overlapvenn-diagram + craft-handmade
Conversionfunnel + corporate-memphis
Cyclescircular-flow + craft-handmade
Technicalstructural-breakdown + technical-schematic
Metricsdashboard + corporate-memphis
Educationalbento-grid + chalkboard
Journeywinding-roadmap + storybook-watercolor
Categoriesperiodic-table + bold-graphic
Product Guidedense-modules + morandi-journal
Technical Guidedense-modules + pop-laboratory
Trendy Guidedense-modules + retro-pop-grid
Retro Pop Guidedense-modules + retro-popup-pop
Educational Diagramhub-spoke + hand-drawn-edu
Process Tutoriallinear-progression + hand-drawn-edu

Default combination: bento-grid + craft-handmade (fallback recommendation only — never bypasses Step 4).

Keyword Shortcuts

When the user's input contains these keywords, use the mapped layout as the leading Step 3 recommendation, promote the listed styles to the top of the Step 3 list, skip content-based layout inference, and append any Prompt Notes to the Step 5 prompt.

User KeywordLayoutRecommended StylesDefault AspectPrompt Notes
高密度信息大图 / high-density-infodense-modulesmorandi-journal, pop-laboratory, retro-pop-grid, retro-popup-popportrait—
信息图 / infographicbento-gridcraft-handmadelandscapeMinimalist: clean canvas, ample whitespace, no complex background textures. Simple cartoon elements and icons only.

Output Structure

infographic/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── structured-content.md
├── prompts/infographic.md
└── infographic.png

Slug: 2-4 words kebab-case from topic. Conflict: append -YYYYMMDD-HHMMSS.

Core Principles

  • Preserve source data faithfully—no summarization or rephrasing (but strip any credentials, API keys, tokens, or secrets before including in outputs)
  • Define learning objectives before structuring content
  • Structure for visual communication (headlines, labels, visual elements)

Workflow

Step 1: Setup & Analyze

1.1 Load Preferences (EXTEND.md) — first match wins:

PriorityPathScope
1.baoyu-skills/baoyu-infographic/EXTEND.mdProject
2${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-infographic/EXTEND.mdXDG
3$HOME/.baoyu-skills/baoyu-infographic/EXTEND.mdUser home

Found → read, parse, display a one-line summary. Not found → ask the user with AskUserQuestion per references/config/first-time-setup.md. Supports preferred layout/style, default aspect, language, image backend, custom styles (schema: references/config/preferences-schema.md).

1.2 Analyze Content → analysis.md (format: references/analysis-framework.md)

  1. Save source content (file path or paste → source.md). Backup rule: if source.md exists, rename to source-backup-YYYYMMDD-HHMMSS.md
  2. Analyze: topic, data type, complexity, tone, audience
  3. Detect source language and user language
  4. Extract design instructions from user input
  5. Save analysis. Backup rule: if analysis.md exists, rename to analysis-backup-YYYYMMDD-HHMMSS.md

Step 2: Generate Structured Content → structured-content.md

Format: references/structured-content-template.md. Title and learning objectives; sections with key concept, content (verbatim), visual element, text labels; data points (all statistics/quotes copied exactly); user design instructions.

Rules: Markdown only. No new information. Preserve data faithfully. Strip any credentials or secrets from output.

Step 3: Recommend Combinations

  1. If user input matches a Keyword Shortcut, apply it (see above).
  2. Otherwise recommend 3-5 layout×style combinations from data structure → layout, content tone → style, audience expectations, and user design instructions.

Step 4: Confirm Options

Hard gate per the Confirmation Policy (opt-out: --no-confirm / equivalent in the current request). Ask per User Input Tools:

PriorityQuestionWhenOptions
1CombinationAlways3+ layout×style combos with rationale
2AspectAlwaysNamed presets (landscape/portrait/square) or custom W:H ratio (e.g., 3:4, 4:3, 2.35:1)
3LanguageOnly if source ≠ user languageLanguage for text content
4Image BackendOnly if step 3 of the ## Image Generation Tools rule needs to ask (no runtime-native tool AND multiple non-native backends, OR preferred_image_backend: ask)Available backends

Step 5: Generate Prompt → prompts/infographic.md

Backup rule: if prompts/infographic.md exists, rename to prompts/infographic-backup-YYYYMMDD-HHMMSS.md.

Combine: layout definition (references/layouts/<layout>.md), style definition (references/styles/<style>.md), base template (references/base-prompt.md), structured content from Step 2; all text in the confirmed language.

{{ASPECT_RATIO}}: landscape→16:9, portrait→9:16, square→1:1; custom W:H ratios as-is (e.g., 3:4, 4:3, 2.35:1).

Step 6: Generate Image

  1. Resolve the backend per ## Image Generation Tools.
  2. Ensure the full final prompt is persisted at prompts/infographic.md (Step 5) BEFORE invoking the backend.
  3. If infographic.png exists, rename to infographic-backup-YYYYMMDD-HHMMSS.png.
  4. Call the backend with the prompt file and output path. For codex-imagegen, see references/codex-imagegen.md.
  5. On failure, auto-retry once.

Text correction: never patch misspelled, garbled, or weak rendered text (labels, headings, callouts, data values) in the bitmap with code. Write a new prompt file and a new output path so the flawed candidate is kept for comparison. Post-processing is limited to crop, resize, compression, or format conversion that doesn't alter text or composition.

Step 7: Output Summary

Report: topic, layout, style, aspect, language, image backend, output path, files created.

Changing Preferences

EXTEND.md lives at the first matching path in Step 1.1. Edit it directly (schema: references/config/preferences-schema.md), or delete it / ask "reconfigure baoyu-infographic preferences" / "重新配置" to re-run first-time setup. Common edits:

  • preferred_image_backend: auto (default; runtime-native wins, else the only installed backend, ask if multiple non-native) | codex-imagegen | baoyu-image-gen | ask (confirm every run)
  • preferred_layout: dense-modules, preferred_style: morandi-journal, preferred_aspect: portrait, language: zh — shift Step-3 recommendations and Step-4 defaults (never bypass Step 4).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.