baoyu-article-illustrator

from jimliu/baoyu-skills

No description

2.7K stars308 forksUpdated Jan 26, 2026
npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-article-illustrator

SKILL.md

Article Illustrator

Analyze articles, identify illustration positions, generate images with Type × Style consistency.

Two Dimensions

DimensionControlsExamples
TypeInformation structure, layoutinfographic, scene, flowchart, comparison, framework, timeline
StyleVisual aesthetics, moodnotion, warm, minimal, blueprint, watercolor, elegant

Type × Style can be freely combined. Example: --type infographic --style blueprint

Type Gallery

TypeBest For
infographicData, metrics, technical articles
sceneNarratives, personal stories, emotional content
flowchartTutorials, workflows, processes
comparisonSide-by-side, before/after, options
frameworkMethodologies, models, architecture
timelineHistory, progress, evolution

Style Gallery

StyleBest For
notion (Default)Knowledge sharing, SaaS, productivity
elegantBusiness, thought leadership
warmPersonal growth, lifestyle, education
minimalPhilosophy, core concepts
blueprintArchitecture, system design
watercolorLifestyle, travel, creative
editorialTech explainers, journalism
scientificAcademic, technical research

Full styles: references/styles.md

Auto Selection

Content SignalsTypeStyle
API, metrics, data, numbersinfographicblueprint, notion
Story, emotion, journeyscenewarm, watercolor
How-to, steps, workflowflowchartnotion, minimal
vs, pros/cons, before/aftercomparisonnotion, elegant
Framework, model, architectureframeworkblueprint, notion
History, timeline, progresstimelineelegant, warm

Workflow

Copy this checklist and track progress:

Progress:
- [ ] Step 1: Pre-check
- [ ] Step 2: Setup & Analyze
- [ ] Step 3: Confirm Settings ⚠️ REQUIRED
- [ ] Step 4: Generate Outline
- [ ] Step 5: Generate Images
- [ ] Step 6: Finalize

Step 1: Pre-check

1.1 Determine Input Type

InputOutput DirectoryNext
File pathAsk user (1.2)→ 1.2
Pasted contentillustrations/{topic-slug}/→ 1.4

1.2 Determine Output Directory (file path input only)

Check default_output_dir in preferences:

Preference ValueAction
same-dirUse {article-dir}/, display "Output: {path}"
imgs-subdirUse {article-dir}/imgs/, display "Output: {path}"
illustrations-subdirUse {article-dir}/illustrations/, display "Output: {path}"
independentUse illustrations/{topic-slug}/, display "Output: {path}"
Not configuredMUST ask with AskUserQuestion ↓

AskUserQuestion (when no preference):

  • {article-dir}/ - Same directory as article
  • {article-dir}/imgs/ - Images subdirectory
  • {article-dir}/illustrations/ - Illustrations subdirectory (Recommended)
  • illustrations/{topic-slug}/ - Independent directory
  • Save as default - Remember this choice for future runs

1.3 Check Existing Images

Scan target directory for .png/.jpg/.webp files.

If images exist → AskUserQuestion: How to handle?

  • supplement - Keep existing, generate only new positions
  • overwrite - Overwrite same-name files
  • regenerate - Clear all and regenerate

1.4 Confirm Article Update Method (file path input only)

AskUserQuestion: How to update article?

  • update - Modify original file directly
  • copy - Create {name}-illustrated.md copy

1.5 Load Preferences (EXTEND.md)

test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
ResultAction
FoundRead, parse, display summary
Not foundAsk with AskUserQuestion (see references/config/first-time-setup.md)

Supports: Watermark | Preferred type/style | Custom styles | Language | Output directory


Step 2: Setup & Analyze

2.1 Analyze Content

AnalysisDescription
Content typeTechnical / Tutorial / Methodology / Narrative
Core arguments2-5 main points to visualize
Visual opportunitiesPositions where illustrations add value
Recommended typeBased on content signals
Recommended densityBased on length and complexity

2.2 Extract Core Arguments

  • Main thesis
  • Key concepts reader needs
  • Comparisons/contrasts
  • Framework/model proposed

CRITICAL: If article uses metaphors (e.g., "电锯切西瓜"), do NOT illustrate literally. Visualize the underlying concept.

2.3 Identify Positions

Illustrate:

  • Core arguments (REQUIRED)
  • Abstract concepts
  • Data comparisons
  • Processes, workflows

Do NOT Illustrate:

  • Metaphors literally
  • Decorative scenes
  • Generic illustratio

...

Read full content

Repository Stats

Stars2.7K
Forks308