chore: release v1.28.0

chore: ignore baoyu-skill-evolution directory
feat(baoyu-post-to-wechat): add newspic article type support
2026-07-10 05:01:40 +00:00 · 2026-02-01 19:49:49 -06:00 · 2026-02-01 19:49:22 -06:00 · 2026-02-01 19:49:14 -06:00 · 2026-02-01 19:49:05 -06:00 · 2026-02-01 19:48:56 -06:00
166 changed files with 18692 additions and 4243 deletions
@@ -6,7 +6,7 @@
  },
  "metadata": {
    "description": "Skills shared by Baoyu for improving daily work efficiency",
-    "version": "1.15.2"
+    "version": "1.28.0"
  },
  "plugins": [
    {
@@ -43,7 +43,9 @@
      "skills": [
        "./skills/baoyu-danger-x-to-markdown",
        "./skills/baoyu-compress-image",
-        "./skills/baoyu-url-to-markdown"
+        "./skills/baoyu-url-to-markdown",
+        "./skills/baoyu-format-markdown",
+        "./skills/baoyu-markdown-to-html"
      ]
    }
  ]
@@ -114,11 +114,17 @@ Display version change: `1.2.3 → 1.3.0`
 For each detected changelog file:

 1. **Identify language** from filename suffix
-2. **Generate content in that language**:
+2. **Detect third-party contributors**:
+   - Check merge commits: `git log ${LAST_TAG}..HEAD --merges --pretty=format:"%H %s"`
+   - For each merged PR, identify the PR author via `gh pr view <number> --json author --jq '.author.login'`
+   - Compare against repo owner (`gh repo view --json owner --jq '.owner.login'`)
+   - If PR author ≠ repo owner → third-party contributor
+3. **Generate content in that language**:
   - Section titles in target language
   - Change descriptions written naturally in target language (not translated)
   - Date format: YYYY-MM-DD (universal)
-3. **Insert at file head** (preserve existing content)
+   - **Third-party contributions**: Append contributor attribution `(by @username)` to the changelog entry
+4. **Insert at file head** (preserve existing content)

 **Section Title Translations** (built-in):

@@ -138,6 +144,7 @@ For each detected changelog file:

 ### Features
 - Description of new feature
+- Description of third-party contribution (by @username)

 ### Fixes
 - Description of fix
@@ -148,6 +155,12 @@ For each detected changelog file:

 Only include sections that have changes. Omit empty sections.

+**Third-Party Attribution Rules**:
+- Only add `(by @username)` for contributors who are NOT the repo owner
+- Use GitHub username with `@` prefix
+- Place at the end of the changelog entry line
+- Apply to all languages consistently (always use `(by @username)` format, not translated)
+
 **Multi-language Example**:

 English (CHANGELOG.md):
@@ -155,7 +168,7 @@ English (CHANGELOG.md):
 ## 1.3.0 - 2026-01-22

 ### Features
- Add user authentication module
+- Add user authentication module (by @contributor1)
 - Support OAuth2 login

 ### Fixes
@@ -167,7 +180,7 @@ Chinese (CHANGELOG.zh.md):
 ## 1.3.0 - 2026-01-22

 ### 新功能
- 新增用户认证模块
+- 新增用户认证模块 (by @contributor1)
 - 支持 OAuth2 登录

 ### 修复
@@ -179,18 +192,85 @@ Japanese (CHANGELOG.ja.md):
 ## 1.3.0 - 2026-01-22

 ### 新機能
- ユーザー認証モジュールを追加
+- ユーザー認証モジュールを追加 (by @contributor1)
 - OAuth2 ログインをサポート

 ### 修正
 - コネクションプールのメモリリークを修正
 ```

-### Step 5: Update Version File
+### Step 5: Group Changes by Skill/Module

-1. Read version file (JSON/TOML/text)
-2. Update version number
-3. Write back (preserve formatting)
+Analyze commits since last tag and group by affected skill/module:
+
+1. **Identify changed files** per commit
+2. **Group by skill/module**:
+   - `skills/<skill-name>/*` → Group under that skill
+   - Root files (CLAUDE.md, etc.) → Group as "project"
+   - Multiple skills in one commit → Split into multiple groups
+3. **For each group**, identify related README updates needed
+
+**Example Grouping**:
+```
+baoyu-cover-image:
+  - feat: add new style options
+  - fix: handle transparent backgrounds
+  → README updates: options table
+
+baoyu-comic:
+  - refactor: improve panel layout algorithm
+  → No README updates needed
+
+project:
+  - docs: update CLAUDE.md architecture section
+```
+
+### Step 6: Commit Each Skill/Module Separately
+
+For each skill/module group (in order of changes):
+
+1. **Check README updates needed**:
+   - Scan `README*.md` for mentions of this skill/module
+   - Verify options/flags documented correctly
+   - Update usage examples if syntax changed
+   - Update feature descriptions if behavior changed
+
+2. **Stage and commit**:
+   ```bash
+   git add skills/<skill-name>/*
+   git add README.md README.zh.md  # If updated for this skill
+   git commit -m "<type>(<skill-name>): <meaningful description>"
+   ```
+
+3. **Commit message format**:
+   - Use conventional commit format: `<type>(<scope>): <description>`
+   - `<type>`: feat, fix, refactor, docs, perf, etc.
+   - `<scope>`: skill name or "project"
+   - `<description>`: Clear, meaningful description of changes
+
+**Example Commits**:
+```bash
+git commit -m "feat(baoyu-cover-image): add watercolor and minimalist styles"
+git commit -m "fix(baoyu-comic): improve panel layout for long dialogues"
+git commit -m "docs(project): update architecture documentation"
+```
+
+**Common README Updates Needed**:
+| Change Type | README Section to Check |
+|-------------|------------------------|
+| New options/flags | Options table, usage examples |
+| Renamed options | Options table, usage examples |
+| New features | Feature description, examples |
+| Breaking changes | Migration notes, deprecation warnings |
+| Restructured internals | Architecture section (if exposed to users) |
+
+### Step 7: Generate Changelog and Update Version
+
+1. **Generate multi-language changelogs** (as described in Step 4)
+2. **Update version file**:
+   - Read version file (JSON/TOML/text)
+   - Update version number
+   - Write back (preserve formatting)

 **Version Paths by File Type**:

@@ -202,25 +282,77 @@ Japanese (CHANGELOG.ja.md):
 | marketplace.json | `$.metadata.version` |
 | VERSION / version.txt | Direct content |

-### Step 6: Commit and Tag
+### Step 8: User Confirmation

-```bash
-git add <all modified files>
-git commit -m "chore: release v{VERSION}"
-git tag v{VERSION}
+Before creating the release commit, ask user to confirm:
+
+**Use AskUserQuestion with two questions**:
+
+1. **Version bump** (single select):
+   - Show recommended version based on Step 3 analysis
+   - Options: recommended (with label), other semver options
+   - Example: `1.2.3 → 1.3.0 (Recommended)`, `1.2.3 → 1.2.4`, `1.2.3 → 2.0.0`
+
+2. **Push to remote** (single select):
+   - Options: "Yes, push after commit", "No, keep local only"
+
+**Example Output Before Confirmation**:
 ```
+Commits created:
+  1. feat(baoyu-cover-image): add watercolor and minimalist styles
+  2. fix(baoyu-comic): improve panel layout for long dialogues
+  3. docs(project): update architecture documentation
+
+Changelog preview (en):
+  ## 1.3.0 - 2026-01-22
+  ### Features
+  - Add watercolor and minimalist styles to cover-image
+  ### Fixes
+  - Improve panel layout for long dialogues in comic
+
+Ready to create release commit and tag.
+```
+
+### Step 9: Create Release Commit and Tag
+
+After user confirmation:
+
+1. **Stage version and changelog files**:
+   ```bash
+   git add <version-file>
+   git add CHANGELOG*.md
+   ```
+
+2. **Create release commit**:
+   ```bash
+   git commit -m "chore: release v{VERSION}"
+   ```
+
+3. **Create tag**:
+   ```bash
+   git tag v{VERSION}
+   ```
+
+4. **Push if user confirmed** (Step 8):
+   ```bash
+   git push origin main
+   git push origin v{VERSION}
+   ```

 **Note**: Do NOT add Co-Authored-By line. This is a release commit, not a code contribution.

-**Important**: Do NOT push to remote. User will push manually when ready.
-
 **Post-Release Output**:
 ```
-Release v1.3.0 created locally.
+Release v1.3.0 created.

-To publish:
-  git push origin main
-  git push origin v1.3.0
+Commits:
+  1. feat(baoyu-cover-image): add watercolor and minimalist styles
+  2. fix(baoyu-comic): improve panel layout for long dialogues
+  3. docs(project): update architecture documentation
+  4. chore: release v1.3.0
+
+Tag: v1.3.0
+Status: Pushed to origin  # or "Local only - run git push when ready"
 ```

 ## Configuration (.releaserc.yml)
@@ -285,31 +417,36 @@ Project detected:
 Last tag: v1.2.3
 Proposed version: v1.3.0

-Changes detected:
-  feat: add user authentication
-  feat: support oauth2 login
-  fix: memory leak in pool
+Changes grouped by skill/module:
+  baoyu-cover-image:
+    - feat: add watercolor style
+    - feat: add minimalist style
+    → Commit: feat(baoyu-cover-image): add watercolor and minimalist styles
+    → README updates: options table
+
+  baoyu-comic:
+    - fix: panel layout for long dialogues
+    → Commit: fix(baoyu-comic): improve panel layout for long dialogues
+    → No README updates

 Changelog preview (en):
  ## 1.3.0 - 2026-01-22
  ### Features
-  - Add user authentication module
-  - Support OAuth2 login
+  - Add watercolor and minimalist styles to cover-image
  ### Fixes
-  - Fix memory leak in connection pool
+  - Improve panel layout for long dialogues in comic

 Changelog preview (zh):
  ## 1.3.0 - 2026-01-22
  ### 新功能
-  - 新增用户认证模块
-  - 支持 OAuth2 登录
+  - 为 cover-image 添加水彩和极简风格
  ### 修复
-  - 修复连接池内存泄漏问题
+  - 改进 comic 长对话的面板布局

-Files to modify:
-  - package.json
-  - CHANGELOG.md
-  - CHANGELOG.zh.md
+Commits to create:
+  1. feat(baoyu-cover-image): add watercolor and minimalist styles
+  2. fix(baoyu-comic): improve panel layout for long dialogues
+  3. chore: release v1.3.0

 No changes made. Run without --dry-run to execute.
 ```
@@ -149,3 +149,13 @@ xhs-images/
 url-to-markdown/
 cover-image/
 slide-deck/
+infographic/
+illustrations/
+comic/
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+.claude/skills/baoyu-skill-evolution
@@ -2,6 +2,248 @@

 English | [中文](./CHANGELOG.zh.md)

+## 1.28.0 - 2026-02-01
+
+### Features
+- `baoyu-cover-image`: add reference image support (`--ref` parameter) with direct/style/palette usage types; add visual elements library with icon vocabulary by topic.
+- `baoyu-article-illustrator`: add reference image support with direct/style/palette usage types.
+- `baoyu-post-to-wechat`: add `newspic` article type for image-text posts.
+
+### Refactor
+- `baoyu-cover-image`, `baoyu-article-illustrator`, `baoyu-comic`, `baoyu-xhs-images`: enforce first-time setup as blocking operation before any other workflow steps.
+- `baoyu-cover-image`: remove character limits from titles, use original source titles.
+
+## 1.26.1 - 2026-01-29
+
+### Features
+- `baoyu-article-illustrator`, `baoyu-comic`, `baoyu-cover-image`, `baoyu-infographic`, `baoyu-slide-deck`, `baoyu-xhs-images`: add backup rules for existing files—automatically renames source, prompt, and image files with timestamp suffix before overwriting.
+
+### Fixes
+- `baoyu-xhs-images`: remove `notebook` style (10 styles remaining).
+
+## 1.26.0 - 2026-01-29
+
+### Features
+- `baoyu-xhs-images`: add `notebook` style (hand-drawn infographic with watercolor rendering and Morandi palette) and `study-notes` style (realistic handwritten photo aesthetic).
+- `baoyu-xhs-images`: add `mindmap` (center radial) and `quadrant` (four-section grid) layouts.
+
+## 1.25.4 - 2026-01-29
+
+### Fixes
+- `baoyu-markdown-to-html`: generate proper `<img>` tags with `data-local-path` attribute instead of text placeholders.
+- `baoyu-post-to-wechat`: fix API publishing to read image paths from `data-local-path` attribute; fix title/cover extraction from corresponding `.md` frontmatter when publishing HTML files.
+- `baoyu-post-to-wechat`: fix CLI argument parsing to handle unknown parameters gracefully; add `--summary` parameter support.
+- `baoyu-post-to-wechat`: fix browser publishing to convert `<img>` tags back to text placeholders before paste.
+
+## 1.25.3 - 2026-01-28
+
+### Features
+- `baoyu-format-markdown`: add content type detection with user confirmation for markdown files; add CJK punctuation handling to move paired punctuation outside emphasis markers.
+
+## 1.25.2 - 2026-01-28
+
+### Documentation
+- `baoyu-post-to-wechat`: add WeChat API credentials configuration guide to README.
+
+## 1.25.1 - 2026-01-28
+
+### Features
+- `baoyu-markdown-to-html`: add pre-check step for CJK content to suggest formatting with `baoyu-format-markdown` before conversion.
+
+## 1.25.0 - 2026-01-28
+
+### Features
+- `baoyu-format-markdown`: add markdown formatter skill with frontmatter, typography, and CJK spacing support.
+- `baoyu-markdown-to-html`: add markdown to HTML converter with WeChat-compatible themes, code highlighting, math, PlantUML, and alerts.
+- `baoyu-post-to-wechat`: add API-based publishing method and external theme support.
+
+## 1.24.4 - 2026-01-28
+
+### Fixes
+- `baoyu-post-to-x`: fix Apply button click for cover image modal; add retry logic and wait for modal close.
+
+## 1.24.3 - 2026-01-28
+
+### Documentation
+- Emphasize updating prompt files before regenerating images in modification workflows (article-illustrator, slide-deck, xhs-images, cover-image, comic).
+
+## 1.24.2 - 2026-01-28
+
+### Refactor
+- `baoyu-image-gen`: default to sequential generation; parallel available on request.
+
+## 1.24.1 - 2026-01-28
+
+### Features
+- `baoyu-image-gen`: add Aliyun Tongyi Wanxiang (DashScope) text-to-image model support (by @JianJang2017).
+
+### Documentation
+- Add Aliyun text-to-image model configuration to README.
+
+## 1.24.0 - 2026-01-27
+
+### Features
+- `baoyu-post-to-wechat`: reuse existing Chrome browser instead of requiring all windows closed (by @AliceLJY).
+
+### Fixes
+- `baoyu-post-to-wechat`: improves title extraction to support h1/h2 headings; adds summary auto-fill and content verification after paste/type; supports flexible HTML meta tag attribute ordering.
+
+### Documentation
+- `release-skills`: adds third-party contributor attribution rules to changelog workflow.
+- Backfills missing third-party contributor attributions across historical changelog entries.
+
+## 1.23.1 - 2026-01-27
+
+### Fixes
+- `baoyu-compress-image`: rename original file as `_original` backup instead of deleting after compression.
+
+## 1.23.0 - 2026-01-26
+
+### Refactor
+- `baoyu-cover-image`: replaces 20 fixed styles with 5-dimension system (Type × Palette × Rendering × Text × Mood). 9 color palettes × 6 rendering styles = 54 combinations. Adds style presets for backward compatibility, v2→v3 schema migration, and new reference structure (`palettes/`, `renderings/`, `workflow/`).
+
+## 1.22.0 - 2026-01-25
+
+### Features
+- `baoyu-article-illustrator`: adds `imgs-subdir` output directory option; improves style selection to always ask and show preferred_style from EXTEND.md.
+- `baoyu-cover-image`: adds `default_output_dir` preference supporting `same-dir`, `imgs-subdir`, and `independent` options with Step 1.5 for output directory selection.
+- `baoyu-post-to-wechat`: adds theme selection (default/grace/simple) with AskUserQuestion before posting; adds HTML preview step; simplifies image placeholders to `WECHATIMGPH_N` format; refactors copy/paste to cross-platform helpers.
+
+### Refactor
+- `baoyu-post-to-x`: simplifies image placeholders from `[[IMAGE_PLACEHOLDER_N]]` to `XIMGPH_N` format.
+
+## 1.21.4 - 2026-01-25
+
+### Fixes
+- `baoyu-post-to-wechat`: adds Windows compatibility—uses `fileURLToPath` for correct path resolution, replaces system-dependent copy/paste tools (osascript/xdotool) with CDP keyboard events for cross-platform support (by @JadeLiang003).
+- `baoyu-post-to-wechat`: fixes regressions from Windows compatibility PR—corrects broken `-fixed` filename references, restores frontmatter quote stripping, restores `--title` CLI parameter, fixes summary extraction to skip headings/quotes/lists, fixes argument parsing for single-dash flags, removes debug logs.
+- `baoyu-article-illustrator`, `baoyu-cover-image`, `baoyu-xhs-images`: removes opacity option from watermark configuration.
+
+## 1.21.3 - 2026-01-24
+
+### Refactor
+- `baoyu-article-illustrator`: simplifies SKILL.md by extracting content to reference files—adds `references/usage.md` for command syntax, `references/prompt-construction.md` for prompt templates. Reorganizes workflow from 5 to 6 steps with new Pre-check phase. Adds `default_output_dir` preference option.
+
+## 1.21.2 - 2026-01-24
+
+### Features
+- `baoyu-image-gen`: adds parallel generation documentation with recommended 4 concurrent subagents for batch operations.
+
+### Documentation
+- `release-skills`: adds skill/module grouping workflow and user confirmation step before release.
+
+## 1.21.1 - 2026-01-24
+
+### Documentation
+- `baoyu-comic`: adds character sheet compression step after generation to reduce token usage when used as reference image.
+
+## 1.21.0 - 2026-01-24
+
+### Features
+- `baoyu-cover-image`: expands aspect ratio options—adds 4:3, 3:2, 3:4 ratios; changes default from 2.35:1 to 16:9 for better versatility. Aspect ratio is now always confirmed unless explicitly specified via `--aspect` flag.
+- `baoyu-image-gen`: refactors Google provider to support both Gemini multimodal and Imagen models with unified API. Adds `--imageSize` parameter support (1K/2K/4K) for Gemini models.
+
+## 1.20.0 - 2026-01-24
+
+### Features
+- `baoyu-cover-image`: upgrades from Type × Style two-dimension system to **4-dimension system**—adds `--text` dimension (none, title-only, title-subtitle, text-rich) for text density control and `--mood` dimension (subtle, balanced, bold) for emotional intensity. New `--quick` flag skips confirmation and uses auto-selection.
+
+### Documentation
+- `baoyu-cover-image`: adds dimension reference files—`references/dimensions/text.md` (text density levels) and `references/dimensions/mood.md` (mood intensity levels).
+- `baoyu-cover-image`: updates base-prompt, first-time-setup, and preferences-schema to support new 4-dimension system with v2 schema.
+- `README.md`, `README.zh.md`: updates baoyu-cover-image documentation to reflect new 4-dimension system with `--text`, `--mood`, and `--quick` options.
+
+## 1.19.0 - 2026-01-24
+
+### Features
+- `baoyu-comic`: adds partial workflow options—`--storyboard-only`, `--prompts-only`, `--images-only`, and `--regenerate N` for flexible workflow control.
+- `baoyu-image-gen`: adds `--imageSize` parameter for Google providers (1K/2K/4K), changes default quality to 2k.
+- `baoyu-image-gen`: adds `GEMINI_API_KEY` as alias for `GOOGLE_API_KEY`.
+
+### Refactor
+- `baoyu-comic`: extracts detailed workflow to `references/workflow.md`, reduces SKILL.md by ~400 lines while preserving functionality.
+- `baoyu-comic`: extracts content signal analysis to `references/auto-selection.md` and partial workflow docs to `references/partial-workflows.md`.
+- `baoyu-image-gen`: modularizes code—extracts types to `types.ts`, provider implementations to `providers/google.ts` and `providers/openai.ts`.
+
+### Documentation
+- `baoyu-comic`: improves ohmsha preset documentation with explicit default Doraemon character definitions and visual descriptions.
+
+## 1.18.3 - 2026-01-23
+
+### Documentation
+- `baoyu-comic`: improves character reference handling with explicit Strategy A/B selection—Strategy A uses `--ref` parameter for skills that support it, Strategy B embeds character descriptions in prompts for skills that don't. Includes concrete code examples for both approaches.
+
+### Fixes
+- `baoyu-image-gen`: removes unsupported Gemini models (`gemini-2.0-flash-exp-image-generation`, `gemini-2.5-flash-preview-native-audio-dialog`) from multimodal model list.
+
+## 1.18.2 - 2026-01-23
+
+### Refactor
+- Streamline SKILL.md documentation across 7 skills (`baoyu-compress-image`, `baoyu-danger-gemini-web`, `baoyu-danger-x-to-markdown`, `baoyu-image-gen`, `baoyu-post-to-wechat`, `baoyu-post-to-x`, `baoyu-url-to-markdown`) following official best practices—reduces total documentation by ~300 lines while preserving all functionality.
+
+### Documentation
+- `CLAUDE.md`: adds official skill authoring best practices link, skill loading rules, description writing guidelines, and progressive disclosure patterns.
+
+## 1.18.1 - 2026-01-23
+
+### Documentation
+- `baoyu-slide-deck`: adds detailed sub-steps (1.1-1.3) to progress checklist, marks Step 1.3 as required with explicit Bash check command for existing directory detection.
+
+## 1.18.0 - 2026-01-23
+
+### Features
+- `baoyu-slide-deck`: introduces dimension-based style system—replaces monolithic style definitions with modular 4-dimension architecture: **Texture** (clean, grid, organic, pixel, paper), **Mood** (professional, warm, cool, vibrant, dark, neutral), **Typography** (geometric, humanist, handwritten, editorial, technical), and **Density** (minimal, balanced, dense). 16 presets map to specific dimension combinations, with "Custom dimensions" option for full flexibility.
+- `baoyu-slide-deck`: adds two-round confirmation workflow—Round 1 asks style/audience/slides/review preferences, Round 2 (optional) collects custom dimension choices when user selects "Custom dimensions".
+- `baoyu-slide-deck`: adds conditional outline and prompt review—users can skip reviews for faster generation or enable them for more control.
+
+### Documentation
+- `baoyu-slide-deck`: adds dimension reference files—`references/dimensions/texture.md`, `references/dimensions/mood.md`, `references/dimensions/typography.md`, `references/dimensions/density.md`, and `references/dimensions/presets.md` (preset → dimension mapping).
+- `baoyu-slide-deck`: adds design guidelines—`references/design-guidelines.md` with audience principles, visual hierarchy, content density, color selection, typography, and font recommendations.
+- `baoyu-slide-deck`: adds layout reference—`references/layouts.md` with layout options and selection tips.
+- `baoyu-slide-deck`: adds preferences schema—`references/config/preferences-schema.md` for EXTEND.md configuration.
+
+## 1.17.1 - 2026-01-23
+
+### Refactor
+- `baoyu-infographic`: simplifies SKILL.md documentation—removes redundant content, streamlines workflow description, and improves readability.
+- `baoyu-xhs-images`: improves Step 0 (Load Preferences) documentation—adds clearer first-time setup flow with visual tables and explicit path checking instructions.
+
+### Improvements
+- `baoyu-infographic`: enhances `craft-handmade` style with strict hand-drawn enforcement—requires all imagery to maintain cartoon/illustrated aesthetic, no realistic or photographic elements.
+
+## 1.17.0 - 2026-01-23
+
+### Features
+- `baoyu-cover-image`: adds user preferences support via EXTEND.md—configure watermark (content, position, opacity), preferred type/style, default aspect ratio, and custom styles. New Step 0 checks for preferences at project (`.baoyu-skills/`) or user (`~/.baoyu-skills/`) level with first-time setup flow.
+
+### Refactor
+- `baoyu-cover-image`: restructures to Type × Style two-dimension system—adds 6 types (`hero`, `conceptual`, `typography`, `metaphor`, `scene`, `minimal`) that control visual composition, while 20 styles control aesthetics. New `--type` and `--aspect` options, Type × Style compatibility matrix, and structured workflow with progress checklist.
+
+### Documentation
+- `baoyu-cover-image`: adds three reference documents—`references/config/preferences-schema.md` (EXTEND.md YAML schema), `references/config/first-time-setup.md` (setup flow), `references/config/watermark-guide.md` (watermark configuration).
+- `README.md`, `README.zh.md`: updates baoyu-cover-image documentation to reflect new Type × Style system with `--type` and `--aspect` options.
+
+## 1.16.0 - 2026-01-23
+
+### Features
+- `baoyu-article-illustrator`: adds user preferences support via EXTEND.md—configure watermark (content, position, opacity), preferred type/style, and custom styles. New Step 1.1 checks for preferences at project (`.baoyu-skills/`) or user (`~/.baoyu-skills/`) level with first-time setup flow.
+
+### Refactor
+- `baoyu-article-illustrator`: restructures to Type × Style two-dimension system—replaces 20+ single-dimension styles with modular Type (infographic, scene, flowchart, comparison, framework, timeline) × Style (notion, elegant, warm, minimal, blueprint, watercolor, editorial, scientific) architecture. Adds `--type` and `--density` options, Type × Style compatibility matrix, and structured prompt construction templates.
+
+### Documentation
+- `baoyu-article-illustrator`: adds three reference documents—`references/styles.md` (style gallery and compatibility matrix), `references/config/preferences-schema.md` (EXTEND.md YAML schema), `references/config/first-time-setup.md` (setup flow).
+- `README.md`, `README.zh.md`: updates baoyu-article-illustrator documentation to reflect new Type × Style system with `--type` and `--style` options.
+
+## 1.15.3 - 2026-01-23
+
+### Refactor
+- `baoyu-comic`: restructures style system into 3-dimension architecture—replaces 10 monolithic style files with modular `art-styles/` (5 styles: ligne-claire, manga, realistic, ink-brush, chalk), `tones/` (7 moods: neutral, warm, dramatic, romantic, energetic, vintage, action), and `presets/` (3 shortcuts: ohmsha, wuxia, shoujo). New art × tone × layout system enables flexible combinations while presets preserve special rules for specific genres.
+
+### Documentation
+- `release-skills`: adds Step 5 (Check README Updates)—ensures README documentation stays in sync with code changes during releases.
+- `README.md`, `README.zh.md`: updates baoyu-comic documentation to reflect new `--art` and `--tone` options replacing `--style`.
+
 ## 1.15.2 - 2026-01-23

 ### Documentation
@@ -23,7 +265,7 @@ English | [中文](./CHANGELOG.zh.md)
 ## 1.14.0 - 2026-01-22

 ### Fixes
- `baoyu-post-to-x`: improves video ready detection for more reliable video posting.
+- `baoyu-post-to-x`: improves video ready detection for more reliable video posting (by @fkysly).

 ### Documentation
 - `baoyu-slide-deck`: comprehensive SKILL.md enhancement—adds slide count guidance (recommended 8-25, max 30), audience guidelines table with audience-specific principles, style selection principles with content-type recommendations, layout selection tips with common mistakes to avoid, visual hierarchy principles, content density guidelines (McKinsey-style high-density principles), color selection guide, typography principles with font recommendations (English and Chinese fonts with multilingual pairing), and visual elements reference (backgrounds, typography treatments, geometric accents).
@@ -38,6 +280,9 @@ English | [中文](./CHANGELOG.zh.md)

 ## 1.12.0 - 2026-01-21

+### Features
+- `baoyu-post-to-x`: adds quote tweet support (by @threehotpot-bot).
+
 ### Refactor
 - `baoyu-post-to-x`: extracts shared utilities to `x-utils.ts`—consolidates Chrome detection, CDP connection, clipboard operations, and helper functions from `x-article.ts`, `x-browser.ts`, `x-quote.ts`, and `x-video.ts` into a single reusable module.

@@ -53,7 +298,7 @@ English | [中文](./CHANGELOG.zh.md)
 ## 1.10.0 - 2026-01-21

 ### Features
- `baoyu-post-to-x`: adds video posting support—new `x-video.ts` script for posting text with video files (MP4, MOV, WebM). Supports preview mode and handles video processing timeouts.
+- `baoyu-post-to-x`: adds video posting support—new `x-video.ts` script for posting text with video files (MP4, MOV, WebM). Supports preview mode and handles video processing timeouts (by @fkysly).

 ## 1.9.0 - 2026-01-20

@@ -109,7 +354,7 @@ English | [中文](./CHANGELOG.zh.md)
 ## 1.4.1 - 2026-01-18

 ### Fixes
- `baoyu-post-to-x`: supports multi-language UI selectors for X Articles (contributed by [@ianchenx](https://github.com/ianchenx)).
+- `baoyu-post-to-x`: supports multi-language UI selectors for X Articles (by @ianchenx).

 ## 1.4.0 - 2026-01-18

@@ -2,6 +2,248 @@

 [English](./CHANGELOG.md) | 中文

+## 1.28.0 - 2026-02-01
+
+### 新功能
+- `baoyu-cover-image`：新增参考图片支持（`--ref` 参数），支持 direct/style/palette 三种用法；新增视觉元素库，按主题分类图标词汇。
+- `baoyu-article-illustrator`：新增参考图片支持，支持 direct/style/palette 三种用法。
+- `baoyu-post-to-wechat`：新增 `newspic` 图文消息类型支持。
+
+### 重构
+- `baoyu-cover-image`、`baoyu-article-illustrator`、`baoyu-comic`、`baoyu-xhs-images`：强化首次设置为阻塞操作，必须在其他工作流步骤之前完成。
+- `baoyu-cover-image`：移除标题字符数限制，使用原始来源标题。
+
+## 1.26.1 - 2026-01-29
+
+### 新功能
+- `baoyu-article-illustrator`、`baoyu-comic`、`baoyu-cover-image`、`baoyu-infographic`、`baoyu-slide-deck`、`baoyu-xhs-images`：新增文件备份规则，覆盖前自动将现有源文件、提示词和图片重命名为带时间戳后缀的备份文件。
+
+### 修复
+- `baoyu-xhs-images`：移除 `notebook` 风格（保留 10 种风格）。
+
+## 1.26.0 - 2026-01-29
+
+### 新功能
+- `baoyu-xhs-images`：新增 `notebook` 风格（水彩渲染手绘信息图 + 莫兰迪配色）和 `study-notes` 风格（真实手写照片美学）。
+- `baoyu-xhs-images`：新增 `mindmap`（中心发散式）和 `quadrant`（四象限）布局。
+
+## 1.25.4 - 2026-01-29
+
+### 修复
+- `baoyu-markdown-to-html`：生成带 `data-local-path` 属性的 `<img>` 标签，而非纯文本占位符。
+- `baoyu-post-to-wechat`：修复 API 发布时从 `data-local-path` 属性读取图片路径；修复发布 HTML 文件时从对应 `.md` 的 frontmatter 提取标题和封面图。
+- `baoyu-post-to-wechat`：修复命令行参数解析，正确跳过未知参数；新增 `--summary` 参数支持。
+- `baoyu-post-to-wechat`：修复浏览器发布模式，粘贴前将 `<img>` 标签转换回文本占位符。
+
+## 1.25.3 - 2026-01-28
+
+### 新功能
+- `baoyu-format-markdown`：新增内容类型检测，对已有 markdown 格式的文件提供用户确认选项；新增 CJK 配对标点处理，将括号、引号等标点移出加粗标记外。
+
+## 1.25.2 - 2026-01-28
+
+### 文档
+- `baoyu-post-to-wechat`：README 新增微信公众号 API 凭证配置说明。
+
+## 1.25.1 - 2026-01-28
+
+### 新功能
+- `baoyu-markdown-to-html`：新增中文内容预检查，建议在转换前使用 `baoyu-format-markdown` 格式化以修复加粗标点问题。
+
+## 1.25.0 - 2026-01-28
+
+### 新功能
+- `baoyu-format-markdown`：新增 markdown 格式化技能，支持 frontmatter、排版优化和中英文空格处理。
+- `baoyu-markdown-to-html`：新增 markdown 转 HTML 技能，支持微信兼容主题、代码高亮、数学公式、PlantUML 和 alerts。
+- `baoyu-post-to-wechat`：新增 API 发布方式和外部主题支持。
+
+## 1.24.4 - 2026-01-28
+
+### 修复
+- `baoyu-post-to-x`：修复封面图上传后 Apply 按钮点击问题；增加重试逻辑并等待弹窗关闭后再继续。
+
+## 1.24.3 - 2026-01-28
+
+### 文档
+- 在修改工作流中强调先更新提示词文件再生成图片（article-illustrator、slide-deck、xhs-images、cover-image、comic）。
+
+## 1.24.2 - 2026-01-28
+
+### 重构
+- `baoyu-image-gen`：默认改为顺序生成图片；并行生成需明确请求。
+
+## 1.24.1 - 2026-01-28
+
+### 新功能
+- `baoyu-image-gen`：新增阿里云通义万象（DashScope）文生图模型支持 (by @JianJang2017)。
+
+### 文档
+- README 中新增阿里云文生图模型配置说明。
+
+## 1.24.0 - 2026-01-27
+
+### 新功能
+- `baoyu-post-to-wechat`：复用已打开的 Chrome 浏览器，无需关闭所有窗口 (by @AliceLJY)。
+
+### 修复
+- `baoyu-post-to-wechat`：改进标题提取，支持 h1/h2 标题；新增摘要自动填充和粘贴/输入后内容验证；支持 HTML meta 标签属性顺序灵活匹配。
+
+### 文档
+- `release-skills`：在发布流程中新增第三方贡献者署名规则。
+- 补全历史 changelog 中缺失的第三方贡献者署名。
+
+## 1.23.1 - 2026-01-27
+
+### 修复
+- `baoyu-compress-image`：压缩后将原始文件重命名为 `_original` 备份，不再删除。
+
+## 1.23.0 - 2026-01-26
+
+### 重构
+- `baoyu-cover-image`：将 20 种固定风格替换为五维系统（类型 × 配色 × 渲染 × 文字 × 氛围）。9 种配色方案 × 6 种渲染风格 = 54 种组合。新增风格预设实现向后兼容，v2→v3 配置迁移，以及新的引用文件结构（`palettes/`、`renderings/`、`workflow/`）。
+
+## 1.22.0 - 2026-01-25
+
+### 新功能
+- `baoyu-article-illustrator`：新增 `imgs-subdir` 输出目录选项；改进风格选择，始终询问并展示 EXTEND.md 中的 preferred_style。
+- `baoyu-cover-image`：新增 `default_output_dir` 偏好设置，支持 `same-dir`、`imgs-subdir` 和 `independent` 选项，新增 Step 1.5 输出目录选择流程。
+- `baoyu-post-to-wechat`：发布前新增主题选择（default/grace/simple）；新增 HTML 预览步骤；图片占位符简化为 `WECHATIMGPH_N` 格式；重构复制粘贴为跨平台辅助函数。
+
+### 重构
+- `baoyu-post-to-x`：图片占位符从 `[[IMAGE_PLACEHOLDER_N]]` 简化为 `XIMGPH_N` 格式。
+
+## 1.21.4 - 2026-01-25
+
+### 修复
+- `baoyu-post-to-wechat`：新增 Windows 兼容性——使用 `fileURLToPath` 正确解析路径，将系统依赖的复制粘贴工具（osascript/xdotool）替换为 CDP 键盘事件，实现跨平台支持 (by @JadeLiang003)。
+- `baoyu-post-to-wechat`：修复 Windows 兼容性 PR 引入的回退问题——修正错误的 `-fixed` 文件名引用、恢复 frontmatter 引号剥离、恢复 `--title` CLI 参数、修复摘要提取逻辑以正确跳过标题/引用/列表、修复单横线参数解析、移除调试日志。
+- `baoyu-article-illustrator`、`baoyu-cover-image`、`baoyu-xhs-images`：移除水印配置中的透明度选项。
+
+## 1.21.3 - 2026-01-24
+
+### 重构
+- `baoyu-article-illustrator`：简化 SKILL.md，提取内容至引用文件——新增 `references/usage.md` 用于命令语法，`references/prompt-construction.md` 用于提示词模板。工作流从 5 步重组为 6 步，新增 Pre-check 预检阶段。新增 `default_output_dir` 偏好设置选项。
+
+## 1.21.2 - 2026-01-24
+
+### 新功能
+- `baoyu-image-gen`：添加并行生成文档，推荐使用 4 个并发 subagent 进行批量操作。
+
+### 文档
+- `release-skills`：新增按 skill/module 分组提交流程和发布前用户确认步骤。
+
+## 1.21.1 - 2026-01-24
+
+### 文档
+- `baoyu-comic`：在角色参考图生成后添加压缩步骤，减少作为参考图使用时的 token 消耗。
+
+## 1.21.0 - 2026-01-24
+
+### 新功能
+- `baoyu-cover-image`：扩展宽高比选项——新增 4:3、3:2、3:4 比例；默认值从 2.35:1 改为 16:9 以提高通用性。现在除非通过 `--aspect` 标志明确指定，否则始终确认宽高比。
+- `baoyu-image-gen`：重构 Google provider 以统一支持 Gemini 多模态和 Imagen 模型。为 Gemini 模型新增 `--imageSize` 参数支持（1K/2K/4K）。
+
+## 1.20.0 - 2026-01-24
+
+### 新功能
+- `baoyu-cover-image`：从类型 × 风格二维系统升级为**四维系统**——新增 `--text` 维度（none 无文字、title-only 仅标题、title-subtitle 标题+副标题、text-rich 丰富文字）控制文字密度，新增 `--mood` 维度（subtle 低调、balanced 平衡、bold 醒目）控制情感强度。新增 `--quick` 标志跳过确认，直接使用自动选择。
+
+### 文档
+- `baoyu-cover-image`：新增维度参考文件——`references/dimensions/text.md`（文字密度级别）和 `references/dimensions/mood.md`（氛围强度级别）。
+- `baoyu-cover-image`：更新 base-prompt、first-time-setup 和 preferences-schema 以支持新的四维系统及 v2 配置模式。
+- `README.md`、`README.zh.md`：更新 baoyu-cover-image 文档，反映新的四维系统及 `--text`、`--mood`、`--quick` 选项。
+
+## 1.19.0 - 2026-01-24
+
+### 新功能
+- `baoyu-comic`：新增部分工作流选项——`--storyboard-only`、`--prompts-only`、`--images-only` 和 `--regenerate N`，实现灵活的工作流控制。
+- `baoyu-image-gen`：新增 `--imageSize` 参数用于 Google 提供商（1K/2K/4K），默认质量改为 2k。
+- `baoyu-image-gen`：新增 `GEMINI_API_KEY` 作为 `GOOGLE_API_KEY` 的别名。
+
+### 重构
+- `baoyu-comic`：将详细工作流提取至 `references/workflow.md`，SKILL.md 减少约 400 行，功能完整保留。
+- `baoyu-comic`：将内容信号分析提取至 `references/auto-selection.md`，部分工作流文档提取至 `references/partial-workflows.md`。
+- `baoyu-image-gen`：代码模块化——类型定义提取至 `types.ts`，provider 实现提取至 `providers/google.ts` 和 `providers/openai.ts`。
+
+### 文档
+- `baoyu-comic`：改进 ohmsha 预设文档，明确默认哆啦A梦角色定义和视觉描述。
+
+## 1.18.3 - 2026-01-23
+
+### 文档
+- `baoyu-comic`：改进角色参考处理流程，新增明确的 Strategy A/B 选择逻辑——Strategy A 使用 `--ref` 参数（适用于支持该参数的技能），Strategy B 将角色描述嵌入提示词（适用于不支持的技能）。包含两种方法的具体代码示例。
+
+### 修复
+- `baoyu-image-gen`：从多模态模型列表中移除不支持的 Gemini 模型（`gemini-2.0-flash-exp-image-generation`、`gemini-2.5-flash-preview-native-audio-dialog`）。
+
+## 1.18.2 - 2026-01-23
+
+### 重构
+- 精简 7 个技能的 SKILL.md 文档（`baoyu-compress-image`、`baoyu-danger-gemini-web`、`baoyu-danger-x-to-markdown`、`baoyu-image-gen`、`baoyu-post-to-wechat`、`baoyu-post-to-x`、`baoyu-url-to-markdown`），遵循官方最佳实践——总文档量减少约 300 行，功能完整保留。
+
+### 文档
+- `CLAUDE.md`：新增官方技能编写最佳实践链接、技能加载规则、描述编写指南和渐进式披露模式。
+
+## 1.18.1 - 2026-01-23
+
+### 文档
+- `baoyu-slide-deck`：进度清单新增详细子步骤（1.1-1.3），标记 Step 1.3 为必须步骤并提供明确的 Bash 检查命令用于检测已存在目录。
+
+## 1.18.0 - 2026-01-23
+
+### 新功能
+- `baoyu-slide-deck`：引入基于维度的风格系统——将单一风格定义重构为模块化四维架构：**纹理** (clean 纯净、grid 网格、organic 有机、pixel 像素、paper 纸张)、**氛围** (professional 专业、warm 温暖、cool 冷静、vibrant 鲜艳、dark 暗色、neutral 中性)、**字体** (geometric 几何、humanist 人文、handwritten 手写、editorial 编辑、technical 技术)、**密度** (minimal 极简、balanced 均衡、dense 密集)。16 种预设映射到特定维度组合，并提供「自定义维度」选项实现完全灵活配置。
+- `baoyu-slide-deck`：新增两轮确认工作流——第一轮询问风格/受众/页数/审核偏好，第二轮（可选）在用户选择「自定义维度」时收集具体维度选择。
+- `baoyu-slide-deck`：新增条件性大纲和提示词审核——用户可跳过审核以加快生成，或启用审核以获得更多控制。
+
+### 文档
+- `baoyu-slide-deck`：新增维度参考文件——`references/dimensions/texture.md`、`references/dimensions/mood.md`、`references/dimensions/typography.md`、`references/dimensions/density.md`，以及 `references/dimensions/presets.md`（预设到维度的映射）。
+- `baoyu-slide-deck`：新增设计指南——`references/design-guidelines.md`，包含受众原则、视觉层次、内容密度、配色选择、字体排版和字体推荐。
+- `baoyu-slide-deck`：新增布局参考——`references/layouts.md`，包含布局选项和选择技巧。
+- `baoyu-slide-deck`：新增偏好配置模式——`references/config/preferences-schema.md`，用于 EXTEND.md 配置。
+
+## 1.17.1 - 2026-01-23
+
+### 重构
+- `baoyu-infographic`：精简 SKILL.md 文档——移除冗余内容，优化工作流描述，提升可读性。
+- `baoyu-xhs-images`：优化 Step 0（加载偏好设置）文档——新增更清晰的首次设置流程，使用可视化表格和明确的路径检查指令。
+
+### 改进
+- `baoyu-infographic`：增强 `craft-handmade` 风格的手绘规则——要求所有图像必须保持卡通/插画风格，禁止写实或照片元素。
+
+## 1.17.0 - 2026-01-23
+
+### 新功能
+- `baoyu-cover-image`：新增用户偏好设置支持（通过 EXTEND.md 配置）——可设置水印（内容、位置、透明度）、首选类型/风格、默认宽高比和自定义风格。新增 Step 0 检查项目级（`.baoyu-skills/`）或用户级（`~/.baoyu-skills/`）偏好设置，首次使用时引导设置。
+
+### 重构
+- `baoyu-cover-image`：重构为类型 × 风格二维系统——新增 6 种类型（`hero` 主视觉、`conceptual` 概念、`typography` 文字、`metaphor` 隐喻、`scene` 场景、`minimal` 极简）控制视觉构图，20 种风格控制美学表现。新增 `--type` 和 `--aspect` 选项、类型 × 风格兼容性矩阵，以及带进度清单的结构化工作流。
+
+### 文档
+- `baoyu-cover-image`：新增三个参考文档——`references/config/preferences-schema.md`（EXTEND.md YAML 配置模式）、`references/config/first-time-setup.md`（首次设置流程）、`references/config/watermark-guide.md`（水印配置指南）。
+- `README.md`、`README.zh.md`：更新 baoyu-cover-image 文档，反映新的类型 × 风格系统及 `--type` 和 `--aspect` 选项。
+
+## 1.16.0 - 2026-01-23
+
+### 新功能
+- `baoyu-article-illustrator`：新增用户偏好设置支持（通过 EXTEND.md 配置）——可设置水印（内容、位置、透明度）、首选类型/风格和自定义风格。新增 Step 1.1 检查项目级（`.baoyu-skills/`）或用户级（`~/.baoyu-skills/`）偏好设置，首次使用时引导设置。
+
+### 重构
+- `baoyu-article-illustrator`：重构为类型 × 风格二维系统——将 20+ 种单维风格替换为模块化的类型（infographic 信息图、scene 场景、flowchart 流程图、comparison 对比、framework 框架、timeline 时间线）× 风格（notion、elegant、warm、minimal、blueprint、watercolor、editorial、scientific）架构。新增 `--type` 和 `--density` 选项、类型 × 风格兼容性矩阵，以及结构化提示词构建模板。
+
+### 文档
+- `baoyu-article-illustrator`：新增三个参考文档——`references/styles.md`（风格库和兼容性矩阵）、`references/config/preferences-schema.md`（EXTEND.md YAML 配置模式）、`references/config/first-time-setup.md`（首次设置流程）。
+- `README.md`、`README.zh.md`：更新 baoyu-article-illustrator 文档，反映新的类型 × 风格系统及 `--type` 和 `--style` 选项。
+
+## 1.15.3 - 2026-01-23
+
+### 重构
+- `baoyu-comic`：风格系统重构为三维架构——将 10 个单一风格文件拆分为模块化的 `art-styles/`（5 种画风：ligne-claire 清线、manga 日漫、realistic 写实、ink-brush 水墨、chalk 粉笔）、`tones/`（7 种基调：neutral 中性、warm 温馨、dramatic 戏剧、romantic 浪漫、energetic 活力、vintage 复古、action 动作）和 `presets/`（3 种预设：ohmsha、wuxia 武侠、shoujo 少女漫画）。新的画风 × 基调 × 布局系统支持灵活组合，同时预设保留特定类型的专属规则。
+
+### 文档
+- `release-skills`：新增 Step 5（检查 README 更新）——确保发布时 README 文档与代码变更保持同步。
+- `README.md`、`README.zh.md`：更新 baoyu-comic 文档，反映新的 `--art` 和 `--tone` 选项（替代原 `--style`）。
+
 ## 1.15.2 - 2026-01-23

 ### 文档
@@ -23,7 +265,7 @@
 ## 1.14.0 - 2026-01-22

 ### 修复
- `baoyu-post-to-x`：改进视频就绪检测，提升视频发布稳定性。
+- `baoyu-post-to-x`：改进视频就绪检测，提升视频发布稳定性 (by @fkysly)。

 ### 文档
 - `baoyu-slide-deck`：SKILL.md 全面增强——新增幻灯片数量指南（推荐 8-25 张，最多 30 张）、受众指南表格及各受众特定原则、风格选择原则与内容类型推荐、布局选择技巧与常见错误提示、视觉层次原则、内容密度指南（麦肯锡风格高密度原则）、配色选择指南、字体排版原则与字体推荐（中英文字体及多语言搭配方案）、视觉元素参考（背景处理、字体处理、几何装饰）。
@@ -38,6 +280,9 @@

 ## 1.12.0 - 2026-01-21

+### 新功能
+- `baoyu-post-to-x`：新增引用推文（Quote Tweet）支持 (by @threehotpot-bot)。
+
 ### 重构
 - `baoyu-post-to-x`：提取公共工具函数到 `x-utils.ts`——将 `x-article.ts`、`x-browser.ts`、`x-quote.ts`、`x-video.ts` 中重复的 Chrome 检测、CDP 连接、剪贴板操作等功能整合为统一的可复用模块。

@@ -53,7 +298,7 @@
 ## 1.10.0 - 2026-01-21

 ### 新功能
- `baoyu-post-to-x`：新增视频发布支持——新增 `x-video.ts` 脚本，支持发布带视频的推文（MP4、MOV、WebM 格式）。支持预览模式，自动处理视频上传等待。
+- `baoyu-post-to-x`：新增视频发布支持——新增 `x-video.ts` 脚本，支持发布带视频的推文（MP4、MOV、WebM 格式）。支持预览模式，自动处理视频上传等待 (by @fkysly)。

 ## 1.9.0 - 2026-01-20

@@ -109,7 +354,7 @@
 ## 1.4.1 - 2026-01-18

 ### 修复
- `baoyu-post-to-x`：支持 X Articles 多语言 UI 选择器（感谢 [@ianchenx](https://github.com/ianchenx) 贡献）。
+- `baoyu-post-to-x`：支持 X Articles 多语言 UI 选择器 (by @ianchenx)。

 ## 1.4.0 - 2026-01-18

@@ -78,6 +78,20 @@ npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --promptfiles system.m

 `.claude-plugin/marketplace.json` defines plugin metadata and skill paths. Version follows semver.

+## Skill Loading Rules
+
+**IMPORTANT**: When working in this project, follow these rules:
+
+| Rule | Description |
+|------|-------------|
+| **Load project skills first** | MUST load all skills from `skills/` directory in current project. Project skills take priority over system/user-level skills with same name. |
+| **Default image generation** | When image generation is needed, use `skills/baoyu-image-gen/SKILL.md` by default (unless user specifies otherwise). |
+
+**Loading Priority** (highest → lowest):
+1. Current project `skills/` directory
+2. User-level skills (`$HOME/.baoyu-skills/`)
+3. System-level skills
+
 ## Release Process

 **IMPORTANT**: When user requests release/发布/push, ALWAYS use `/release-skills` workflow.
@@ -92,6 +106,22 @@ npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --promptfiles system.m

 **IMPORTANT**: All skills MUST use `baoyu-` prefix to avoid conflicts when users import this plugin.

+**REQUIRED READING**: Before creating a new skill, read the official [Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices).
+
+### Key Requirements from Official Best Practices
+
+| Requirement | Details |
+|-------------|---------|
+| **Concise is key** | Claude is smart—only add context it doesn't have. Challenge each token. |
+| **name field** | Max 64 chars, lowercase letters/numbers/hyphens only, no "anthropic"/"claude" |
+| **description field** | Max 1024 chars, non-empty, MUST be third person, include what + when to use |
+| **SKILL.md body** | Keep under 500 lines; use separate files for additional content |
+| **Naming convention** | Gerund form preferred (e.g., `processing-pdfs`), but `baoyu-` prefix required here |
+| **References** | Keep one level deep from SKILL.md; avoid nested references |
+| **No time-sensitive info** | Avoid dates/versions that become outdated |
+
+### Steps
+
 1. Create `skills/baoyu-<name>/SKILL.md` with YAML front matter
   - Directory name: `baoyu-<name>`
   - SKILL.md `name` field: `baoyu-<name>`
@@ -119,6 +149,21 @@ npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --promptfiles system.m
 - `description`: Brief description of the category
 - `skills`: Array with the skill path

+### Writing Effective Descriptions
+
+**MUST write in third person** (not "I can help you" or "You can use this"):
+
+```yaml
+# Good
+description: Generates Xiaohongshu infographic series from content. Use when user asks for "小红书图片", "XHS images", or "RedNote infographics".
+
+# Bad
+description: I can help you create Xiaohongshu images
+description: You can use this to generate XHS content
+```
+
+Include both **what** the skill does and **when** to use it (triggers/keywords).
+
 ### Script Directory Template

 Every SKILL.md with scripts MUST include this section after Usage:
@@ -142,6 +187,26 @@ Every SKILL.md with scripts MUST include this section after Usage:

 When referencing scripts in workflow sections, use `${SKILL_DIR}/scripts/<name>.ts` so agents can resolve the correct path.

+### Progressive Disclosure
+
+For skills with extensive content, use separate reference files:
+
+```
+skills/baoyu-example/
+├── SKILL.md              # Main instructions (<500 lines)
+├── references/
+│   ├── styles.md         # Style definitions (loaded as needed)
+│   └── examples.md       # Usage examples (loaded as needed)
+└── scripts/
+    └── main.ts           # Executable script
+```
+
+In SKILL.md, link to reference files (one level deep only):
+```markdown
+**Available styles**: See [references/styles.md](references/styles.md)
+**Examples**: See [references/examples.md](references/examples.md)
+```
+
 ## Code Style

 - TypeScript throughout, no comments
@@ -155,9 +220,11 @@ Skills that require image generation MUST delegate to available image generation

 ### Image Generation Skill Selection

-1. Check available image generation skills in `skills/` directory
-2. Read each skill's SKILL.md to understand parameters and capabilities
-3. If multiple image generation skills available, ask user to choose preferred skill
+**Default**: Use `skills/baoyu-image-gen/SKILL.md` (unless user specifies otherwise).
+
+1. Read `skills/baoyu-image-gen/SKILL.md` for parameters and capabilities
+2. If user explicitly requests a different skill, check `skills/` directory for alternatives
+3. Only ask user to choose when they haven't specified and multiple viable options exist

 ### Generation Flow Template

@@ -298,18 +365,66 @@ READMEs use 3-column tables for style previews:

 ## Extension Support

-Every SKILL.md MUST include an Extension Support section at the end:
+Every SKILL.md MUST include two parts for extension support:
+
+### 1. Load Preferences Section (in Step 1 or as "Preferences" section)
+
+For skills with workflows, add as Step 1.1. For utility skills, add as "Preferences (EXTEND.md)" section before Usage:
+
+```markdown
+**1.1 Load Preferences (EXTEND.md)**
+
+Use Bash to check EXTEND.md existence (priority order):
+
+\`\`\`bash
+# Check project-level first
+test -f .baoyu-skills/<skill-name>/EXTEND.md && echo "project"
+
+# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
+test -f "$HOME/.baoyu-skills/<skill-name>/EXTEND.md" && echo "user"
+\`\`\`
+
+┌────────────────────────────────────────────┬───────────────────┐
+│                    Path                    │     Location      │
+├────────────────────────────────────────────┼───────────────────┤
+│ .baoyu-skills/<skill-name>/EXTEND.md       │ Project directory │
+├────────────────────────────────────────────┼───────────────────┤
+│ $HOME/.baoyu-skills/<skill-name>/EXTEND.md │ User home         │
+└────────────────────────────────────────────┴───────────────────┘
+
+┌───────────┬───────────────────────────────────────────────────────────────────────────┐
+│  Result   │                                  Action                                   │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Found     │ Read, parse, display summary                                              │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Not found │ Ask user with AskUserQuestion (see references/config/first-time-setup.md) │
+└───────────┴───────────────────────────────────────────────────────────────────────────┘
+
+**EXTEND.md Supports**: [List supported configuration options for this skill]
+
+Schema: `references/config/preferences-schema.md`
+```
+
+### 2. Extension Support Section (at the end)
+
+Simplified section that references the preferences section:

 ```markdown
 ## Extension Support

-Custom styles and configurations via EXTEND.md.
-
-**Check paths** (priority order):
-1. `.baoyu-skills/<skill-name>/EXTEND.md` (project)
-2. `~/.baoyu-skills/<skill-name>/EXTEND.md` (user)
-
-If found, load before Step 1. Extension content overrides defaults.
+Custom configurations via EXTEND.md. See **Step 1.1** for paths and supported options.
 ```

-Replace `<skill-name>` with the actual skill name (e.g., `baoyu-cover-image`).
+Or for utility skills without workflow steps:
+
+```markdown
+## Extension Support
+
+Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.
+```
+
+**Notes**:
+- Replace `<skill-name>` with actual skill name (e.g., `baoyu-cover-image`)
+- Use `$HOME` instead of `~` for cross-platform compatibility (macOS/Linux/WSL)
+- Use `test -f` Bash command for explicit file existence check
+- ASCII tables for clear visual formatting
@@ -55,7 +55,7 @@ Simply tell Claude Code:
 |--------|-------------|--------|
 | **content-skills** | Content generation and publishing | [xhs-images](#baoyu-xhs-images), [infographic](#baoyu-infographic), [cover-image](#baoyu-cover-image), [slide-deck](#baoyu-slide-deck), [comic](#baoyu-comic), [article-illustrator](#baoyu-article-illustrator), [post-to-x](#baoyu-post-to-x), [post-to-wechat](#baoyu-post-to-wechat) |
 | **ai-generation-skills** | AI-powered generation backends | [image-gen](#baoyu-image-gen), [danger-gemini-web](#baoyu-danger-gemini-web) |
-| **utility-skills** | Utility tools for content processing | [url-to-markdown](#baoyu-url-to-markdown), [danger-x-to-markdown](#baoyu-danger-x-to-markdown), [compress-image](#baoyu-compress-image) |
+| **utility-skills** | Utility tools for content processing | [url-to-markdown](#baoyu-url-to-markdown), [danger-x-to-markdown](#baoyu-danger-x-to-markdown), [compress-image](#baoyu-compress-image), [format-markdown](#baoyu-format-markdown) |

 ## Update Skills

@@ -245,40 +245,35 @@ Generate professional infographics with 20 layout types and 17 visual styles. An

 #### baoyu-cover-image

-Generate hand-drawn style cover images for articles with multiple style options.
+Generate cover images for articles with 5 dimensions: Type × Palette × Rendering × Text × Mood. Combines 9 color palettes with 6 rendering styles for 54 unique combinations.

 ```bash
-# From markdown file (auto-select style)
+# Auto-select all dimensions based on content
 /baoyu-cover-image path/to/article.md

-# Specify a style
-/baoyu-cover-image path/to/article.md --style tech
-/baoyu-cover-image path/to/article.md --style warm
+# Quick mode: skip confirmation, use auto-selection
+/baoyu-cover-image path/to/article.md --quick

-# Without title text
+# Specify dimensions (5D system)
+/baoyu-cover-image path/to/article.md --type conceptual --palette cool --rendering digital
+/baoyu-cover-image path/to/article.md --text title-subtitle --mood bold
+
+# Style presets (backward-compatible shorthand)
+/baoyu-cover-image path/to/article.md --style blueprint
+
+# Specify aspect ratio (default: 16:9)
+/baoyu-cover-image path/to/article.md --aspect 2.35:1
+
+# Visual only (no title text)
 /baoyu-cover-image path/to/article.md --no-title
 ```

-Available styles: `elegant` (default), `blueprint`, `bold-editorial`, `chalkboard`, `dark-atmospheric`, `editorial-infographic`, `fantasy-animation`, `flat-doodle`, `intuition-machine`, `minimal`, `nature`, `notion`, `pixel-art`, `playful`, `retro`, `sketch-notes`, `vector-illustration`, `vintage`, `warm`, `watercolor`
-
-**Style Previews**:
-
-| | | |
-|:---:|:---:|:---:|
-| ![elegant](./screenshots/cover-image-styles/elegant.webp) | ![blueprint](./screenshots/cover-image-styles/blueprint.webp) | ![bold-editorial](./screenshots/cover-image-styles/bold-editorial.webp) |
-| elegant | blueprint | bold-editorial |
-| ![chalkboard](./screenshots/cover-image-styles/chalkboard.webp) | ![dark-atmospheric](./screenshots/cover-image-styles/dark-atmospheric.webp) | ![editorial-infographic](./screenshots/cover-image-styles/editorial-infographic.webp) |
-| chalkboard | dark-atmospheric | editorial-infographic |
-| ![fantasy-animation](./screenshots/cover-image-styles/fantasy-animation.webp) | ![intuition-machine](./screenshots/cover-image-styles/intuition-machine.webp) | ![minimal](./screenshots/cover-image-styles/minimal.webp) |
-| fantasy-animation | intuition-machine | minimal |
-| ![nature](./screenshots/cover-image-styles/nature.webp) | ![notion](./screenshots/cover-image-styles/notion.webp) | ![pixel-art](./screenshots/cover-image-styles/pixel-art.webp) |
-| nature | notion | pixel-art |
-| ![playful](./screenshots/cover-image-styles/playful.webp) | ![retro](./screenshots/cover-image-styles/retro.webp) | ![sketch-notes](./screenshots/cover-image-styles/sketch-notes.webp) |
-| playful | retro | sketch-notes |
-| ![vector-illustration](./screenshots/cover-image-styles/vector-illustration.webp) | ![vintage](./screenshots/cover-image-styles/vintage.webp) | ![warm](./screenshots/cover-image-styles/warm.webp) |
-| vector-illustration | vintage | warm |
-| ![watercolor](./screenshots/cover-image-styles/watercolor.webp) | ![flat-doodle](./screenshots/cover-image-styles/flat-doodle.webp) | |
-| watercolor | flat-doodle | |
+**Five Dimensions**:
+- **Type**: `hero`, `conceptual`, `typography`, `metaphor`, `scene`, `minimal`
+- **Palette**: `warm`, `elegant`, `cool`, `dark`, `earth`, `vivid`, `pastel`, `mono`, `retro`
+- **Rendering**: `flat-vector`, `hand-drawn`, `painterly`, `digital`, `pixel`, `chalk`
+- **Text**: `none`, `title-only` (default), `title-subtitle`, `text-rich`
+- **Mood**: `subtle`, `balanced` (default), `bold`

 #### baoyu-slide-deck

@@ -292,6 +287,9 @@ Generate professional slide deck images from content. Creates comprehensive outl
 /baoyu-slide-deck path/to/article.md --style corporate
 /baoyu-slide-deck path/to/article.md --audience executives

+# Target slide count
+/baoyu-slide-deck path/to/article.md --slides 15
+
 # Outline only (no image generation)
 /baoyu-slide-deck path/to/article.md --outline-only

@@ -299,25 +297,50 @@ Generate professional slide deck images from content. Creates comprehensive outl
 /baoyu-slide-deck path/to/article.md --lang zh
 ```

-**Styles** (visual aesthetics):
+**Options**:

-| Style | Description | Best For |
-|-------|-------------|----------|
-| `blueprint` (default) | Technical schematics, grid texture, engineering precision | Architecture, system design |
-| `notion` | SaaS dashboard aesthetic, card-based layouts, clean data focus | Product demos, SaaS, B2B |
-| `bold-editorial` | High-impact magazine style, bold typography, dark backgrounds | Product launches, keynotes |
-| `corporate` | Navy/gold palette, structured layouts, professional icons | Investor decks, proposals |
-| `dark-atmospheric` | Cinematic dark mode, glowing accents, atmospheric depth | Entertainment, gaming, creative |
-| `editorial-infographic` | Magazine-style explainers, flat illustrations | Tech explainers, research |
-| `fantasy-animation` | Whimsical Ghibli/Disney style, hand-drawn animation | Educational, storytelling |
-| `intuition-machine` | Technical briefing, bilingual labels, aged paper texture | Technical docs, bilingual |
-| `minimal` | Ultra-clean, maximum whitespace, single accent color | Executive briefings, premium |
-| `pixel-art` | Retro 8-bit aesthetic, chunky pixels, nostalgic gaming | Gaming, developer talks |
-| `scientific` | Academic diagrams, biological pathways, precise labeling | Biology, chemistry, medical |
-| `sketch-notes` | Hand-drawn feel, soft brush strokes, warm background | Educational, tutorials |
-| `vector-illustration` | Flat vector, black outlines, retro soft colors | Creative proposals, explainers |
-| `vintage` | Aged-paper aesthetic, historical document styling | Historical, heritage, biography |
-| `watercolor` | Soft hand-painted textures, natural warmth | Lifestyle, wellness, travel |
+| Option | Description |
+|--------|-------------|
+| `--style <name>` | Visual style: preset name or `custom` |
+| `--audience <type>` | Target: beginners, intermediate, experts, executives, general |
+| `--lang <code>` | Output language (en, zh, ja, etc.) |
+| `--slides <number>` | Target slide count (8-25 recommended, max 30) |
+| `--outline-only` | Generate outline only, skip images |
+| `--prompts-only` | Generate outline + prompts, skip images |
+| `--images-only` | Generate images from existing prompts |
+| `--regenerate <N>` | Regenerate specific slide(s): `3` or `2,5,8` |
+
+**Style System**:
+
+Styles are built from 4 dimensions: **Texture** × **Mood** × **Typography** × **Density**
+
+| Dimension | Options |
+|-----------|---------|
+| Texture | clean, grid, organic, pixel, paper |
+| Mood | professional, warm, cool, vibrant, dark, neutral |
+| Typography | geometric, humanist, handwritten, editorial, technical |
+| Density | minimal, balanced, dense |
+
+**Presets** (pre-configured dimension combinations):
+
+| Preset | Dimensions | Best For |
+|--------|------------|----------|
+| `blueprint` (default) | grid + cool + technical + balanced | Architecture, system design |
+| `chalkboard` | organic + warm + handwritten + balanced | Education, tutorials |
+| `corporate` | clean + professional + geometric + balanced | Investor decks, proposals |
+| `minimal` | clean + neutral + geometric + minimal | Executive briefings |
+| `sketch-notes` | organic + warm + handwritten + balanced | Educational, tutorials |
+| `watercolor` | organic + warm + humanist + minimal | Lifestyle, wellness |
+| `dark-atmospheric` | clean + dark + editorial + balanced | Entertainment, gaming |
+| `notion` | clean + neutral + geometric + dense | Product demos, SaaS |
+| `bold-editorial` | clean + vibrant + editorial + balanced | Product launches, keynotes |
+| `editorial-infographic` | clean + cool + editorial + dense | Tech explainers, research |
+| `fantasy-animation` | organic + vibrant + handwritten + minimal | Educational storytelling |
+| `intuition-machine` | clean + cool + technical + dense | Technical docs, academic |
+| `pixel-art` | pixel + vibrant + technical + balanced | Gaming, developer talks |
+| `scientific` | clean + cool + technical + dense | Biology, chemistry, medical |
+| `vector-illustration` | clean + vibrant + humanist + balanced | Creative, children's content |
+| `vintage` | paper + warm + editorial + balanced | Historical, heritage |

 **Style Previews**:

@@ -336,22 +359,23 @@ Generate professional slide deck images from content. Creates comprehensive outl
 | ![watercolor](./screenshots/slide-deck-styles/watercolor.webp) | | |
 | watercolor | | |

-After generation, slides are automatically merged into a `.pptx` file for easy sharing.
+After generation, slides are automatically merged into `.pptx` and `.pdf` files for easy sharing.

 #### baoyu-comic

-Knowledge comic creator supporting multiple styles (Logicomix/Ligne Claire, Ohmsha manga guide). Creates original educational comics with detailed panel layouts and sequential image generation.
+Knowledge comic creator with flexible art style × tone combinations. Creates original educational comics with detailed panel layouts and sequential image generation.

 ```bash
-# From source material
+# From source material (auto-selects art + tone)
 /baoyu-comic posts/turing-story/source.md

-# Specify style
-/baoyu-comic posts/turing-story/source.md --style dramatic
-/baoyu-comic posts/turing-story/source.md --style ohmsha
+# Specify art style and tone
+/baoyu-comic posts/turing-story/source.md --art manga --tone warm
+/baoyu-comic posts/turing-story/source.md --art ink-brush --tone dramatic

-# Custom style (natural language)
-/baoyu-comic posts/turing-story/source.md --style "watercolor with soft edges"
+# Use preset (includes special rules)
+/baoyu-comic posts/turing-story/source.md --style ohmsha
+/baoyu-comic posts/turing-story/source.md --style wuxia

 # Specify layout and aspect ratio
 /baoyu-comic posts/turing-story/source.md --layout cinematic
@@ -367,35 +391,42 @@ Knowledge comic creator supporting multiple styles (Logicomix/Ligne Claire, Ohms
 **Options**:
 | Option | Values |
 |--------|--------|
-| `--style` | `classic` (default), `dramatic`, `warm`, `sepia`, `vibrant`, `ohmsha`, `realistic`, `wuxia`, `shoujo`, or custom description |
+| `--art` | `ligne-claire` (default), `manga`, `realistic`, `ink-brush`, `chalk` |
+| `--tone` | `neutral` (default), `warm`, `dramatic`, `romantic`, `energetic`, `vintage`, `action` |
+| `--style` | `ohmsha`, `wuxia`, `shoujo` (presets with special rules) |
 | `--layout` | `standard` (default), `cinematic`, `dense`, `splash`, `mixed`, `webtoon` |
 | `--aspect` | `3:4` (default, portrait), `4:3` (landscape), `16:9` (widescreen) |
 | `--lang` | `auto` (default), `zh`, `en`, `ja`, etc. |

-**Styles** (visual aesthetics):
+**Art Styles** (rendering technique):

-| Style | Description | Best For |
-|-------|-------------|----------|
-| `classic` (default) | Traditional Ligne Claire with clean uniform outlines, flat colors, detailed backgrounds | Biographies, balanced narratives, educational content |
-| `dramatic` | High contrast with heavy shadows, intense expressions, angular compositions | Pivotal discoveries, conflicts, climactic scenes |
-| `warm` | Soft edges, golden tones, cozy interiors with nostalgic feel | Personal stories, childhood scenes, mentorship |
-| `sepia` | Vintage illustration style with aged paper effect, period-accurate details | Pre-1950s stories, classical science, historical figures |
-| `vibrant` | Energetic lines with weight variation, bright colors, dynamic poses | Science explanations, "aha" moments, young audience |
-| `ohmsha` | Manga guide style with visual metaphors, gadgets, student/mentor dynamic | Technical tutorials, complex concepts (ML, physics) |
-| `realistic` | Full-color realistic manga with digital painting, smooth gradients, accurate proportions | Wine, food, business, lifestyle, professional topics |
-| `wuxia` | Hong Kong martial arts style with ink brush strokes, dynamic combat, qi effects | Martial arts, wuxia/xianxia, Chinese historical fiction |
-| `shoujo` | Classic shoujo manga with large sparkling eyes, flowers, sparkles, soft pink/lavender palette | Romance, coming-of-age, friendship, emotional drama |
+| Art Style | Description |
+|-----------|-------------|
+| `ligne-claire` | Uniform lines, flat colors, European comic tradition (Tintin, Logicomix) |
+| `manga` | Large eyes, manga conventions, expressive emotions |
+| `realistic` | Digital painting, realistic proportions, sophisticated |
+| `ink-brush` | Chinese brush strokes, ink wash effects |
+| `chalk` | Chalkboard aesthetic, hand-drawn warmth |

-**Style Previews**:
+**Tones** (mood/atmosphere):

-| | | |
-|:---:|:---:|:---:|
-| ![classic](./screenshots/comic-styles/classic.webp) | ![dramatic](./screenshots/comic-styles/dramatic.webp) | ![warm](./screenshots/comic-styles/warm.webp) |
-| classic | dramatic | warm |
-| ![sepia](./screenshots/comic-styles/sepia.webp) | ![vibrant](./screenshots/comic-styles/vibrant.webp) | ![ohmsha](./screenshots/comic-styles/ohmsha.webp) |
-| sepia | vibrant | ohmsha |
-| ![realistic](./screenshots/comic-styles/realistic.webp) | ![wuxia](./screenshots/comic-styles/wuxia.webp) | ![shoujo](./screenshots/comic-styles/shoujo.webp) |
-| realistic | wuxia | shoujo |
+| Tone | Description |
+|------|-------------|
+| `neutral` | Balanced, rational, educational |
+| `warm` | Nostalgic, personal, comforting |
+| `dramatic` | High contrast, intense, powerful |
+| `romantic` | Soft, beautiful, decorative elements |
+| `energetic` | Bright, dynamic, exciting |
+| `vintage` | Historical, aged, period authenticity |
+| `action` | Speed lines, impact effects, combat |
+
+**Presets** (art + tone + special rules):
+
+| Preset | Equivalent | Special Rules |
+|--------|-----------|---------------|
+| `ohmsha` | manga + neutral | Visual metaphors, NO talking heads, gadget reveals |
+| `wuxia` | ink-brush + action | Qi effects, combat visuals, atmospheric elements |
+| `shoujo` | manga + romantic | Decorative elements, eye details, romantic beats |

 **Layouts** (panel arrangement):
 | Layout | Panels/Page | Best for |
@@ -418,42 +449,45 @@ Knowledge comic creator supporting multiple styles (Logicomix/Ligne Claire, Ohms

 #### baoyu-article-illustrator

-Smart article illustration skill. Analyzes article content and generates illustrations at positions requiring visual aids.
+Smart article illustration skill with Type × Style two-dimension approach. Analyzes article structure, identifies positions requiring visual aids, and generates illustrations.

 ```bash
-# Auto-select style based on content
+# Auto-select type and style based on content
 /baoyu-article-illustrator path/to/article.md

-# Specify a style
-/baoyu-article-illustrator path/to/article.md --style warm
-/baoyu-article-illustrator path/to/article.md --style watercolor
+# Specify type
+/baoyu-article-illustrator path/to/article.md --type infographic
+
+# Specify style
+/baoyu-article-illustrator path/to/article.md --style blueprint
+
+# Combine type and style
+/baoyu-article-illustrator path/to/article.md --type flowchart --style notion
 ```

+**Types** (information structure):
+
+| Type | Description | Best For |
+|------|-------------|----------|
+| `infographic` | Data visualization, charts, metrics | Technical articles, data analysis |
+| `scene` | Atmospheric illustration, mood rendering | Narrative, personal stories |
+| `flowchart` | Process diagrams, step visualization | Tutorials, workflows |
+| `comparison` | Side-by-side, before/after contrast | Product comparisons |
+| `framework` | Concept maps, relationship diagrams | Methodologies, architecture |
+| `timeline` | Chronological progression | History, project progress |
+
 **Styles** (visual aesthetics):

 | Style | Description | Best For |
 |-------|-------------|----------|
 | `notion` (default) | Minimalist hand-drawn line art | Knowledge sharing, SaaS, productivity |
-| `elegant` | Refined, sophisticated, professional | Business, thought leadership |
-| `warm` | Friendly, approachable, human-centered | Personal growth, lifestyle |
-| `minimal` | Ultra-clean, zen-like, focused | Philosophy, minimalism |
-| `playful` | Fun, creative, whimsical | Tutorials, beginner guides |
-| `nature` | Organic, calm, earthy | Sustainability, wellness |
-| `sketch` | Raw, authentic, notebook-style | Ideas, brainstorming |
+| `elegant` | Refined, sophisticated | Business, thought leadership |
+| `warm` | Friendly, approachable | Personal growth, lifestyle |
+| `minimal` | Ultra-clean, zen-like | Philosophy, minimalism |
+| `blueprint` | Technical schematics | Architecture, system design |
 | `watercolor` | Soft artistic with natural warmth | Lifestyle, travel, creative |
-| `vintage` | Nostalgic aged-paper aesthetic | Historical, biography |
-| `scientific` | Academic precise diagrams | Biology, chemistry, technical |
-| `chalkboard` | Classroom chalk drawing style | Education, tutorials |
 | `editorial` | Magazine-style infographic | Tech explainers, journalism |
-| `flat` | Modern flat vector illustration | Startups, digital |
-| `flat-doodle` | Bold outlines, pastel colors, cute | Productivity, SaaS, workflows |
-| `retro` | 80s/90s vibrant nostalgic | Pop culture, entertainment |
-| `blueprint` | Technical schematics, engineering | Architecture, system design |
-| `vector-illustration` | Flat vector, black outlines, retro | Educational, creative, brand |
-| `sketch-notes` | Soft hand-drawn, warm feel | Knowledge sharing, tutorials |
-| `pixel-art` | Retro 8-bit gaming aesthetic | Gaming, tech, developer |
-| `intuition-machine` | Technical briefing, bilingual | Academic, technical, research |
-| `fantasy-animation` | Ghibli/Disney whimsical style | Storytelling, children's |
+| `scientific` | Academic precise diagrams | Biology, chemistry, technical |

 **Style Previews**:

@@ -461,18 +495,10 @@ Smart article illustration skill. Analyzes article content and generates illustr
 |:---:|:---:|:---:|
 | ![notion](./screenshots/article-illustrator-styles/notion.webp) | ![elegant](./screenshots/article-illustrator-styles/elegant.webp) | ![warm](./screenshots/article-illustrator-styles/warm.webp) |
 | notion | elegant | warm |
-| ![minimal](./screenshots/article-illustrator-styles/minimal.webp) | ![playful](./screenshots/article-illustrator-styles/playful.webp) | ![nature](./screenshots/article-illustrator-styles/nature.webp) |
-| minimal | playful | nature |
-| ![sketch](./screenshots/article-illustrator-styles/sketch.webp) | ![watercolor](./screenshots/article-illustrator-styles/watercolor.webp) | ![vintage](./screenshots/article-illustrator-styles/vintage.webp) |
-| sketch | watercolor | vintage |
-| ![scientific](./screenshots/article-illustrator-styles/scientific.webp) | ![chalkboard](./screenshots/article-illustrator-styles/chalkboard.webp) | ![editorial](./screenshots/article-illustrator-styles/editorial.webp) |
-| scientific | chalkboard | editorial |
-| ![flat](./screenshots/article-illustrator-styles/flat.webp) | ![retro](./screenshots/article-illustrator-styles/retro.webp) | ![blueprint](./screenshots/article-illustrator-styles/blueprint.webp) |
-| flat | retro | blueprint |
-| ![vector-illustration](./screenshots/article-illustrator-styles/vector-illustration.webp) | ![sketch-notes](./screenshots/article-illustrator-styles/sketch-notes.webp) | ![pixel-art](./screenshots/article-illustrator-styles/pixel-art.webp) |
-| vector-illustration | sketch-notes | pixel-art |
-| ![intuition-machine](./screenshots/article-illustrator-styles/intuition-machine.webp) | ![fantasy-animation](./screenshots/article-illustrator-styles/fantasy-animation.webp) | ![flat-doodle](./screenshots/article-illustrator-styles/flat-doodle.webp) |
-| intuition-machine | fantasy-animation | flat-doodle |
+| ![minimal](./screenshots/article-illustrator-styles/minimal.webp) | ![blueprint](./screenshots/article-illustrator-styles/blueprint.webp) | ![watercolor](./screenshots/article-illustrator-styles/watercolor.webp) |
+| minimal | blueprint | watercolor |
+| ![editorial](./screenshots/article-illustrator-styles/editorial.webp) | ![scientific](./screenshots/article-illustrator-styles/scientific.webp) | |
+| editorial | scientific | |

 #### baoyu-post-to-x

@@ -509,7 +535,28 @@ Post content to WeChat Official Account (微信公众号). Two modes available:
 /baoyu-post-to-wechat 文章 --html article.html
 ```

-Prerequisites: Google Chrome installed. First run requires QR code login (session preserved).
+**Publishing Methods**:
+
+| Method | Speed | Requirements |
+|--------|-------|--------------|
+| API (Recommended) | Fast | API credentials |
+| Browser | Slow | Chrome, login session |
+
+**API Configuration** (for faster publishing):
+
+```bash
+# Add to .baoyu-skills/.env (project-level) or ~/.baoyu-skills/.env (user-level)
+WECHAT_APP_ID=your_app_id
+WECHAT_APP_SECRET=your_app_secret
+```
+
+To obtain credentials:
+1. Visit https://developers.weixin.qq.com/platform/
+2. Go to: 我的业务 → 公众号 → 开发密钥
+3. Create development key and copy AppID/AppSecret
+4. Add your machine's IP to the whitelist
+
+**Browser Method** (no API setup needed): Requires Google Chrome. First run opens browser for QR code login (session preserved).

 ### AI Generation Skills

@@ -517,7 +564,7 @@ AI-powered generation backends.

 #### baoyu-image-gen

-AI SDK-based image generation using official OpenAI and Google APIs. Supports text-to-image, reference images, aspect ratios, and quality presets.
+AI SDK-based image generation using official OpenAI, Google and DashScope (Aliyun Tongyi Wanxiang) APIs. Supports text-to-image, reference images, aspect ratios, and quality presets.

 ```bash
 # Basic generation (auto-detect provider)
@@ -532,6 +579,9 @@ AI SDK-based image generation using official OpenAI and Google APIs. Supports te
 # Specific provider
 /baoyu-image-gen --prompt "A cat" --image cat.png --provider openai

+# DashScope (Aliyun Tongyi Wanxiang)
+/baoyu-image-gen --prompt "一只可爱的猫" --image cat.png --provider dashscope
+
 # With reference images (Google multimodal only)
 /baoyu-image-gen --prompt "Make it blue" --image out.png --ref source.png
 ```
@@ -542,7 +592,7 @@ AI SDK-based image generation using official OpenAI and Google APIs. Supports te
 | `--prompt`, `-p` | Prompt text |
 | `--promptfiles` | Read prompt from files (concatenated) |
 | `--image` | Output image path (required) |
-| `--provider` | `google` or `openai` (default: google) |
+| `--provider` | `google`, `openai` or `dashscope` (default: google) |
 | `--model`, `-m` | Model ID |
 | `--ar` | Aspect ratio (e.g., `16:9`, `1:1`, `4:3`) |
 | `--size` | Size (e.g., `1024x1024`) |
@@ -554,15 +604,18 @@ AI SDK-based image generation using official OpenAI and Google APIs. Supports te
 |----------|-------------|---------|
 | `OPENAI_API_KEY` | OpenAI API key | - |
 | `GOOGLE_API_KEY` | Google API key | - |
+| `DASHSCOPE_API_KEY` | DashScope API key (Aliyun) | - |
 | `OPENAI_IMAGE_MODEL` | OpenAI model | `gpt-image-1.5` |
 | `GOOGLE_IMAGE_MODEL` | Google model | `gemini-3-pro-image-preview` |
+| `DASHSCOPE_IMAGE_MODEL` | DashScope model | `z-image-turbo` |
 | `OPENAI_BASE_URL` | Custom OpenAI endpoint | - |
 | `GOOGLE_BASE_URL` | Custom Google endpoint | - |
+| `DASHSCOPE_BASE_URL` | Custom DashScope endpoint | - |

 **Provider Auto-Selection**:
 1. If `--provider` specified → use it
 2. If only one API key available → use that provider
-3. If both available → default to Google
+3. If multiple available → default to Google

 #### baoyu-danger-gemini-web

@@ -646,6 +699,43 @@ Compress images to reduce file size while maintaining quality.
 /baoyu-compress-image path/to/images/ --quality 80
 ```

+#### baoyu-format-markdown
+
+Format plain text or markdown files with proper frontmatter, titles, summaries, headings, bold, lists, and code blocks.
+
+```bash
+# Format a markdown file
+/baoyu-format-markdown path/to/article.md
+
+# Format with specific output
+/baoyu-format-markdown path/to/draft.md
+```
+
+**Workflow**:
+1. Read source file and analyze content structure
+2. Check/create YAML frontmatter (title, slug, summary, featureImage)
+3. Handle title: use existing, extract from H1, or generate candidates
+4. Apply formatting: headings, bold, lists, code blocks, quotes
+5. Save to `{filename}-formatted.md`
+6. Run typography script: ASCII→fullwidth quotes, CJK spacing, autocorrect
+
+**Frontmatter Fields**:
+| Field | Processing |
+|-------|------------|
+| `title` | Use existing, extract H1, or generate candidates |
+| `slug` | Infer from file path or generate from title |
+| `summary` | Generate engaging summary (100-150 chars) |
+| `featureImage` | Check for `imgs/cover.png` in same directory |
+
+**Formatting Rules**:
+| Element | Format |
+|---------|--------|
+| Titles | `#`, `##`, `###` hierarchy |
+| Key points | `**bold**` |
+| Parallel items | `-` unordered or `1.` ordered lists |
+| Code/commands | `` `inline` `` or ` ```block``` ` |
+| Quotes | `>` blockquote |
+
 ## Environment Configuration

 Some skills require API keys or custom configuration. Environment variables can be set in `.env` files:
@@ -673,6 +763,11 @@ OPENAI_IMAGE_MODEL=gpt-image-1.5
 GOOGLE_API_KEY=xxx
 GOOGLE_IMAGE_MODEL=gemini-3-pro-image-preview
 # GOOGLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta
+
+# DashScope (Aliyun Tongyi Wanxiang)
+DASHSCOPE_API_KEY=sk-xxx
+DASHSCOPE_IMAGE_MODEL=z-image-turbo
+# DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1
 EOF
 ```

@@ -701,13 +796,14 @@ mkdir -p .baoyu-skills/baoyu-cover-image
 Then create `.baoyu-skills/baoyu-cover-image/EXTEND.md`:

 ```markdown
-## Custom Styles
+## Custom Palettes

-### brand
- Primary color: #1a73e8
- Secondary color: #34a853
- Font style: Modern sans-serif
- Always include company logo watermark
+### corporate-tech
+- Primary colors: #1a73e8, #4A90D9
+- Background: #F5F7FA
+- Accent colors: #00B4D8, #48CAE4
+- Decorative hints: Clean lines, subtle gradients
+- Best for: SaaS, enterprise, technical
 ```

 The extension content will be loaded before skill execution and override defaults.
@@ -55,7 +55,7 @@ npx skills add jimliu/baoyu-skills
 |------|------|----------|
 | **content-skills** | 内容生成和发布 | [xhs-images](#baoyu-xhs-images), [infographic](#baoyu-infographic), [cover-image](#baoyu-cover-image), [slide-deck](#baoyu-slide-deck), [comic](#baoyu-comic), [article-illustrator](#baoyu-article-illustrator), [post-to-x](#baoyu-post-to-x), [post-to-wechat](#baoyu-post-to-wechat) |
 | **ai-generation-skills** | AI 生成后端 | [image-gen](#baoyu-image-gen), [danger-gemini-web](#baoyu-danger-gemini-web) |
-| **utility-skills** | 内容处理工具 | [url-to-markdown](#baoyu-url-to-markdown), [danger-x-to-markdown](#baoyu-danger-x-to-markdown), [compress-image](#baoyu-compress-image) |
+| **utility-skills** | 内容处理工具 | [url-to-markdown](#baoyu-url-to-markdown), [danger-x-to-markdown](#baoyu-danger-x-to-markdown), [compress-image](#baoyu-compress-image), [format-markdown](#baoyu-format-markdown) |

 ## 更新技能

@@ -245,40 +245,35 @@ npx skills add jimliu/baoyu-skills

 #### baoyu-cover-image

-为文章生成手绘风格封面图，支持多种风格选项。
+为文章生成封面图，支持五维定制系统：类型 × 配色 × 渲染 × 文字 × 氛围。9 种配色方案与 6 种渲染风格组合，提供 54 种独特效果。

 ```bash
-# 从 markdown 文件生成（自动选择风格）
+# 根据内容自动选择所有维度
 /baoyu-cover-image path/to/article.md

-# 指定风格
-/baoyu-cover-image path/to/article.md --style tech
-/baoyu-cover-image path/to/article.md --style warm
+# 快速模式：跳过确认，使用自动选择
+/baoyu-cover-image path/to/article.md --quick

-# 不包含标题文字
+# 指定维度（5D 系统）
+/baoyu-cover-image path/to/article.md --type conceptual --palette cool --rendering digital
+/baoyu-cover-image path/to/article.md --text title-subtitle --mood bold
+
+# 风格预设（向后兼容的简写方式）
+/baoyu-cover-image path/to/article.md --style blueprint
+
+# 指定宽高比（默认：16:9）
+/baoyu-cover-image path/to/article.md --aspect 2.35:1
+
+# 纯视觉（不含标题文字）
 /baoyu-cover-image path/to/article.md --no-title
 ```

-可用风格：`elegant`（默认）、`blueprint`、`bold-editorial`、`chalkboard`、`dark-atmospheric`、`editorial-infographic`、`fantasy-animation`、`flat-doodle`、`intuition-machine`、`minimal`、`nature`、`notion`、`pixel-art`、`playful`、`retro`、`sketch-notes`、`vector-illustration`、`vintage`、`warm`、`watercolor`
-
-**风格预览**：
-
-| | | |
-|:---:|:---:|:---:|
-| ![elegant](./screenshots/cover-image-styles/elegant.webp) | ![blueprint](./screenshots/cover-image-styles/blueprint.webp) | ![bold-editorial](./screenshots/cover-image-styles/bold-editorial.webp) |
-| elegant | blueprint | bold-editorial |
-| ![chalkboard](./screenshots/cover-image-styles/chalkboard.webp) | ![dark-atmospheric](./screenshots/cover-image-styles/dark-atmospheric.webp) | ![editorial-infographic](./screenshots/cover-image-styles/editorial-infographic.webp) |
-| chalkboard | dark-atmospheric | editorial-infographic |
-| ![fantasy-animation](./screenshots/cover-image-styles/fantasy-animation.webp) | ![intuition-machine](./screenshots/cover-image-styles/intuition-machine.webp) | ![minimal](./screenshots/cover-image-styles/minimal.webp) |
-| fantasy-animation | intuition-machine | minimal |
-| ![nature](./screenshots/cover-image-styles/nature.webp) | ![notion](./screenshots/cover-image-styles/notion.webp) | ![pixel-art](./screenshots/cover-image-styles/pixel-art.webp) |
-| nature | notion | pixel-art |
-| ![playful](./screenshots/cover-image-styles/playful.webp) | ![retro](./screenshots/cover-image-styles/retro.webp) | ![sketch-notes](./screenshots/cover-image-styles/sketch-notes.webp) |
-| playful | retro | sketch-notes |
-| ![vector-illustration](./screenshots/cover-image-styles/vector-illustration.webp) | ![vintage](./screenshots/cover-image-styles/vintage.webp) | ![warm](./screenshots/cover-image-styles/warm.webp) |
-| vector-illustration | vintage | warm |
-| ![watercolor](./screenshots/cover-image-styles/watercolor.webp) | ![flat-doodle](./screenshots/cover-image-styles/flat-doodle.webp) | |
-| watercolor | flat-doodle | |
+**五个维度**：
+- **类型 (Type)**：`hero`、`conceptual`、`typography`、`metaphor`、`scene`、`minimal`
+- **配色 (Palette)**：`warm`、`elegant`、`cool`、`dark`、`earth`、`vivid`、`pastel`、`mono`、`retro`
+- **渲染 (Rendering)**：`flat-vector`、`hand-drawn`、`painterly`、`digital`、`pixel`、`chalk`
+- **文字 (Text)**：`none`、`title-only`（默认）、`title-subtitle`、`text-rich`
+- **氛围 (Mood)**：`subtle`、`balanced`（默认）、`bold`

 #### baoyu-slide-deck

@@ -292,6 +287,9 @@ npx skills add jimliu/baoyu-skills
 /baoyu-slide-deck path/to/article.md --style corporate
 /baoyu-slide-deck path/to/article.md --audience executives

+# 指定页数
+/baoyu-slide-deck path/to/article.md --slides 15
+
 # 仅生成大纲（不生成图片）
 /baoyu-slide-deck path/to/article.md --outline-only

@@ -299,25 +297,50 @@ npx skills add jimliu/baoyu-skills
 /baoyu-slide-deck path/to/article.md --lang zh
 ```

-**风格**（视觉美学）：
+**选项**：

-| 风格 | 描述 | 适用场景 |
-|------|------|----------|
-| `blueprint`（默认） | 技术蓝图风格，网格纹理，工程精度 | 架构设计、系统设计 |
-| `notion` | SaaS 仪表盘美学，卡片式布局，数据清晰 | 产品演示、SaaS、B2B |
-| `bold-editorial` | 杂志社论风格，粗体排版，深色背景 | 产品发布、主题演讲 |
-| `corporate` | 海军蓝/金色配色，结构化布局，专业图标 | 投资者演示、客户提案 |
-| `dark-atmospheric` | 电影级暗色调，发光效果，氛围感 | 娱乐、游戏、创意 |
-| `editorial-infographic` | 杂志风格信息图，扁平插画 | 科技解说、研究报告 |
-| `fantasy-animation` | 吉卜力/迪士尼风格，手绘动画 | 教育、故事讲述 |
-| `intuition-machine` | 技术简报，双语标签，做旧纸张纹理 | 技术文档、双语内容 |
-| `minimal` | 极简风格，大量留白，单一强调色 | 高管简报、高端品牌 |
-| `pixel-art` | 复古 8-bit 像素风，怀旧游戏感 | 游戏、开发者分享 |
-| `scientific` | 学术图表，生物通路，精确标注 | 生物、化学、医学 |
-| `sketch-notes` | 手绘风格，柔和笔触，暖白色背景 | 教育、教程、知识分享 |
-| `vector-illustration` | 扁平矢量风格，黑色轮廓线，复古柔和配色 | 创意提案、说明性内容 |
-| `vintage` | 做旧纸张美学，历史文档风格 | 历史、传记、人文 |
-| `watercolor` | 柔和手绘水彩纹理，自然温暖 | 生活方式、健康、旅行 |
+| 选项 | 说明 |
+|------|------|
+| `--style <name>` | 视觉风格：预设名称或 `custom` |
+| `--audience <type>` | 目标受众：beginners、intermediate、experts、executives、general |
+| `--lang <code>` | 输出语言（en、zh、ja 等） |
+| `--slides <number>` | 目标页数（推荐 8-25，最多 30） |
+| `--outline-only` | 仅生成大纲，跳过图片 |
+| `--prompts-only` | 生成大纲 + 提示词，跳过图片 |
+| `--images-only` | 从现有提示词生成图片 |
+| `--regenerate <N>` | 重新生成指定页：`3` 或 `2,5,8` |
+
+**风格系统**：
+
+风格由 4 个维度组合而成：**纹理** × **氛围** × **字体** × **密度**
+
+| 维度 | 选项 |
+|------|------|
+| 纹理 | clean 纯净、grid 网格、organic 有机、pixel 像素、paper 纸张 |
+| 氛围 | professional 专业、warm 温暖、cool 冷静、vibrant 鲜艳、dark 暗色、neutral 中性 |
+| 字体 | geometric 几何、humanist 人文、handwritten 手写、editorial 编辑、technical 技术 |
+| 密度 | minimal 极简、balanced 均衡、dense 密集 |
+
+**预设**（预配置的维度组合）：
+
+| 预设 | 维度组合 | 适用场景 |
+|------|----------|----------|
+| `blueprint`（默认） | grid + cool + technical + balanced | 架构设计、系统设计 |
+| `chalkboard` | organic + warm + handwritten + balanced | 教育、教程 |
+| `corporate` | clean + professional + geometric + balanced | 投资者演示、提案 |
+| `minimal` | clean + neutral + geometric + minimal | 高管简报 |
+| `sketch-notes` | organic + warm + handwritten + balanced | 教育、教程 |
+| `watercolor` | organic + warm + humanist + minimal | 生活方式、健康 |
+| `dark-atmospheric` | clean + dark + editorial + balanced | 娱乐、游戏 |
+| `notion` | clean + neutral + geometric + dense | 产品演示、SaaS |
+| `bold-editorial` | clean + vibrant + editorial + balanced | 产品发布、主题演讲 |
+| `editorial-infographic` | clean + cool + editorial + dense | 科技解说、研究 |
+| `fantasy-animation` | organic + vibrant + handwritten + minimal | 教育故事 |
+| `intuition-machine` | clean + cool + technical + dense | 技术文档、学术 |
+| `pixel-art` | pixel + vibrant + technical + balanced | 游戏、开发者 |
+| `scientific` | clean + cool + technical + dense | 生物、化学、医学 |
+| `vector-illustration` | clean + vibrant + humanist + balanced | 创意、儿童内容 |
+| `vintage` | paper + warm + editorial + balanced | 历史、传记 |

 **风格预览**：

@@ -336,22 +359,23 @@ npx skills add jimliu/baoyu-skills
 | ![watercolor](./screenshots/slide-deck-styles/watercolor.webp) | | |
 | watercolor | | |

-生成完成后，所有幻灯片会自动合并为 `.pptx` 文件，方便分享。
+生成完成后，所有幻灯片会自动合并为 `.pptx` 和 `.pdf` 文件，方便分享。

 #### baoyu-comic

-知识漫画创作器，支持多种风格（Logicomix/清线风格、欧姆社漫画教程风格）。创作带有详细分镜布局的原创教育漫画，逐页生成图片。
+知识漫画创作器，支持画风 × 基调灵活组合。创作带有详细分镜布局的原创教育漫画，逐页生成图片。

 ```bash
-# 从素材文件生成
+# 从素材文件生成（自动选择画风 + 基调）
 /baoyu-comic posts/turing-story/source.md

-# 指定风格
-/baoyu-comic posts/turing-story/source.md --style dramatic
-/baoyu-comic posts/turing-story/source.md --style ohmsha
+# 指定画风和基调
+/baoyu-comic posts/turing-story/source.md --art manga --tone warm
+/baoyu-comic posts/turing-story/source.md --art ink-brush --tone dramatic

-# 自定义风格（自然语言描述）
-/baoyu-comic posts/turing-story/source.md --style "水彩风格，边缘柔和"
+# 使用预设（包含特殊规则）
+/baoyu-comic posts/turing-story/source.md --style ohmsha
+/baoyu-comic posts/turing-story/source.md --style wuxia

 # 指定布局和比例
 /baoyu-comic posts/turing-story/source.md --layout cinematic
@@ -367,35 +391,42 @@ npx skills add jimliu/baoyu-skills
 **选项**：
 | 选项 | 取值 |
 |------|------|
-| `--style` | `classic`（默认）、`dramatic`、`warm`、`sepia`、`vibrant`、`ohmsha`、`realistic`、`wuxia`、`shoujo`，或自然语言描述 |
+| `--art` | `ligne-claire`（默认）、`manga`、`realistic`、`ink-brush`、`chalk` |
+| `--tone` | `neutral`（默认）、`warm`、`dramatic`、`romantic`、`energetic`、`vintage`、`action` |
+| `--style` | `ohmsha`、`wuxia`、`shoujo`（预设，含特殊规则） |
 | `--layout` | `standard`（默认）、`cinematic`、`dense`、`splash`、`mixed`、`webtoon` |
 | `--aspect` | `3:4`（默认，竖版）、`4:3`（横版）、`16:9`（宽屏） |
 | `--lang` | `auto`（默认）、`zh`、`en`、`ja` 等 |

-**风格**（视觉美学）：
+**画风**（渲染技法）：

-| 风格 | 描述 | 适用场景 |
-|------|------|----------|
-| `classic`（默认） | 传统清线风格，统一线条、平涂色彩、精细背景 | 传记、平衡叙事、教育内容 |
-| `dramatic` | 高对比度，重阴影、紧张表情、棱角分明的构图 | 重大发现、冲突、高潮场景 |
-| `warm` | 柔和边缘、金色调、温馨室内、怀旧感 | 个人故事、童年场景、师生情 |
-| `sepia` | 复古插画风格、做旧纸张效果、时代准确细节 | 1950 年前故事、古典科学、历史人物 |
-| `vibrant` | 富有活力的线条、明亮色彩、动感姿态 | 科学解说、"顿悟"时刻、青少年读者 |
-| `ohmsha` | 欧姆社漫画风格，视觉比喻、道具、学生/导师互动 | 技术教程、复杂概念（机器学习、物理） |
-| `realistic` | 全彩写实日漫风格，数字绘画、平滑渐变、准确人体比例 | 红酒、美食、商业、生活方式、专业话题 |
-| `wuxia` | 港漫武侠风格，水墨笔触、动态打斗、气功特效 | 武侠、仙侠、中国历史小说 |
-| `shoujo` | 经典少女漫画风格，大眼睛闪亮高光、花朵星星装饰、粉紫色调 | 恋爱、青春成长、友情、情感故事 |
+| 画风 | 描述 |
+|------|------|
+| `ligne-claire` | 统一线条、平涂色彩，欧洲漫画传统（丁丁、Logicomix） |
+| `manga` | 大眼睛、日漫风格、表情丰富 |
+| `realistic` | 数字绘画、写实比例、精致细腻 |
+| `ink-brush` | 中国水墨笔触、水墨晕染效果 |
+| `chalk` | 黑板粉笔风格、手绘温暖感 |

-**风格预览**：
+**基调**（氛围/情绪）：

-| | | |
-|:---:|:---:|:---:|
-| ![classic](./screenshots/comic-styles/classic.webp) | ![dramatic](./screenshots/comic-styles/dramatic.webp) | ![warm](./screenshots/comic-styles/warm.webp) |
-| classic | dramatic | warm |
-| ![sepia](./screenshots/comic-styles/sepia.webp) | ![vibrant](./screenshots/comic-styles/vibrant.webp) | ![ohmsha](./screenshots/comic-styles/ohmsha.webp) |
-| sepia | vibrant | ohmsha |
-| ![realistic](./screenshots/comic-styles/realistic.webp) | ![wuxia](./screenshots/comic-styles/wuxia.webp) | ![shoujo](./screenshots/comic-styles/shoujo.webp) |
-| realistic | wuxia | shoujo |
+| 基调 | 描述 |
+|------|------|
+| `neutral` | 平衡、理性、教育性 |
+| `warm` | 怀旧、个人化、温馨 |
+| `dramatic` | 高对比、紧张、有力 |
+| `romantic` | 柔和、唯美、装饰性元素 |
+| `energetic` | 明亮、动感、活力 |
+| `vintage` | 历史感、做旧、时代真实性 |
+| `action` | 速度线、冲击效果、战斗 |
+
+**预设**（画风 + 基调 + 特殊规则）：
+
+| 预设 | 等价于 | 特殊规则 |
+|------|--------|----------|
+| `ohmsha` | manga + neutral | 视觉比喻、禁止大头对话、道具揭秘 |
+| `wuxia` | ink-brush + action | 气功特效、战斗视觉、氛围元素 |
+| `shoujo` | manga + romantic | 装饰元素、眼睛细节、浪漫情节 |

 **布局**（分镜排列）：
 | 布局 | 每页分镜数 | 适用场景 |
@@ -418,42 +449,45 @@ npx skills add jimliu/baoyu-skills

 #### baoyu-article-illustrator

-智能文章插图技能。分析文章内容，在需要视觉辅助的位置生成插图。
+智能文章插图技能，采用类型 × 风格二维系统。分析文章结构，识别需要视觉辅助的位置，生成插图。

 ```bash
-# 根据内容自动选择风格
+# 根据内容自动选择类型和风格
 /baoyu-article-illustrator path/to/article.md

+# 指定类型
+/baoyu-article-illustrator path/to/article.md --type infographic
+
 # 指定风格
-/baoyu-article-illustrator path/to/article.md --style warm
-/baoyu-article-illustrator path/to/article.md --style watercolor
+/baoyu-article-illustrator path/to/article.md --style blueprint
+
+# 组合类型和风格
+/baoyu-article-illustrator path/to/article.md --type flowchart --style notion
 ```

+**类型**（信息结构）：
+
+| 类型 | 描述 | 适用场景 |
+|------|------|----------|
+| `infographic` | 数据可视化、图表、指标 | 技术文章、数据分析 |
+| `scene` | 氛围插图、情绪渲染 | 叙事、个人故事 |
+| `flowchart` | 流程图、步骤可视化 | 教程、工作流 |
+| `comparison` | 并排对比、前后对照 | 产品比较 |
+| `framework` | 概念图、关系图 | 方法论、架构 |
+| `timeline` | 时间线进展 | 历史、项目进度 |
+
 **风格**（视觉美学）：

 | 风格 | 描述 | 适用场景 |
 |------|------|----------|
 | `notion`（默认） | 极简手绘线条画 | 知识分享、SaaS、生产力 |
-| `elegant` | 精致、优雅、专业 | 商业、思想领导力 |
-| `warm` | 友好、亲切、人文关怀 | 个人成长、生活方式 |
-| `minimal` | 极简、禅意、专注 | 哲学、极简主义 |
-| `playful` | 有趣、创意、俏皮 | 教程、新手指南 |
-| `nature` | 自然、平静、质朴 | 可持续发展、健康 |
-| `sketch` | 原始、真实、笔记风格 | 想法、头脑风暴 |
+| `elegant` | 精致、优雅 | 商业、思想领导力 |
+| `warm` | 友好、亲切 | 个人成长、生活方式 |
+| `minimal` | 极简、禅意 | 哲学、极简主义 |
+| `blueprint` | 技术蓝图 | 架构、系统设计 |
 | `watercolor` | 柔和艺术感、自然温暖 | 生活方式、旅行、创意 |
-| `vintage` | 怀旧做旧纸张美学 | 历史、传记 |
-| `scientific` | 学术精确图表 | 生物、化学、技术 |
-| `chalkboard` | 教室粉笔画风格 | 教育、教程 |
 | `editorial` | 杂志风格信息图 | 科技解说、新闻 |
-| `flat` | 现代扁平矢量插画 | 创业公司、数字化 |
-| `flat-doodle` | 粗轮廓、粉彩色、可爱风 | 生产力、SaaS、工作流 |
-| `retro` | 80/90 年代复古鲜艳 | 流行文化、娱乐 |
-| `blueprint` | 技术蓝图、工程精度 | 架构、系统设计 |
-| `vector-illustration` | 扁平矢量、黑色轮廓、复古 | 教育、创意、品牌 |
-| `sketch-notes` | 柔和手绘、温暖感 | 知识分享、教程 |
-| `pixel-art` | 复古 8-bit 游戏风格 | 游戏、技术、开发者 |
-| `intuition-machine` | 技术简报、双语标签 | 学术、技术、研究 |
-| `fantasy-animation` | 吉卜力/迪士尼童话风格 | 故事、儿童、创意 |
+| `scientific` | 学术精确图表 | 生物、化学、技术 |

 **风格预览**：

@@ -461,18 +495,10 @@ npx skills add jimliu/baoyu-skills
 |:---:|:---:|:---:|
 | ![notion](./screenshots/article-illustrator-styles/notion.webp) | ![elegant](./screenshots/article-illustrator-styles/elegant.webp) | ![warm](./screenshots/article-illustrator-styles/warm.webp) |
 | notion | elegant | warm |
-| ![minimal](./screenshots/article-illustrator-styles/minimal.webp) | ![playful](./screenshots/article-illustrator-styles/playful.webp) | ![nature](./screenshots/article-illustrator-styles/nature.webp) |
-| minimal | playful | nature |
-| ![sketch](./screenshots/article-illustrator-styles/sketch.webp) | ![watercolor](./screenshots/article-illustrator-styles/watercolor.webp) | ![vintage](./screenshots/article-illustrator-styles/vintage.webp) |
-| sketch | watercolor | vintage |
-| ![scientific](./screenshots/article-illustrator-styles/scientific.webp) | ![chalkboard](./screenshots/article-illustrator-styles/chalkboard.webp) | ![editorial](./screenshots/article-illustrator-styles/editorial.webp) |
-| scientific | chalkboard | editorial |
-| ![flat](./screenshots/article-illustrator-styles/flat.webp) | ![retro](./screenshots/article-illustrator-styles/retro.webp) | ![blueprint](./screenshots/article-illustrator-styles/blueprint.webp) |
-| flat | retro | blueprint |
-| ![vector-illustration](./screenshots/article-illustrator-styles/vector-illustration.webp) | ![sketch-notes](./screenshots/article-illustrator-styles/sketch-notes.webp) | ![pixel-art](./screenshots/article-illustrator-styles/pixel-art.webp) |
-| vector-illustration | sketch-notes | pixel-art |
-| ![intuition-machine](./screenshots/article-illustrator-styles/intuition-machine.webp) | ![fantasy-animation](./screenshots/article-illustrator-styles/fantasy-animation.webp) | ![flat-doodle](./screenshots/article-illustrator-styles/flat-doodle.webp) |
-| intuition-machine | fantasy-animation | flat-doodle |
+| ![minimal](./screenshots/article-illustrator-styles/minimal.webp) | ![blueprint](./screenshots/article-illustrator-styles/blueprint.webp) | ![watercolor](./screenshots/article-illustrator-styles/watercolor.webp) |
+| minimal | blueprint | watercolor |
+| ![editorial](./screenshots/article-illustrator-styles/editorial.webp) | ![scientific](./screenshots/article-illustrator-styles/scientific.webp) | |
+| editorial | scientific | |

 #### baoyu-post-to-x

@@ -509,7 +535,28 @@ npx skills add jimliu/baoyu-skills
 /baoyu-post-to-wechat 文章 --html article.html
 ```

-前置要求：已安装 Google Chrome，首次运行需扫码登录（登录状态会保存）
+**发布方式**：
+
+| 方式 | 速度 | 要求 |
+|------|------|------|
+| API（推荐） | 快 | API 凭证 |
+| 浏览器 | 慢 | Chrome，登录会话 |
+
+**API 配置**（更快的发布方式）：
+
+```bash
+# 添加到 .baoyu-skills/.env（项目级）或 ~/.baoyu-skills/.env（用户级）
+WECHAT_APP_ID=你的AppID
+WECHAT_APP_SECRET=你的AppSecret
+```
+
+获取凭证方法：
+1. 访问 https://developers.weixin.qq.com/platform/
+2. 进入：我的业务 → 公众号 → 开发密钥
+3. 添加开发密钥，复制 AppID 和 AppSecret
+4. 将你操作的机器 IP 加入白名单
+
+**浏览器方式**（无需 API 配置）：需已安装 Google Chrome，首次运行需扫码登录（登录状态会保存）

 ### AI 生成技能 (AI Generation Skills)

@@ -517,7 +564,7 @@ AI 驱动的生成后端。

 #### baoyu-image-gen

-基于 AI SDK 的图像生成，使用官方 OpenAI 和 Google API。支持文生图、参考图、宽高比和质量预设。
+基于 AI SDK 的图像生成，使用官方 OpenAI、Google 和 DashScope（阿里通义万相）API。支持文生图、参考图、宽高比和质量预设。

 ```bash
 # 基础生成（自动检测服务商）
@@ -532,6 +579,9 @@ AI 驱动的生成后端。
 # 指定服务商
 /baoyu-image-gen --prompt "一只猫" --image cat.png --provider openai

+# DashScope（阿里通义万相）
+/baoyu-image-gen --prompt "一只可爱的猫" --image cat.png --provider dashscope
+
 # 带参考图（仅 Google 多模态支持）
 /baoyu-image-gen --prompt "把它变成蓝色" --image out.png --ref source.png
 ```
@@ -542,7 +592,7 @@ AI 驱动的生成后端。
 | `--prompt`, `-p` | 提示词文本 |
 | `--promptfiles` | 从文件读取提示词（多文件拼接） |
 | `--image` | 输出图片路径（必需） |
-| `--provider` | `google` 或 `openai`（默认：google） |
+| `--provider` | `google`、`openai` 或 `dashscope`（默认：google） |
 | `--model`, `-m` | 模型 ID |
 | `--ar` | 宽高比（如 `16:9`、`1:1`、`4:3`） |
 | `--size` | 尺寸（如 `1024x1024`） |
@@ -554,15 +604,18 @@ AI 驱动的生成后端。
 |------|------|--------|
 | `OPENAI_API_KEY` | OpenAI API 密钥 | - |
 | `GOOGLE_API_KEY` | Google API 密钥 | - |
+| `DASHSCOPE_API_KEY` | DashScope API 密钥（阿里云） | - |
 | `OPENAI_IMAGE_MODEL` | OpenAI 模型 | `gpt-image-1.5` |
 | `GOOGLE_IMAGE_MODEL` | Google 模型 | `gemini-3-pro-image-preview` |
+| `DASHSCOPE_IMAGE_MODEL` | DashScope 模型 | `z-image-turbo` |
 | `OPENAI_BASE_URL` | 自定义 OpenAI 端点 | - |
 | `GOOGLE_BASE_URL` | 自定义 Google 端点 | - |
+| `DASHSCOPE_BASE_URL` | 自定义 DashScope 端点 | - |

 **服务商自动选择**：
 1. 如果指定了 `--provider` → 使用指定的
 2. 如果只有一个 API 密钥 → 使用对应服务商
-3. 如果两个都有 → 默认使用 Google
+3. 如果多个可用 → 默认使用 Google

 #### baoyu-danger-gemini-web

@@ -646,6 +699,43 @@ AI 驱动的生成后端。
 /baoyu-compress-image path/to/images/ --quality 80
 ```

+#### baoyu-format-markdown
+
+格式化纯文本或 Markdown 文件，添加 frontmatter、标题、摘要、层级标题、加粗、列表和代码块。
+
+```bash
+# 格式化 markdown 文件
+/baoyu-format-markdown path/to/article.md
+
+# 格式化指定文件
+/baoyu-format-markdown path/to/draft.md
+```
+
+**工作流程**：
+1. 读取源文件并分析内容结构
+2. 检查/创建 YAML frontmatter（title、slug、summary、featureImage）
+3. 处理标题：使用现有标题、提取 H1 或生成候选标题
+4. 应用格式：层级标题、加粗、列表、代码块、引用
+5. 保存为 `{文件名}-formatted.md`
+6. 运行排版脚本：半角引号→全角引号、中英文空格、autocorrect
+
+**Frontmatter 字段**：
+| 字段 | 处理方式 |
+|------|----------|
+| `title` | 使用现有、提取 H1 或生成候选 |
+| `slug` | 从文件路径推断或根据标题生成 |
+| `summary` | 生成吸引人的摘要（100-150 字） |
+| `featureImage` | 检查同目录下 `imgs/cover.png` |
+
+**格式化规则**：
+| 元素 | 格式 |
+|------|------|
+| 标题 | `#`、`##`、`###` 层级 |
+| 重点内容 | `**加粗**` |
+| 并列要点 | `-` 无序列表或 `1.` 有序列表 |
+| 代码/命令 | `` `行内` `` 或 ` ```代码块``` ` |
+| 引用 | `>` 引用块 |
+
 ## 环境配置

 部分技能需要 API 密钥或自定义配置。环境变量可以在 `.env` 文件中设置：
@@ -673,6 +763,11 @@ OPENAI_IMAGE_MODEL=gpt-image-1.5
 GOOGLE_API_KEY=xxx
 GOOGLE_IMAGE_MODEL=gemini-3-pro-image-preview
 # GOOGLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta
+
+# DashScope（阿里通义万相）
+DASHSCOPE_API_KEY=sk-xxx
+DASHSCOPE_IMAGE_MODEL=z-image-turbo
+# DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1
 EOF
 ```

@@ -701,13 +796,14 @@ mkdir -p .baoyu-skills/baoyu-cover-image
 然后创建 `.baoyu-skills/baoyu-cover-image/EXTEND.md`：

 ```markdown
-## 自定义风格
+## 自定义配色

-### brand
- 主色：#1a73e8
- 辅色：#34a853
- 字体风格：现代无衬线
- 始终包含公司 logo 水印
+### corporate-tech
+- 主色：#1a73e8、#4A90D9
+- 背景色：#F5F7FA
+- 强调色：#00B4D8、#48CAE4
+- 装饰提示：简洁线条、渐变效果
+- 适用于：SaaS、企业、技术内容
 ```

 扩展内容会在技能执行前加载，并覆盖默认设置。
@@ -1,376 +1,468 @@
 ---
 name: baoyu-article-illustrator
-description: Smart article illustration skill. Analyzes article content and generates illustrations at positions requiring visual aids with multiple style options. Use when user asks to "add illustrations to article", "generate images for article", or "illustrate article".
+description: Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style two-dimension approach. Use when user asks to "illustrate article", "add images", "generate images for article", or "为文章配图".
 ---

-# Smart Article Illustration Skill
+# Article Illustrator

-Analyze article structure and content, identify positions requiring visual aids, and generate illustrations with flexible style options.
+Analyze articles, identify illustration positions, generate images with Type × Style consistency.

-## Usage
+## Two Dimensions

-```bash
-# Auto-select style based on content
-/baoyu-article-illustrator path/to/article.md
+| Dimension | Controls | Examples |
+|-----------|----------|----------|
+| **Type** | Information structure, layout | infographic, scene, flowchart, comparison, framework, timeline |
+| **Style** | Visual aesthetics, mood | notion, warm, minimal, blueprint, watercolor, elegant |

-# Specify a style
-/baoyu-article-illustrator path/to/article.md --style warm
-/baoyu-article-illustrator path/to/article.md --style minimal
-/baoyu-article-illustrator path/to/article.md --style watercolor
+Type × Style can be freely combined. Example: `--type infographic --style blueprint`

-# Combine with other options
-/baoyu-article-illustrator path/to/article.md --style playful
-```
+## Type Gallery

-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--style <name>` | Specify illustration style (see Style Gallery below) |
+| Type | Best For |
+|------|----------|
+| `infographic` | Data, metrics, technical articles |
+| `scene` | Narratives, personal stories, emotional content |
+| `flowchart` | Tutorials, workflows, processes |
+| `comparison` | Side-by-side, before/after, options |
+| `framework` | Methodologies, models, architecture |
+| `timeline` | History, progress, evolution |

 ## Style Gallery

-| Style | Description | Best For |
-|-------|-------------|----------|
-| `notion` (Default) | Minimalist hand-drawn line art, intellectual | Knowledge sharing, SaaS, productivity |
-| `elegant` | Refined, sophisticated, professional | Business, thought leadership |
-| `warm` | Friendly, approachable, human-centered | Personal growth, lifestyle, education |
-| `minimal` | Ultra-clean, zen-like, focused | Philosophy, minimalism, core concepts |
-| `playful` | Fun, creative, whimsical | Tutorials, beginner guides, fun topics |
-| `nature` | Organic, calm, earthy | Sustainability, wellness, outdoor |
-| `sketch` | Raw, authentic, notebook-style | Ideas, brainstorming, drafts |
-| `watercolor` | Soft artistic with natural warmth | Lifestyle, travel, creative |
-| `vintage` | Nostalgic aged-paper aesthetic | Historical, biography, heritage |
-| `scientific` | Academic precise diagrams | Biology, chemistry, technical |
-| `chalkboard` | Classroom chalk drawing style | Education, tutorials, workshops |
-| `editorial` | Magazine-style infographic | Tech explainers, journalism |
-| `flat` | Modern flat vector illustration | Startups, digital, contemporary |
-| `flat-doodle` | Bold outlines, pastel colors, cute | Productivity, SaaS, workflows |
-| `retro` | 80s/90s vibrant nostalgic | Pop culture, gaming, entertainment |
-| `blueprint` | Technical schematics, engineering precision | Architecture, system design |
-| `vector-illustration` | Flat vector with black outlines, retro colors | Educational, creative, brand content |
-| `sketch-notes` | Soft hand-drawn, warm educational feel | Knowledge sharing, tutorials |
-| `pixel-art` | Retro 8-bit gaming aesthetic | Gaming, tech, developer content |
-| `intuition-machine` | Technical briefing with bilingual labels | Academic, technical, bilingual |
-| `fantasy-animation` | Ghibli/Disney whimsical style | Storytelling, children's, creative |
+| Style | Best For |
+|-------|----------|
+| `notion` (Default) | Knowledge sharing, SaaS, productivity |
+| `elegant` | Business, thought leadership |
+| `warm` | Personal growth, lifestyle, education |
+| `minimal` | Philosophy, core concepts |
+| `blueprint` | Architecture, system design |
+| `watercolor` | Lifestyle, travel, creative |
+| `editorial` | Tech explainers, journalism |
+| `scientific` | Academic, technical research |

-Full style specifications in `references/styles/<style>.md`
+Full styles: [references/styles.md](references/styles.md)

-## Auto Style Selection
+## Auto Selection

-When no `--style` is specified, analyze content to select the best style:
-
-| Content Signals | Selected Style |
-|----------------|----------------|
-| Personal story, emotion, growth, life, feeling, relationship | `warm` |
-| Simple, zen, focus, essential, core, minimalist | `minimal` |
-| Fun, easy, beginner, tutorial, guide, how-to, learn | `playful` |
-| Nature, eco, wellness, health, organic, green, outdoor | `nature` |
-| Idea, thought, concept, draft, brainstorm, sketch | `sketch` |
-| Business, professional, strategy, analysis, corporate | `elegant` |
-| Knowledge, concept, productivity, SaaS, notion, tool | `notion` |
-| Lifestyle, travel, food, art, creative, artistic | `watercolor` |
-| History, heritage, vintage, biography, classic, expedition | `vintage` |
-| Biology, chemistry, medical, scientific, research, academic | `scientific` |
-| Education, classroom, teaching, school, lecture, workshop | `chalkboard` |
-| Explainer, journalism, magazine, in-depth, investigation | `editorial` |
-| Modern, startup, app, product, digital marketing, saas | `flat` |
-| Productivity, workflow, cute, tools, app tutorial | `flat-doodle` |
-| 80s, 90s, retro, pop culture, music, nostalgia | `retro` |
-| Architecture, system, infrastructure, engineering, technical | `blueprint` |
-| Brand, explainer, children, cute, toy, geometric | `vector-illustration` |
-| Notes, doodle, friendly, warm tutorial, onboarding | `sketch-notes` |
-| Gaming, 8-bit, pixel, developer, retro tech | `pixel-art` |
-| Bilingual, briefing, academic, research, documentation | `intuition-machine` |
-| Fantasy, story, magical, Ghibli, Disney, children | `fantasy-animation` |
-| Default | `notion` |
-
-## File Management
-
-### Output Directory
-
-Each session creates an independent directory named by content slug:
-
-```
-illustrations/{topic-slug}/
-├── source-{slug}.{ext}    # Source files (text, images, etc.)
-├── outline.md
-├── outline-{style}.md     # Style variant outlines
-├── prompts/
-│   ├── illustration-concept-a.md
-│   ├── illustration-concept-b.md
-│   └── ...
-├── illustration-concept-a.png
-├── illustration-concept-b.png
-└── ...
-```
-
-**Slug Generation**:
-1. Extract main topic from content (2-4 words, kebab-case)
-2. Example: "The Future of AI" → `future-of-ai`
-
-### Conflict Resolution
-
-If `illustrations/{topic-slug}/` already exists:
- Append timestamp: `{topic-slug}-YYYYMMDD-HHMMSS`
- Example: `ai-future` exists → `ai-future-20260118-143052`
-
-### Source Files
-
-Copy all sources with naming `source-{slug}.{ext}`:
- `source-article.md` (main text content)
- `source-photo.jpg` (image from conversation)
- `source-reference.pdf` (additional file)
-
-Multiple sources supported: text, images, files from conversation.
+| Content Signals | Type | Style |
+|-----------------|------|-------|
+| API, metrics, data, numbers | infographic | blueprint, notion |
+| Story, emotion, journey | scene | warm, watercolor |
+| How-to, steps, workflow | flowchart | notion, minimal |
+| vs, pros/cons, before/after | comparison | notion, elegant |
+| Framework, model, architecture | framework | blueprint, notion |
+| History, timeline, progress | timeline | elegant, warm |

 ## Workflow

-### Step 1: Analyze Content & Select Style
+Copy this checklist and track progress:

-1. Read article content
-2. If `--style` specified, use that style
-3. Otherwise, scan for style signals and auto-select
-4. **Language detection**:
-   - Detect **source language** from article content
-   - Detect **user language** from conversation context
-   - Note if source_language ≠ user_language (will ask in Step 4)
-5. Extract key information:
-   - Main topic and themes
-   - Core messages per section
-   - Abstract concepts needing visualization
+```
+Progress:
+- [ ] Step 1: Pre-check
+  - [ ] 1.5 Check preferences (EXTEND.md) ⛔ BLOCKING
+    - [ ] Found → load preferences → continue
+    - [ ] Not found → run first-time setup → MUST complete before other steps
+  - [ ] 1.0 Reference images ⚠️ (if provided)
+    - [ ] File path given → saved to references/ ✓
+    - [ ] No path → asked user OR extracted verbally
+  - [ ] 1.2-1.4 Config questions (1 AskUserQuestion, max 4 Qs)
+- [ ] Step 2: Setup & Analyze
+- [ ] Step 3: Confirm Settings (1 AskUserQuestion, max 4 Qs)
+  - [ ] Q1: Type ⚠️
+  - [ ] Q2: Density ⚠️ MUST ASK
+  - [ ] Q3: Style ⚠️
+- [ ] Step 4: Generate Outline
+- [ ] Step 5: Generate Images
+  - [ ] 5.1 Prompts created (references in frontmatter ONLY if files exist)
+  - [ ] 5.3 References verified before generation
+- [ ] Step 6: Finalize
+```

-### Step 2: Identify Illustration Positions
+---

-**Three Purposes of Illustrations**:
-1. **Information Supplement**: Help understand abstract concepts
-2. **Concept Visualization**: Transform abstract ideas into concrete visuals
-3. **Imagination Guidance**: Create atmosphere, enhance reading experience
+### Step 1: Pre-check

-**Content Suitable for Illustrations**:
- Abstract concepts needing visualization
- Processes/steps needing diagrams
- Comparisons needing visual representation
- Core arguments needing reinforcement
- Scenarios needing imagination guidance
+**1.0 Detect & Save Reference Images** ⚠️ REQUIRED if images provided

-**Illustration Count**:
- Consider at least 1 image per major section
- Prioritize core arguments and abstract concepts
- **Principle: More is better than fewer**
+Check if user provided reference images. Handle based on input type:

-### Step 3: Generate Illustration Plan
+| Input Type | Action |
+|------------|--------|
+| Image file path provided | Copy to `references/` subdirectory → can use `--ref` |
+| Image in conversation (no path) | **ASK user for file path** with AskUserQuestion |
+| User can't provide path | Extract style/palette verbally → append to prompts (NO frontmatter references) |

-```markdown
-# Illustration Plan
+**CRITICAL**: Only add `references` to prompt frontmatter if files are ACTUALLY SAVED to `references/` directory.

-**Article**: [article path]
-**Style**: [selected style]
-**Illustration Count**: N images
+**If user provides file path**:
+1. Copy to `references/NN-ref-{slug}.png`
+2. Create description: `references/NN-ref-{slug}.md`
+3. Verify files exist before proceeding

+**If user can't provide path** (extracted verbally):
+1. Analyze image visually, extract: colors, style, composition
+2. Create `references/extracted-style.md` with extracted info
+3. DO NOT add `references` to prompt frontmatter
+4. Instead, append extracted style/colors directly to prompt text
+
+**Description File Format** (only when file saved):
+```yaml
+---
+ref_id: NN
+filename: NN-ref-{slug}.png
+---
+[User's description or auto-generated description]
+```
+
+**Verification** (only for saved files):
+```
+Reference Images Saved:
+- 01-ref-{slug}.png ✓ (can use --ref)
+- 02-ref-{slug}.png ✓ (can use --ref)
+```
+
+**Or for extracted style**:
+```
+Reference Style Extracted (no file):
+- Colors: #E8756D coral, #7ECFC0 mint...
+- Style: minimal flat vector, clean lines...
+→ Will append to prompt text (not --ref)
+```
+
+---
+
+**1.1 Determine Input Type**
+
+| Input | Output Directory | Next |
+|-------|------------------|------|
+| File path | Ask user (1.2) | → 1.2 |
+| Pasted content | `illustrations/{topic-slug}/` | → 1.4 |
+
+**Backup rule for pasted content**: If `source.md` exists in target directory, rename to `source-backup-YYYYMMDD-HHMMSS.md` before saving.
+
+**1.2-1.4 Configuration** (file path input only)
+
+Check preferences and existing state, then ask ALL needed questions in ONE AskUserQuestion call (max 4 questions).
+
+**Questions to include** (skip if preference exists or not applicable):
+
+| Question | When to Ask | Options |
+|----------|-------------|---------|
+| Output directory | No `default_output_dir` in EXTEND.md | `{article-dir}/`, `{article-dir}/imgs/` (Recommended), `{article-dir}/illustrations/`, `illustrations/{topic-slug}/` |
+| Existing images | Target dir has `.png/.jpg/.webp` files | `supplement`, `overwrite`, `regenerate` |
+| Article update | Always (file path input) | `update`, `copy` |
+
+**Preference Values** (if configured, skip asking):
+
+| `default_output_dir` | Path |
+|----------------------|------|
+| `same-dir` | `{article-dir}/` |
+| `imgs-subdir` | `{article-dir}/imgs/` |
+| `illustrations-subdir` | `{article-dir}/illustrations/` |
+| `independent` | `illustrations/{topic-slug}/` |
+
+**1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING**
+
+**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to reference images, do NOT ask about content, do NOT ask about type/style — ONLY complete the preferences setup first.
+
+```bash
+test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
+test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
+```
+
+| Result | Action |
+|--------|--------|
+| Found | Read, parse, display summary → Continue |
+| Not found | ⛔ **BLOCKING**: Run first-time setup ONLY ([references/config/first-time-setup.md](references/config/first-time-setup.md)) → Complete and save EXTEND.md → Then continue |
+
+**Supports**: Watermark | Preferred type/style | Custom styles | Language | Output directory
+
+---
+
+### Step 2: Setup & Analyze
+
+**2.1 Analyze Content**
+
+| Analysis | Description |
+|----------|-------------|
+| Content type | Technical / Tutorial / Methodology / Narrative |
+| Core arguments | 2-5 main points to visualize |
+| Visual opportunities | Positions where illustrations add value |
+| Recommended type | Based on content signals |
+| Recommended density | Based 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 illustrations
+
+**2.4 Analyze Reference Images** (if provided in Step 1.0)
+
+For each reference image:
+
+| Analysis | Description |
+|----------|-------------|
+| Visual characteristics | Style, colors, composition |
+| Content/subject | What the reference depicts |
+| Suitable positions | Which sections match this reference |
+| Style match | Which illustration types/styles align |
+| Usage recommendation | `direct` / `style` / `palette` |
+
+| Usage | When to Use |
+|-------|-------------|
+| `direct` | Reference matches desired output closely |
+| `style` | Extract visual style characteristics only |
+| `palette` | Extract color scheme only |
+
+---
+
+### Step 3: Confirm Settings ⚠️
+
+**Do NOT skip.** Use ONE AskUserQuestion call with max 4 questions. **Q1, Q2, Q3 are ALL REQUIRED.**
+
+**Q1: Illustration Type** ⚠️ REQUIRED
+- [Recommended based on analysis] (Recommended)
+- infographic / scene / flowchart / comparison / framework / timeline / mixed
+
+**Q2: Density** ⚠️ REQUIRED - DO NOT SKIP
+- minimal (1-2) - Core concepts only
+- balanced (3-5) - Major sections
+- per-section - At least 1 per section/chapter (Recommended)
+- rich (6+) - Comprehensive coverage
+
+**Q3: Style** ⚠️ REQUIRED (ALWAYS ask, even with preferred_style in EXTEND.md)
+
+If EXTEND.md has `preferred_style`:
+- [Custom style name + brief description] (Recommended)
+- [Top compatible built-in style 1]
+- [Top compatible built-in style 2]
+- [Top compatible built-in style 3]
+
+If no `preferred_style`:
+- [Best compatible from matrix] (Recommended)
+- [Other ✓✓ style 1]
+- [Other ✓✓ style 2]
+- [Other ✓ style]
+
+Style selection based on Type × Style compatibility matrix (references/styles.md).
+Full specs: `references/styles/<style>.md`
+
+**Q4** (only if source ≠ user language):
+- Language: Source / User language
+
+**Display Reference Usage** (if references detected in Step 1.0):
+
+When presenting outline preview to user, show reference assignments:
+
+```
+Reference Images:
+| Ref | Filename | Recommended Usage |
+|-----|----------|-------------------|
+| 01 | 01-ref-diagram.png | direct → Illustration 1, 3 |
+| 02 | 02-ref-chart.png | palette → Illustration 2 |
+```
+
+---
+
+### Step 4: Generate Outline
+
+Save as `outline.md`:
+
+```yaml
+---
+type: infographic
+density: balanced
+style: blueprint
+image_count: 4
+references:                    # Only if references provided
+  - ref_id: 01
+    filename: 01-ref-diagram.png
+    description: "Technical diagram showing system architecture"
+  - ref_id: 02
+    filename: 02-ref-chart.png
+    description: "Color chart with brand palette"
 ---

 ## Illustration 1

-**Insert Position**: [section name] / [paragraph description]
-**Purpose**: [why illustration needed here]
-**Visual Content**: [what the image should show]
-**Filename**: illustration-[slug].png
-
---
+**Position**: [section] / [paragraph]
+**Purpose**: [why this helps]
+**Visual Content**: [what to show]
+**Type Application**: [how type applies]
+**References**: [01]                    # Optional: list ref_ids used
+**Reference Usage**: direct             # direct | style | palette
+**Filename**: 01-infographic-concept-name.png

 ## Illustration 2
 ...
 ```

-### Step 4: Review & Confirm
+**Requirements**:
+- Each position justified by content needs
+- Type applied consistently
+- Style reflected in descriptions
+- Count matches density
+- References assigned based on Step 2.4 analysis

-**Purpose**: Let user confirm all options in a single step before image generation.
+---

-**IMPORTANT**: Present ALL options in a single confirmation step using AskUserQuestion. Do NOT interrupt workflow with multiple separate confirmations.
+### Step 5: Generate Images

-1. **Generate 3 style variants**:
-   - Analyze content to select 3 most suitable styles
-   - Generate complete illustration plan for each style variant
-   - Save as `outline-{style}.md` (e.g., `outline-notion.md`, `outline-tech.md`, `outline-warm.md`)
+**5.1 Create Prompts**

-2. **Determine which questions to ask**:
+Follow [references/prompt-construction.md](references/prompt-construction.md). Save to `prompts/illustration-{slug}.md`.
+- **Backup rule**: If prompt file exists, rename to `prompts/illustration-{slug}-backup-YYYYMMDD-HHMMSS.md`

-   | Question | When to Ask |
-   |----------|-------------|
-   | Style variant | Always (required) |
-   | Language | Only if `source_language ≠ user_language` |
+**CRITICAL - References in Frontmatter**:
+- Only add `references` field if files ACTUALLY EXIST in `references/` directory
+- If style/palette was extracted verbally (no file), append info to prompt BODY instead
+- Before writing frontmatter, verify: `test -f references/NN-ref-{slug}.png`

-3. **Present options** (use AskUserQuestion with all applicable questions):
+**5.2 Select Generation Skill**

-   **Question 1 (Style)** - always:
-   - Style A (recommended): [style name] - [brief description]
-   - Style B: [style name] - [brief description]
-   - Style C: [style name] - [brief description]
-   - Custom: Provide custom style reference
+Check available skills. If multiple, ask user.

-   **Question 2 (Language)** - only if source ≠ user language:
-   - [Source language] (matches article language)
-   - [User language] (your preference)
+**5.3 Process References** ⚠️ REQUIRED if references saved in Step 1.0

-   **Language handling**:
-   - If source language = user language: Just inform user (e.g., "Prompts will be in Chinese")
-   - If different: Ask which language to use for prompts
+**DO NOT SKIP if user provided reference images.** For each illustration with references:

-4. **Apply selection**:
-   - Copy selected `outline-{style}.md` to `outline.md`
-   - If custom style provided, generate new plan with that style
-   - If different language selected, regenerate outline in that language
-   - User may edit `outline.md` directly for fine-tuning
-   - If modified, reload plan before proceeding
+1. **VERIFY files exist first**:
+   ```bash
+   test -f references/NN-ref-{slug}.png && echo "exists" || echo "MISSING"
+   ```
+   - If file MISSING but in frontmatter → ERROR, fix frontmatter or remove references field
+   - If file exists → proceed with processing

-5. **Proceed only after explicit user confirmation**
+2. Read prompt frontmatter for reference info
+3. Process based on usage type:

-### Step 5: Create Prompt Files
+| Usage | Action | Example |
+|-------|--------|---------|
+| `direct` | Add reference path to `--ref` parameter | `--ref references/01-ref-brand.png` |
+| `style` | Analyze reference, append style traits to prompt | "Style: clean lines, gradient backgrounds..." |
+| `palette` | Extract colors from reference, append to prompt | "Colors: #E8756D coral, #7ECFC0 mint..." |

-Save prompts to `prompts/` directory with style-specific details.
+3. Check image generation skill capability:

-**All prompts are written in the user's confirmed language preference.**
+| Skill Supports `--ref` | Action |
+|------------------------|--------|
+| Yes (e.g., baoyu-image-gen with Google) | Pass reference images via `--ref` |
+| No | Convert to text description, append to prompt |

-**Prompt Format**:
-
-```markdown
-Illustration theme: [concept in 2-3 words]
-Style: [style name]
-
-Visual composition:
- Main visual: [description matching style]
- Layout: [element positioning]
- Decorative elements: [style-appropriate decorations]
-
-Color scheme:
- Primary: [style primary color]
- Background: [style background color]
- Accent: [style accent color]
-
-Text content (if any):
- [Any labels or captions in content language]
-
-Style notes: [specific style characteristics]
+**Verification**: Before generating, confirm reference processing:
+```
+Reference Processing:
+- Illustration 1: using 01-ref-brand.png (direct) ✓
+- Illustration 2: extracted palette from 02-ref-style.png ✓
 ```

-### Step 6: Generate Images
+**5.4 Apply Watermark** (if enabled)

-**Image Generation Skill Selection**:
-1. Check available image generation skills
-2. If multiple skills available, ask user to choose
+Add: `Include a subtle watermark "[content]" at [position].`

-**Generation Flow**:
-1. Call selected image generation skill with prompt file and output path
-2. Generate images sequentially
-3. After each image, output progress: "Generated X/N"
-4. On failure, auto-retry once
-5. If retry fails, log reason, continue to next
+**5.5 Generate**

-### Step 7: Update Article
+1. For each illustration:
+   - **Backup rule**: If image file exists, rename to `NN-{type}-{slug}-backup-YYYYMMDD-HHMMSS.png`
+   - If references with `direct` usage: include `--ref` parameter
+   - Generate image
+2. After each: "Generated X/N"
+3. On failure: retry once, then log and continue

-Insert generated images at corresponding positions:
+---

+### Step 6: Finalize
+
+**6.1 Update Article**
+
+Insert after corresponding paragraph:
 ```markdown
-![illustration description]([article-name]/illustrations/illustration-[slug].png)
+![description](illustrations/{slug}/NN-{type}-{slug}.png)
 ```

-**Insertion Rules**:
- Insert image after corresponding paragraph
- Leave one blank line before and after image
- Alt text uses concise description in article's language
+Alt text: concise description in article's language.

-### Step 8: Output Summary
+**6.2 Output Summary**

 ```
 Article Illustration Complete!

-Article: [article path]
-Style: [style name]
-Generated: X/N images successful
+Article: [path]
+Type: [type] | Density: [level] | Style: [style]
+Location: [directory]
+Images: X/N generated

-Illustration Positions:
- illustration-xxx.png → After section "Section Name"
- illustration-yyy.png → After section "Another Section"
-...
+Positions:
+- 01-xxx.png → After "[Section]"
+- 02-yyy.png → After "[Section]"

-[If any failures]
+[If failures]
 Failed:
- illustration-zzz.png: [failure reason]
+- NN-zzz.png: [reason]
 ```

-## Illustration Modification
+---

-Support for modifying individual illustrations after initial generation.
+## Output Directory

-### Edit Single Illustration
-
-Regenerate a specific illustration with modified prompt:
-
-1. Identify illustration to edit (e.g., `illustration-concept-overview.png`)
-2. Update prompt in `prompts/illustration-concept-overview.md` if needed
-3. If content changes significantly, update slug in filename
-4. Regenerate image
-5. Update article if image reference changed
-
-### Add New Illustration
-
-Add a new illustration to the article:
-
-1. Identify insertion position in article
-2. Create new prompt with appropriate slug (e.g., `illustration-new-concept.md`)
-3. Generate new illustration image
-4. Update `outline.md` with new illustration entry
-5. Insert image reference in article at the specified position
-
-### Delete Illustration
-
-Remove an illustration from the article:
-
-1. Identify illustration to delete (e.g., `illustration-concept-overview.png`)
-2. Remove image file and prompt file
-3. Remove image reference from article
-4. Update `outline.md` to remove illustration entry
-
-### File Naming Convention
-
-Files use meaningful slugs for better readability:
 ```
-illustration-[slug].png
-illustration-[slug].md (in prompts/)
+illustrations/{topic-slug}/
+├── source-{slug}.{ext}
+├── references/                    # Only if references provided
+│   ├── 01-ref-{slug}.png
+│   ├── 01-ref-{slug}.md           # Description file (optional)
+│   └── ...
+├── outline.md
+├── prompts/
+│   └── illustration-{slug}.md
+└── NN-{type}-{slug}.png
 ```

-Examples:
- `illustration-concept-overview.png`
- `illustration-workflow-diagram.png`
- `illustration-key-benefits.png`
+**Slug**: 2-4 word topic in kebab-case.
+**Conflict**: Append `-YYYYMMDD-HHMMSS` if exists.

-**Slug rules**:
- Derived from illustration purpose/content (kebab-case)
- Must be unique within the article
- When content changes significantly, update slug accordingly
+## Modification
+
+| Action | Steps |
+|--------|-------|
+| **Edit** | **Update prompt file FIRST** → Regenerate → Update reference |
+| **Add** | Identify position → Create prompt → Generate → Update outline → Insert |
+| **Delete** | Delete files → Remove reference → Update outline |
+
+**IMPORTANT**: When updating illustrations, ALWAYS update the prompt file (`prompts/illustration-{slug}.md`) FIRST before regenerating. This ensures:
+1. Changes are documented and reproducible
+2. The prompt reflects the new requirements
+3. Future regeneration uses the correct prompt

 ## References

 | File | Content |
 |------|---------|
-| `references/styles/<style>.md` | Full style specifications with colors, elements, rules |
-
-## Notes
-
- Illustrations serve the content: supplement information, visualize concepts
- Maintain selected style consistency across all illustrations in one article
- Image generation typically takes 10-30 seconds per image
- Sensitive figures should use cartoon alternatives
- Prompts written in user's confirmed language preference
- Illustration text (labels, captions) should match article language
+| [references/usage.md](references/usage.md) | Command syntax and options |
+| [references/styles.md](references/styles.md) | Style gallery & compatibility |
+| [references/prompt-construction.md](references/prompt-construction.md) | Prompt templates |
+| `references/styles/<style>.md` | Full style specifications |
+| `references/config/preferences-schema.md` | EXTEND.md schema |
+| `references/config/first-time-setup.md` | First-time setup flow |

 ## Extension Support

-Custom styles and configurations via EXTEND.md.
-
-**Check paths** (priority order):
-1. `.baoyu-skills/baoyu-article-illustrator/EXTEND.md` (project)
-2. `~/.baoyu-skills/baoyu-article-illustrator/EXTEND.md` (user)
-
-If found, load before Step 1. Extension content overrides defaults.
+Custom configurations via EXTEND.md. See **Step 1.5** for paths and supported options.
@@ -0,0 +1,121 @@
+---
+name: first-time-setup
+description: First-time setup flow for baoyu-article-illustrator preferences
+---
+
+# First-Time Setup
+
+## Overview
+
+When no EXTEND.md is found, guide user through preference setup.
+
+**⛔ BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
+- Ask about reference images
+- Ask about content/article
+- Ask about type or style preferences
+- Proceed to content analysis
+
+ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
+
+## Setup Flow
+
+```
+No EXTEND.md found
+        │
+        ▼
+┌─────────────────────┐
+│ AskUserQuestion     │
+│ (all questions)     │
+└─────────────────────┘
+        │
+        ▼
+┌─────────────────────┐
+│ Create EXTEND.md    │
+└─────────────────────┘
+        │
+        ▼
+    Continue to Step 1
+```
+
+## Questions
+
+**Language**: Use user's input language or preferred language for all questions. Do not always use English.
+
+Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):
+
+### Question 1: Watermark
+
+```
+header: "Watermark"
+question: "Watermark text for generated illustrations? Type your watermark content (e.g., name, @handle)"
+options:
+  - label: "No watermark (Recommended)"
+    description: "No watermark, can enable later in EXTEND.md"
+```
+
+Position defaults to bottom-right.
+
+### Question 2: Preferred Style
+
+```
+header: "Style"
+question: "Default illustration style preference? Or type another style name or your custom style"
+options:
+  - label: "None (Recommended)"
+    description: "Auto-select based on content analysis"
+  - label: "notion"
+    description: "Minimalist hand-drawn line art"
+  - label: "warm"
+    description: "Friendly, approachable, personal"
+```
+
+### Question 3: Save Location
+
+```
+header: "Save"
+question: "Where to save preferences?"
+options:
+  - label: "Project"
+    description: ".baoyu-skills/ (this project only)"
+  - label: "User"
+    description: "~/.baoyu-skills/ (all projects)"
+```
+
+## Save Locations
+
+| Choice | Path | Scope |
+|--------|------|-------|
+| Project | `.baoyu-skills/baoyu-article-illustrator/EXTEND.md` | Current project |
+| User | `~/.baoyu-skills/baoyu-article-illustrator/EXTEND.md` | All projects |
+
+## After Setup
+
+1. Create directory if needed
+2. Write EXTEND.md with frontmatter
+3. Confirm: "Preferences saved to [path]"
+4. Continue to Step 1
+
+## EXTEND.md Template
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: [true/false]
+  content: "[user input or empty]"
+  position: bottom-right
+  opacity: 0.7
+preferred_style:
+  name: [selected style or null]
+  description: ""
+language: null
+custom_styles: []
+---
+```
+
+## Modifying Preferences Later
+
+Users can edit EXTEND.md directly or run setup again:
+- Delete EXTEND.md to trigger setup
+- Edit YAML frontmatter for quick changes
+- Full schema: `config/preferences-schema.md`
@@ -0,0 +1,124 @@
+---
+name: preferences-schema
+description: EXTEND.md YAML schema for baoyu-article-illustrator user preferences
+---
+
+# Preferences Schema
+
+## Full Schema
+
+```yaml
+---
+version: 1
+
+watermark:
+  enabled: false
+  content: ""
+  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right
+
+preferred_style:
+  name: null              # Built-in or custom style name
+  description: ""         # Override/notes
+
+language: null            # zh|en|ja|ko|auto
+
+default_output_dir: null  # same-dir|illustrations-subdir|independent
+
+custom_styles:
+  - name: my-style
+    description: "Style description"
+    color_palette:
+      primary: ["#1E3A5F", "#4A90D9"]
+      background: "#F5F7FA"
+      accents: ["#00B4D8", "#48CAE4"]
+    visual_elements: "Clean lines, geometric shapes"
+    typography: "Modern sans-serif"
+    best_for: "Business, education"
+---
+```
+
+## Field Reference
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `version` | int | 1 | Schema version |
+| `watermark.enabled` | bool | false | Enable watermark |
+| `watermark.content` | string | "" | Watermark text (@username or custom) |
+| `watermark.position` | enum | bottom-right | Position on image |
+| `preferred_style.name` | string | null | Style name or null |
+| `preferred_style.description` | string | "" | Custom notes/override |
+| `language` | string | null | Output language (null = auto-detect) |
+| `default_output_dir` | enum | null | Output directory preference (null = ask each time) |
+| `custom_styles` | array | [] | User-defined styles |
+
+## Position Options
+
+| Value | Description |
+|-------|-------------|
+| `bottom-right` | Lower right corner (default, most common) |
+| `bottom-left` | Lower left corner |
+| `bottom-center` | Bottom center |
+| `top-right` | Upper right corner |
+
+## Output Directory Options
+
+| Value | Description |
+|-------|-------------|
+| `same-dir` | Same directory as article |
+| `illustrations-subdir` | `{article-dir}/illustrations/` subdirectory |
+| `independent` | `illustrations/{topic-slug}/` in working directory |
+
+## Custom Style Fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Unique style identifier (kebab-case) |
+| `description` | Yes | What the style conveys |
+| `color_palette.primary` | No | Main colors (array) |
+| `color_palette.background` | No | Background color |
+| `color_palette.accents` | No | Accent colors (array) |
+| `visual_elements` | No | Decorative elements |
+| `typography` | No | Font/lettering style |
+| `best_for` | No | Recommended content types |
+
+## Example: Minimal Preferences
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: true
+  content: "@myusername"
+preferred_style:
+  name: notion
+---
+```
+
+## Example: Full Preferences
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: true
+  content: "@myaccount"
+  position: bottom-right
+
+preferred_style:
+  name: notion
+  description: "Clean illustrations for tech articles"
+
+language: zh
+
+custom_styles:
+  - name: corporate
+    description: "Professional B2B style"
+    color_palette:
+      primary: ["#1E3A5F", "#4A90D9"]
+      background: "#F5F7FA"
+      accents: ["#00B4D8", "#48CAE4"]
+    visual_elements: "Clean lines, subtle gradients, geometric shapes"
+    typography: "Modern sans-serif, professional"
+    best_for: "Business, SaaS, enterprise"
+---
+```
@@ -0,0 +1,176 @@
+# Prompt Construction
+
+## Prompt File Format
+
+Each prompt file uses YAML frontmatter + content:
+
+```yaml
+---
+illustration_id: 01
+type: infographic
+style: blueprint
+references:                    # ⚠️ ONLY if files EXIST in references/ directory
+  - ref_id: 01
+    filename: 01-ref-diagram.png
+    usage: direct              # direct | style | palette
+---
+
+[Type-specific template content below...]
+```
+
+**⚠️ CRITICAL - When to include `references` field**:
+
+| Situation | Action |
+|-----------|--------|
+| Reference file saved to `references/` | Include in frontmatter ✓ |
+| Style extracted verbally (no file) | DO NOT include in frontmatter, append to prompt body instead |
+| File path in frontmatter but file doesn't exist | ERROR - remove references field |
+
+**Reference Usage Types** (only when file exists):
+
+| Usage | Description | Generation Action |
+|-------|-------------|-------------------|
+| `direct` | Primary visual reference | Pass to `--ref` parameter |
+| `style` | Style characteristics only | Describe style in prompt text |
+| `palette` | Color palette extraction | Include colors in prompt |
+
+**If no reference file but style/palette extracted verbally**, append directly to prompt body:
+```
+COLORS (from reference):
+- Primary: #E8756D coral
+- Secondary: #7ECFC0 mint
+...
+
+STYLE (from reference):
+- Clean lines, minimal shadows
+- Gradient backgrounds
+...
+```
+
+---
+
+## Principles
+
+Good prompts must include:
+
+1. **Layout Structure First**: Describe composition, zones, flow direction
+2. **Specific Data/Labels**: Use actual numbers, terms from article
+3. **Visual Relationships**: How elements connect
+4. **Semantic Colors**: Meaning-based color choices (red=warning, green=efficient)
+5. **Style Characteristics**: Line treatment, texture, mood
+6. **Aspect Ratio**: End with ratio and complexity level
+
+## Type-Specific Templates
+
+### Infographic
+
+```
+[Title] - Data Visualization
+
+Layout: [grid/radial/hierarchical]
+
+ZONES:
+- Zone 1: [data point with specific values]
+- Zone 2: [comparison with metrics]
+- Zone 3: [summary/conclusion]
+
+LABELS: [specific numbers, percentages, terms from article]
+COLORS: [semantic color mapping]
+STYLE: [style characteristics]
+ASPECT: 16:9
+```
+
+### Scene
+
+```
+[Title] - Atmospheric Scene
+
+FOCAL POINT: [main subject]
+ATMOSPHERE: [lighting, mood, environment]
+MOOD: [emotion to convey]
+COLOR TEMPERATURE: [warm/cool/neutral]
+STYLE: [style characteristics]
+ASPECT: 16:9
+```
+
+### Flowchart
+
+```
+[Title] - Process Flow
+
+Layout: [left-right/top-down/circular]
+
+STEPS:
+1. [Step name] - [brief description]
+2. [Step name] - [brief description]
+...
+
+CONNECTIONS: [arrow types, decision points]
+STYLE: [style characteristics]
+ASPECT: 16:9
+```
+
+### Comparison
+
+```
+[Title] - Comparison View
+
+LEFT SIDE - [Option A]:
+- [Point 1]
+- [Point 2]
+
+RIGHT SIDE - [Option B]:
+- [Point 1]
+- [Point 2]
+
+DIVIDER: [visual separator]
+STYLE: [style characteristics]
+ASPECT: 16:9
+```
+
+### Framework
+
+```
+[Title] - Conceptual Framework
+
+STRUCTURE: [hierarchical/network/matrix]
+
+NODES:
+- [Concept 1] - [role]
+- [Concept 2] - [role]
+
+RELATIONSHIPS: [how nodes connect]
+STYLE: [style characteristics]
+ASPECT: 16:9
+```
+
+### Timeline
+
+```
+[Title] - Chronological View
+
+DIRECTION: [horizontal/vertical]
+
+EVENTS:
+- [Date/Period 1]: [milestone]
+- [Date/Period 2]: [milestone]
+
+MARKERS: [visual indicators]
+STYLE: [style characteristics]
+ASPECT: 16:9
+```
+
+## What to Avoid
+
+- Vague descriptions ("a nice image")
+- Literal metaphor illustrations
+- Missing concrete labels/annotations
+- Generic decorative elements
+
+## Watermark Integration
+
+If watermark enabled in preferences, append:
+
+```
+Include a subtle watermark "[content]" positioned at [position] with approximately [opacity*100]% visibility.
+```
@@ -0,0 +1,117 @@
+# Style Reference
+
+## Style Gallery
+
+| Style | Description | Best For |
+|-------|-------------|----------|
+| `notion` (Default) | Minimalist hand-drawn line art | Knowledge sharing, SaaS, productivity |
+| `elegant` | Refined, sophisticated | Business, thought leadership |
+| `warm` | Friendly, approachable | Personal growth, lifestyle, education |
+| `minimal` | Ultra-clean, zen-like | Philosophy, minimalism, core concepts |
+| `blueprint` | Technical schematics | Architecture, system design, engineering |
+| `watercolor` | Soft artistic with natural warmth | Lifestyle, travel, creative |
+| `editorial` | Magazine-style infographic | Tech explainers, journalism |
+| `scientific` | Academic precise diagrams | Biology, chemistry, technical research |
+
+Full specifications: `references/styles/<style>.md`
+
+## Type × Style Compatibility Matrix
+
+| | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| infographic | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
+| scene | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ |
+| flowchart | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ |
+| comparison | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
+| framework | ✓✓ | ✓ | ✓✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓✓ |
+| timeline | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
+
+✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## Auto Selection by Type
+
+| Type | Primary Style | Secondary Styles |
+|------|---------------|------------------|
+| infographic | blueprint | notion, editorial, scientific |
+| scene | warm | watercolor, elegant |
+| flowchart | notion | blueprint, editorial |
+| comparison | notion | elegant, editorial |
+| framework | blueprint | notion, scientific |
+| timeline | elegant | warm, editorial |
+
+## Auto Selection by Content Signals
+
+| Content Signals | Recommended Type | Recommended Style |
+|-----------------|------------------|-------------------|
+| API, metrics, data, comparison, numbers | infographic | blueprint, notion |
+| Story, emotion, journey, experience, personal | scene | warm, watercolor |
+| How-to, steps, workflow, process, tutorial | flowchart | notion, minimal |
+| vs, pros/cons, before/after, alternatives | comparison | notion, elegant |
+| Framework, model, architecture, principles | framework | blueprint, notion |
+| History, timeline, progress, evolution | timeline | elegant, warm |
+| Knowledge, concept, productivity, SaaS, tool | infographic | notion |
+| Business, professional, strategy, corporate | framework | elegant |
+| Biology, chemistry, medical, scientific | infographic | scientific |
+| Explainer, journalism, magazine, investigation | infographic | editorial |
+
+## Style Characteristics by Type
+
+### infographic + blueprint
+- Technical precision, schematic lines
+- Grid-based layout, clear zones
+- Monospace labels, data-focused
+- Blue/white color scheme
+
+### infographic + notion
+- Hand-drawn feel, approachable
+- Soft icons, rounded elements
+- Neutral palette, clean backgrounds
+- Perfect for SaaS/productivity
+
+### scene + warm
+- Golden hour lighting, cozy atmosphere
+- Soft gradients, natural textures
+- Inviting, personal feeling
+- Great for storytelling
+
+### scene + watercolor
+- Artistic, painterly effect
+- Soft edges, color bleeding
+- Dreamy, creative mood
+- Best for lifestyle/travel
+
+### flowchart + notion
+- Clear step indicators
+- Simple arrow connections
+- Minimal decoration
+- Focus on process clarity
+
+### flowchart + blueprint
+- Technical precision
+- Detailed connection points
+- Engineering aesthetic
+- For complex systems
+
+### comparison + elegant
+- Refined dividers
+- Balanced typography
+- Professional appearance
+- Business comparisons
+
+### framework + blueprint
+- Precise node connections
+- Hierarchical clarity
+- System architecture feel
+- Technical frameworks
+
+### timeline + elegant
+- Sophisticated markers
+- Refined typography
+- Historical gravitas
+- Professional presentations
+
+### timeline + warm
+- Friendly progression
+- Organic flow
+- Personal journey feel
+- Growth narratives
@@ -0,0 +1,66 @@
+# Usage
+
+## Command Syntax
+
+```bash
+# Auto-select type and style based on content
+/baoyu-article-illustrator path/to/article.md
+
+# Specify type
+/baoyu-article-illustrator path/to/article.md --type infographic
+
+# Specify style
+/baoyu-article-illustrator path/to/article.md --style blueprint
+
+# Combine type and style
+/baoyu-article-illustrator path/to/article.md --type flowchart --style notion
+
+# Specify density
+/baoyu-article-illustrator path/to/article.md --density rich
+
+# Direct content input (paste mode)
+/baoyu-article-illustrator
+[paste content]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--type <name>` | Illustration type (see Type Gallery in SKILL.md) |
+| `--style <name>` | Visual style (see references/styles.md) |
+| `--density <level>` | Image count: minimal / balanced / rich |
+
+## Input Modes
+
+| Mode | Trigger | Output Directory |
+|------|---------|------------------|
+| File path | `path/to/article.md` | Use `default_output_dir` preference, or ask if not set |
+| Paste content | No path argument | `illustrations/{topic-slug}/` |
+
+## Output Directory Options
+
+| Value | Path |
+|-------|------|
+| `same-dir` | `{article-dir}/` |
+| `illustrations-subdir` | `{article-dir}/illustrations/` |
+| `independent` | `illustrations/{topic-slug}/` |
+
+Configure in EXTEND.md: `default_output_dir: illustrations-subdir`
+
+## Examples
+
+**Technical article with data**:
+```bash
+/baoyu-article-illustrator api-design.md --type infographic --style blueprint
+```
+
+**Personal story**:
+```bash
+/baoyu-article-illustrator journey.md --type scene --style warm
+```
+
+**Tutorial with steps**:
+```bash
+/baoyu-article-illustrator how-to-deploy.md --type flowchart --density rich
+```
@@ -1,45 +1,103 @@
 ---
 name: baoyu-comic
-description: Knowledge comic creator supporting multiple styles (Logicomix/Ligne Claire, Ohmsha manga guide). Creates original educational comics with detailed panel layouts and sequential image generation. Use when user asks to create "知识漫画", "教育漫画", "biography comic", "tutorial comic", or "Logicomix-style comic".
+description: Knowledge comic creator supporting multiple art styles and tones. Creates original educational comics with detailed panel layouts and sequential image generation. Use when user asks to create "知识漫画", "教育漫画", "biography comic", "tutorial comic", or "Logicomix-style comic".
 ---

 # Knowledge Comic Creator

-Create original knowledge comics with multiple visual styles.
+Create original knowledge comics with flexible art style × tone combinations.

 ## Usage

 ```bash
 /baoyu-comic posts/turing-story/source.md
+/baoyu-comic article.md --art manga --tone warm
 /baoyu-comic  # then paste content
 ```

 ## Options

-| Option | Values |
-|--------|--------|
-| `--style` | classic (default), dramatic, warm, sepia, vibrant, ohmsha, realistic, wuxia, shoujo, or custom description |
-| `--layout` | standard (default), cinematic, dense, splash, mixed, webtoon |
-| `--aspect` | 3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen) |
-| `--lang` | auto (default), zh, en, ja, etc. |
+### Visual Dimensions

-Style × Layout × Aspect can be freely combined. Custom styles can be described in natural language.
+| Option | Values | Description |
+|--------|--------|-------------|
+| `--art` | ligne-claire (default), manga, realistic, ink-brush, chalk | Art style / rendering technique |
+| `--tone` | neutral (default), warm, dramatic, romantic, energetic, vintage, action | Mood / atmosphere |
+| `--layout` | standard (default), cinematic, dense, splash, mixed, webtoon | Panel arrangement |
+| `--aspect` | 3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen) | Page aspect ratio |
+| `--lang` | auto (default), zh, en, ja, etc. | Output language |

-**Aspect ratio is consistent across all pages in a comic.**
+### Partial Workflow Options
+
+| Option | Description |
+|--------|-------------|
+| `--storyboard-only` | Generate storyboard only, skip prompts and images |
+| `--prompts-only` | Generate storyboard + prompts, skip images |
+| `--images-only` | Generate images from existing prompts directory |
+| `--regenerate N` | Regenerate specific page(s) only (e.g., `3` or `2,5,8`) |
+
+Details: [references/partial-workflows.md](references/partial-workflows.md)
+
+### Art Styles (画风)
+
+| Style | 中文 | Description |
+|-------|------|-------------|
+| `ligne-claire` | 清线 | Uniform lines, flat colors, European comic tradition (Tintin, Logicomix) |
+| `manga` | 日漫 | Large eyes, manga conventions, expressive emotions |
+| `realistic` | 写实 | Digital painting, realistic proportions, sophisticated |
+| `ink-brush` | 水墨 | Chinese brush strokes, ink wash effects |
+| `chalk` | 粉笔 | Chalkboard aesthetic, hand-drawn warmth |
+
+### Tones (基调)
+
+| Tone | 中文 | Description |
+|------|------|-------------|
+| `neutral` | 中性 | Balanced, rational, educational |
+| `warm` | 温馨 | Nostalgic, personal, comforting |
+| `dramatic` | 戏剧 | High contrast, intense, powerful |
+| `romantic` | 浪漫 | Soft, beautiful, decorative elements |
+| `energetic` | 活力 | Bright, dynamic, exciting |
+| `vintage` | 复古 | Historical, aged, period authenticity |
+| `action` | 动作 | Speed lines, impact effects, combat |
+
+### Preset Shortcuts
+
+Presets with special rules beyond art+tone:
+
+| Preset | Equivalent | Special Rules |
+|--------|-----------|---------------|
+| `--style ohmsha` | `--art manga --tone neutral` | Visual metaphors, NO talking heads, gadget reveals |
+| `--style wuxia` | `--art ink-brush --tone action` | Qi effects, combat visuals, atmospheric elements |
+| `--style shoujo` | `--art manga --tone romantic` | Decorative elements, eye details, romantic beats |
+
+### Compatibility Matrix
+
+| Art Style | ✓✓ Best | ✓ Works | ✗ Avoid |
+|-----------|---------|---------|---------|
+| ligne-claire | neutral, warm | dramatic, vintage, energetic | romantic, action |
+| manga | neutral, romantic, energetic, action | warm, dramatic | vintage |
+| realistic | neutral, warm, dramatic, vintage | action | romantic, energetic |
+| ink-brush | neutral, dramatic, action, vintage | warm | romantic, energetic |
+| chalk | neutral, warm, energetic | vintage | dramatic, action, romantic |
+
+Details: [references/auto-selection.md](references/auto-selection.md)

 ## Auto Selection

-| Content Signals | Style | Layout |
-|-----------------|-------|--------|
-| Tutorial, how-to, beginner | ohmsha | webtoon |
-| Computing, AI, programming | ohmsha | dense |
-| Pre-1950, classical, ancient | sepia | cinematic |
-| Personal story, mentor | warm | standard |
-| Conflict, breakthrough | dramatic | splash |
-| Wine, food, business, lifestyle, professional | realistic | cinematic |
-| Martial arts, wuxia, xianxia, Chinese historical | wuxia | splash |
-| Romance, love, school life, friendship, emotional | shoujo | standard |
-| Biography, balanced | classic | mixed |
+Content signals determine default art + tone + layout (or preset):
+
+| Content Signals | Recommended |
+|-----------------|-------------|
+| Tutorial, how-to, programming, educational | **ohmsha** preset |
+| Pre-1950, classical, ancient | realistic + vintage |
+| Personal story, mentor | ligne-claire + warm |
+| Martial arts, wuxia | **wuxia** preset |
+| Romance, school life | **shoujo** preset |
+| Biography, balanced | ligne-claire + neutral |
+
+**When preset is recommended**: Load `references/presets/{preset}.md` and apply all special rules.
+
+Details: [references/auto-selection.md](references/auto-selection.md)

 ## Script Directory

@@ -57,354 +115,192 @@ Style × Layout × Aspect can be freely combined. Custom styles can be described

 ## File Structure

-Each session creates an independent directory named by content slug:
+Output directory: `comic/{topic-slug}/`
+- Slug: 2-4 words kebab-case from topic (e.g., `alan-turing-bio`)
+- Conflict: append timestamp (e.g., `turing-story-20260118-143052`)

-```
-comic/{topic-slug}/
-├── source-{slug}.{ext}            # Source files (text, images, etc.)
-├── analysis.md                    # Deep analysis results (YAML+MD)
-├── storyboard-chronological.md    # Variant A (preserved)
-├── storyboard-thematic.md         # Variant B (preserved)
-├── storyboard-character.md        # Variant C (preserved)
-├── characters-chronological/      # Variant A chars (preserved)
-│   ├── characters.md
-│   └── characters.png
-├── characters-thematic/           # Variant B chars (preserved)
-│   ├── characters.md
-│   └── characters.png
-├── characters-character/          # Variant C chars (preserved)
-│   ├── characters.md
-│   └── characters.png
-├── storyboard.md                  # Final selected
-├── characters/                    # Final selected
-│   ├── characters.md
-│   └── characters.png
-├── prompts/
-│   ├── 00-cover-[slug].md
-│   └── NN-page-[slug].md
-├── 00-cover-[slug].png
-├── NN-page-[slug].png
-└── {topic-slug}.pdf
-```
+**Contents**:
+| File | Description |
+|------|-------------|
+| `source-{slug}.{ext}` | Source files |
+| `analysis.md` | Content analysis |
+| `storyboard.md` | Storyboard with panel breakdown |
+| `characters/characters.md` | Character definitions |
+| `characters/characters.png` | Character reference sheet |
+| `prompts/NN-{cover\|page}-[slug].md` | Generation prompts |
+| `NN-{cover\|page}-[slug].png` | Generated images |
+| `{topic-slug}.pdf` | Final merged PDF |

-**Slug Generation**:
-1. Extract main topic from content (2-4 words, kebab-case)
-2. Example: "Alan Turing Biography" → `alan-turing-bio`
+## Language Handling

-**Conflict Resolution**:
-If `comic/{topic-slug}/` already exists:
- Append timestamp: `{topic-slug}-YYYYMMDD-HHMMSS`
- Example: `turing-story` exists → `turing-story-20260118-143052`
+**Detection Priority**:
+1. `--lang` flag (explicit)
+2. EXTEND.md `language` setting
+3. User's conversation language
+4. Source content language

-**Source Files**:
-Copy all sources with naming `source-{slug}.{ext}`:
- `source-biography.md`, `source-portrait.jpg`, `source-timeline.png`, etc.
- Multiple sources supported: text, images, files from conversation
+**Rule**: Use user's input language or saved language preference for ALL interactions:
+- Storyboard outlines and scene descriptions
+- Image generation prompts
+- User selection options and confirmations
+- Progress updates, questions, errors, summaries
+
+Technical terms remain in English.

 ## Workflow

-### Step 1: Analyze Content → `analysis.md`
-
-Read source content, save it if needed, and perform deep analysis.
-
-**Actions**:
-1. **Save source content** (if not already a file):
-   - If user provides a file path: use as-is
-   - If user pastes content: save to `source.md` in target directory
-2. Read source content
-3. **Deep analysis** following `references/analysis-framework.md`:
-   - Target audience identification
-   - Value proposition for readers
-   - Core themes and narrative potential
-   - Key figures and their story arcs
-4. Detect source language
-5. Determine recommended page count:
-   - Short story: 5-8 pages
-   - Medium complexity: 9-15 pages
-   - Full biography: 16-25 pages
-6. Analyze content signals for style/layout recommendations
-7. **Save to `analysis.md`**
-
-**analysis.md Format**:
-
-```yaml
---
-title: "Alan Turing: Father of Computing"
-topic: Biography
-time_span: 1912-1954
-source_language: en
-user_language: zh
-aspect_ratio: "3:4"
-recommended_page_count: 12
---
-
-## Target Audience
-
- **Primary**: Tech enthusiasts curious about computing history
- **Secondary**: Students learning about scientific breakthroughs
- **Tertiary**: General readers interested in biographical stories
-
-## Value Proposition
-
-What readers will gain:
-1. Understanding of how modern computing was born
-2. Emotional connection to a brilliant but tragic figure
-3. Appreciation for the human cost of innovation
-
-## Core Themes
-
-| Theme | Narrative Potential | Visual Opportunity |
-|-------|--------------------|--------------------|
-| Genius vs. Society | High conflict, dramatic arcs | Contrast scenes |
-| Code-breaking | Mystery, tension | Technical diagrams as art |
-| Personal tragedy | Emotional depth | Intimate, somber panels |
-
-## Key Figures & Story Arcs
-
-### Alan Turing (Protagonist)
- **Arc**: Misunderstood genius → War hero → Tragic end
- **Visual identity**: Disheveled academic, intense eyes
- **Key moments**: Enigma breakthrough, arrest, final days
-
-### Christopher Morcom (Catalyst)
- **Role**: Early friend whose death shaped Turing
- **Visual identity**: Youthful, bright
- **Key moments**: School friendship, sudden death
-
-## Content Signals
-
- "biography" → classic + mixed
- "computing history" → ohmsha + dense
- "personal tragedy" → dramatic + splash
-
-## Recommended Approaches
-
-1. **Chronological** - follow life timeline (recommended for biography)
-2. **Thematic** - organize by contributions (good for educational focus)
-3. **Character-focused** - relationships drive narrative (good for emotional impact)
-```
-
-### Step 2: Generate 3 Storyboard Variants
-
-Create three distinct variants, each combining a narrative approach with a recommended style.
-
-| Variant | Narrative Approach | Recommended Style | Layout |
-|---------|-------------------|-------------------|--------|
-| A | Chronological | sepia | cinematic |
-| B | Thematic | ohmsha | dense |
-| C | Character-focused | warm | standard |
-
-**For each variant**:
-
-1. **Generate storyboard** (`storyboard-{approach}.md`):
-   - YAML front matter with narrative_approach, recommended_style, recommended_layout, aspect_ratio
-   - Cover design
-   - Each page: layout, panel breakdown, visual prompts
-   - **Written in user's preferred language**
-   - Reference: `references/storyboard-template.md`
-
-2. **Generate matching characters** (`characters-{approach}/`):
-   - `characters.md` - visual specs matching the recommended style (in user's preferred language)
-   - `characters.png` - character reference sheet
-   - Reference: `references/character-template.md`
-
-**All variants are preserved after selection for reference.**
-
-### Step 3: User Confirms All Options
-
-**IMPORTANT**: Present ALL options in a single confirmation step using AskUserQuestion. Do NOT interrupt workflow with multiple separate confirmations.
-
-**Determine which questions to ask**:
-
-| Question | When to Ask |
-|----------|-------------|
-| Storyboard variant | Always (required) |
-| Visual style | Always (required) |
-| Language | Only if `source_language ≠ user_language` |
-| Aspect ratio | Only if user might prefer non-default (e.g., landscape content) |
-
-**Language handling**:
- If source language = user language: Just inform user (e.g., "Comic will be in Chinese")
- If different: Ask which language to use
-
-**All storyboards and prompts are generated in the user's selected/preferred language.**
-
-**Aspect ratio handling**:
- Default: 3:4 (portrait) - standard comic format
- Offer 4:3 (landscape) if content suits it (e.g., panoramic scenes, technical diagrams)
- Offer 16:9 (widescreen) for cinematic content
-
-**AskUserQuestion format** (example with all questions):
+### Progress Checklist

 ```
-Question 1 (Storyboard): Which storyboard variant?
- A: Chronological + sepia (Recommended)
- B: Thematic + ohmsha
- C: Character-focused + warm
- Custom
-
-Question 2 (Style): Which visual style?
- sepia (Recommended from variant)
- classic / dramatic / warm / sepia / vibrant / ohmsha / realistic / wuxia
- Custom description
-
-Question 3 (Language) - only if mismatch:
- Chinese (source material language)
- English (your preference)
-
-Question 4 (Aspect) - only if relevant:
- 3:4 Portrait (Recommended)
- 4:3 Landscape
- 16:9 Widescreen
+Comic Progress:
+- [ ] Step 1: Setup & Analyze
+  - [ ] 1.1 Preferences (EXTEND.md) ⛔ BLOCKING
+    - [ ] Found → load preferences → continue
+    - [ ] Not found → run first-time setup → MUST complete before other steps
+  - [ ] 1.2 Analyze, 1.3 Check existing
+- [ ] Step 2: Confirmation - Style & options ⚠️ REQUIRED
+- [ ] Step 3: Generate storyboard + characters
+- [ ] Step 4: Review outline (conditional)
+- [ ] Step 5: Generate prompts
+- [ ] Step 6: Review prompts (conditional)
+- [ ] Step 7: Generate images ⚠️ CHARACTER REF REQUIRED
+  - [ ] 7.1 Generate character sheet FIRST → characters/characters.png
+  - [ ] 7.2 Generate pages WITH --ref characters/characters.png
+- [ ] Step 8: Merge to PDF
+- [ ] Step 9: Completion report
 ```

-**After confirmation**:
-1. Copy selected storyboard → `storyboard.md`
-2. Copy selected characters → `characters/`
-3. Update YAML front matter with confirmed style, language, aspect_ratio
-4. If style differs from variant's recommended: regenerate `characters/characters.png`
-5. User may edit files directly for fine-tuning
+### Flow

-### Step 4: Generate Images
+```
+Input → [Preferences] ─┬─ Found → Continue
+                       │
+                       └─ Not found → First-Time Setup ⛔ BLOCKING
+                                      │
+                                      └─ Complete setup → Save EXTEND.md → Continue
+                                                                              │
+        ┌─────────────────────────────────────────────────────────────────────┘
+        ↓
+Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → PDF → Complete
+```

-With confirmed storyboard + style + aspect ratio:
+### Step Summary

-**For each page (cover + pages)**:
-1. Save prompt to `prompts/NN-{cover|page}-[slug].md` (in user's preferred language)
-2. Generate image using confirmed style and aspect ratio
-3. Report progress after each generation
+| Step | Action | Key Output |
+|------|--------|------------|
+| 1.1 | Load EXTEND.md preferences ⛔ BLOCKING if not found | Config loaded |
+| 1.2 | Analyze content | `analysis.md` |
+| 1.3 | Check existing directory | Handle conflicts |
+| 2 | Confirm style, focus, audience, reviews | User preferences |
+| 3 | Generate storyboard + characters | `storyboard.md`, `characters/` |
+| 4 | Review outline (if requested) | User approval |
+| 5 | Generate prompts | `prompts/*.md` |
+| 6 | Review prompts (if requested) | User approval |
+| **7.1** | **Generate character sheet FIRST** | `characters/characters.png` |
+| **7.2** | Generate pages **with character ref** | `*.png` files |
+| 8 | Merge to PDF | `{slug}.pdf` |
+| 9 | Completion report | Summary |

-**Image Generation Skill Selection**:
- Check available image generation skills
- If multiple skills available, ask user preference
+### Step 7: Image Generation ⚠️ CRITICAL

-**Character Reference Handling**:
- If skill supports reference image: pass `characters/characters.png`
- If skill does NOT support reference image: include `characters/characters.md` content in prompt
+**Character reference is MANDATORY for visual consistency.**

-**Session Management**:
-If image generation skill supports `--sessionId`:
-1. Generate unique session ID: `comic-{topic-slug}-{timestamp}`
-2. Use same session ID for all pages
-3. Ensures visual consistency across generated images
+**7.1 Generate character sheet first**:
+- **Backup rule**: If `characters/characters.png` exists, rename to `characters/characters-backup-YYYYMMDD-HHMMSS.png`
+```bash
+# Use Reference Sheet Prompt from characters/characters.md
+npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
+  --promptfiles characters/characters.md \
+  --image characters/characters.png --ar 4:3
+```

-### Step 5: Merge to PDF
+**Compress character sheet** (recommended):
+Compress to reduce token usage when used as reference image:
+- Use available image compression skill (if any)
+- Or system tools: `pngquant`, `optipng`, `sips` (macOS)
+- **Keep PNG format**, lossless compression preferred

-After all images generated:
+**7.2 Generate each page WITH character reference**:
+
+| Skill Capability | Strategy |
+|------------------|----------|
+| Supports `--ref` | Pass `characters/characters.png` with EVERY page |
+| No `--ref` support | Prepend character descriptions to EVERY prompt file |
+
+**Backup rules for page generation**:
+- If prompt file exists: rename to `prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`
+- If image file exists: rename to `NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`

 ```bash
-npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts <comic-dir>
+# Example: ALWAYS include --ref for consistency
+npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
+  --promptfiles prompts/01-page-xxx.md \
+  --image 01-page-xxx.png --ar 3:4 \
+  --ref characters/characters.png
 ```

-Creates `{topic-slug}.pdf` with all pages as full-page images.
+**Full workflow details**: [references/workflow.md](references/workflow.md)

-### Step 6: Completion Report
+### EXTEND.md Paths ⛔ BLOCKING

-```
-Comic Complete!
-Title: [title] | Style: [style] | Pages: [count] | Aspect: [ratio] | Language: [lang]
-Location: [path]
-✓ analysis.md
-✓ characters.png
-✓ 00-cover-[slug].png ... NN-page-[slug].png
-✓ {topic-slug}.pdf
-```
+**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to content analysis, do NOT ask about art style, do NOT ask about tone — ONLY complete the preferences setup first.

-## Page Modification
+| Path | Location |
+|------|----------|
+| `.baoyu-skills/baoyu-comic/EXTEND.md` | Project directory |
+| `$HOME/.baoyu-skills/baoyu-comic/EXTEND.md` | User home |

-Support for modifying individual pages after initial generation.
+| Result | Action |
+|--------|--------|
+| Found | Read, parse, display summary → Continue |
+| Not found | ⛔ **BLOCKING**: Run first-time setup ONLY ([references/config/first-time-setup.md](references/config/first-time-setup.md)) → Complete and save EXTEND.md → Then continue |

-### Edit Single Page
+**EXTEND.md Supports**: Watermark | Preferred art/tone/layout | Custom style definitions | Character presets | Language preference

-Regenerate a specific page with modified prompt:
-
-1. Identify page to edit (e.g., `03-page-enigma-machine.png`)
-2. Update prompt in `prompts/03-page-enigma-machine.md` if needed
-3. If content changes significantly, update slug in filename
-4. Regenerate image using same session ID and aspect ratio
-5. Regenerate PDF
-
-### Add New Page
-
-Insert a new page at specified position:
-
-1. Specify insertion position (e.g., after page 3)
-2. Create new prompt with appropriate slug (e.g., `04-page-bletchley-park.md`)
-3. Generate new page image (same aspect ratio)
-4. **Renumber files**: All subsequent pages increment NN by 1
-   - `04-page-tragedy.png` → `05-page-tragedy.png`
-   - Slugs remain unchanged
-5. Update `storyboard.md` with new page entry
-6. Regenerate PDF
-
-### Delete Page
-
-Remove a page and renumber:
-
-1. Identify page to delete (e.g., `03-page-enigma-machine.png`)
-2. Remove image file and prompt file
-3. **Renumber files**: All subsequent pages decrement NN by 1
-   - `04-page-tragedy.png` → `03-page-tragedy.png`
-   - Slugs remain unchanged
-4. Update `storyboard.md` to remove page entry
-5. Regenerate PDF
-
-### File Naming Convention
-
-Files use meaningful slugs for better readability:
-```
-NN-cover-[slug].png / NN-page-[slug].png
-NN-cover-[slug].md / NN-page-[slug].md (in prompts/)
-```
-
-Examples:
- `00-cover-turing-story.png`
- `01-page-early-life.png`
- `02-page-cambridge-years.png`
- `03-page-enigma-machine.png`
-
-**Slug rules**:
- Derived from page title/content (kebab-case)
- Must be unique within the comic
- When page content changes significantly, update slug accordingly
-
-**Renumbering**:
- After add/delete, update NN prefix for affected pages
- Slug remains unchanged unless content changes
- Maintain sequential numbering with no gaps
-
-## Style-Specific Guidelines
-
-### Ohmsha Style (`--style ohmsha`)
-
-Additional requirements for educational manga:
- **Default: Use Doraemon characters directly** - No need to create new characters
-  - 大雄 (Nobita): Student role, curious learner
-  - 哆啦A梦 (Doraemon): Mentor role, explains concepts with gadgets
-  - 胖虎 (Gian): Antagonist/challenge role, represents obstacles or misconceptions
-  - 静香 (Shizuka): Supporting role, asks clarifying questions
- Custom characters only if explicitly requested: `--characters "Student:小明,Mentor:教授"`
- Must use visual metaphors (gadgets, action scenes) - NO talking heads
- Page titles: narrative style, not "Page X: Topic"
-
-**Reference**: `references/ohmsha-guide.md` for detailed guidelines.
+Schema: [references/config/preferences-schema.md](references/config/preferences-schema.md)

 ## References

-Detailed templates and guidelines in `references/` directory:
- `analysis-framework.md` - Deep content analysis for comic adaptation
- `character-template.md` - Character definition format and examples
- `storyboard-template.md` - Storyboard structure and panel breakdown
- `ohmsha-guide.md` - Ohmsha manga style specifics
- `styles/` - Detailed style definitions
- `layouts/` - Detailed layout definitions
+**Core Templates**:
+- [analysis-framework.md](references/analysis-framework.md) - Deep content analysis
+- [character-template.md](references/character-template.md) - Character definition format
+- [storyboard-template.md](references/storyboard-template.md) - Storyboard structure
+- [ohmsha-guide.md](references/ohmsha-guide.md) - Ohmsha manga specifics

-## Extension Support
+**Style Definitions**:
+- `references/art-styles/` - Art styles (ligne-claire, manga, realistic, ink-brush, chalk)
+- `references/tones/` - Tones (neutral, warm, dramatic, romantic, energetic, vintage, action)
+- `references/presets/` - Presets with special rules (ohmsha, wuxia, shoujo)
+- `references/layouts/` - Layouts (standard, cinematic, dense, splash, mixed, webtoon)

-Custom styles and configurations via EXTEND.md.
+**Workflow**:
+- [workflow.md](references/workflow.md) - Full workflow details
+- [auto-selection.md](references/auto-selection.md) - Content signal analysis
+- [partial-workflows.md](references/partial-workflows.md) - Partial workflow options

-**Check paths** (priority order):
-1. `.baoyu-skills/baoyu-comic/EXTEND.md` (project)
-2. `~/.baoyu-skills/baoyu-comic/EXTEND.md` (user)
+**Config**:
+- [config/preferences-schema.md](references/config/preferences-schema.md) - EXTEND.md schema
+- [config/first-time-setup.md](references/config/first-time-setup.md) - First-time setup
+- [config/watermark-guide.md](references/config/watermark-guide.md) - Watermark configuration

-If found, load before Step 1. Extension content overrides defaults.
+## Page Modification
+
+| Action | Steps |
+|--------|-------|
+| **Edit** | **Update prompt file FIRST** → `--regenerate N` → Regenerate PDF |
+| **Add** | Create prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDF |
+| **Delete** | Remove files → Renumber subsequent → Update storyboard → Regenerate PDF |
+
+**IMPORTANT**: When updating pages, ALWAYS update the prompt file (`prompts/NN-{cover|page}-[slug].md`) FIRST before regenerating. This ensures changes are documented and reproducible.
+
+## Notes
+
+- Image generation: 10-30 seconds per page
+- Auto-retry once on generation failure
+- Use stylized alternatives for sensitive public figures
+- Maintain style consistency via session ID
+- **Step 2 confirmation required** - do not skip
+- **Steps 4/6 conditional** - only if user requested in Step 2
+- **Step 7.1 character sheet MUST be generated before pages** - ensures consistency
+- **Step 7.2 EVERY page MUST reference characters** - use `--ref` or embed descriptions
+- Watermark/language configured once in EXTEND.md
@@ -131,7 +131,7 @@ Before creating a comic, thoroughly analyze the source material to:

 Analysis results should be saved to `analysis.md` with:

-1. **YAML Front Matter**: Metadata (title, topic, time_span, languages, aspect_ratio, page_count)
+1. **YAML Front Matter**: Metadata (title, topic, time_span, source_language, user_language, aspect_ratio, recommended_page_count, recommended_art, recommended_tone, recommended_layout)
 2. **Target Audience**: Primary, secondary, tertiary audiences with their needs
 3. **Value Proposition**: What readers will gain (knowledge, emotional, practical)
 4. **Core Themes**: Table with theme, narrative potential, visual opportunity
@@ -139,6 +139,30 @@ Analysis results should be saved to `analysis.md` with:
 6. **Content Signals**: Style and layout recommendations based on content type
 7. **Recommended Approaches**: Narrative approaches ranked by suitability

+### YAML Front Matter Example
+
+```yaml
+---
+title: "Alan Turing: The Father of Computing"
+topic: alan-turing-biography
+time_span: 1912-1954
+source_language: en
+user_language: zh  # From EXTEND.md or detected
+aspect_ratio: "3:4"
+recommended_page_count: 16
+recommended_art: ligne-claire  # ligne-claire|manga|realistic|ink-brush|chalk
+recommended_tone: neutral      # neutral|warm|dramatic|romantic|energetic|vintage|action
+recommended_layout: mixed      # standard|cinematic|dense|splash|mixed|webtoon
+---
+```
+
+### Language Fields
+
+| Field | Description |
+|-------|-------------|
+| `source_language` | Detected language of source content |
+| `user_language` | Output language for comic (from EXTEND.md > --lang > source_language) |
+
 ## Analysis Checklist

 Before proceeding to storyboard:
@@ -0,0 +1,101 @@
+# chalk
+
+粉笔画风 - Chalkboard aesthetic with hand-drawn warmth
+
+## Overview
+
+Classic classroom chalkboard aesthetic with hand-drawn chalk illustrations. Nostalgic educational feel with imperfect, sketchy lines that capture the warmth of traditional teaching.
+
+## Line Work
+
+- Sketchy, imperfect hand-drawn lines
+- Chalk texture on all strokes
+- Varying line weight from chalk pressure
+- Soft edges, no sharp digital lines
+- Visible chalk dust effects
+
+## Character Design
+
+- Simplified, friendly character designs
+- Stick figures to semi-detailed range
+- Expressive through simple gestures
+- Approachable, non-intimidating
+- Educational presenter style
+
+## Background
+
+- Chalkboard Black (#1A1A1A) or Dark Green-Black (#1C2B1C)
+- Realistic chalkboard texture
+- Subtle scratches and dust particles
+- Faint eraser marks for authenticity
+- Wooden frame border optional
+
+## Typography
+
+- Hand-drawn chalk lettering style
+- Visible chalk texture on text
+- Imperfect baseline adds authenticity
+- White or bright colored chalk for emphasis
+
+## Visual Elements
+
+- Hand-drawn chalk illustrations
+- Chalk dust effects around elements
+- Doodles: stars, arrows, underlines, circles
+- Mathematical formulas and diagrams
+- Eraser smudges and chalk residue
+- Stick figures and simple icons
+- Connection lines with hand-drawn feel
+
+## Default Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Background | Chalkboard Black | #1A1A1A |
+| Alt Background | Green-Black | #1C2B1C |
+| Primary Text | Chalk White | #F5F5F5 |
+| Accent 1 | Chalk Yellow | #FFE566 |
+| Accent 2 | Chalk Pink | #FF9999 |
+| Accent 3 | Chalk Blue | #66B3FF |
+| Accent 4 | Chalk Green | #90EE90 |
+| Accent 5 | Chalk Orange | #FFB366 |
+
+## Style Rules
+
+### Do
+- Maintain authentic chalk texture on all elements
+- Use imperfect, hand-drawn quality throughout
+- Add subtle chalk dust and smudge effects
+- Create visual hierarchy with color variety
+- Include playful doodles and annotations
+
+### Don't
+- Use perfect geometric shapes
+- Create clean digital-looking lines
+- Add photorealistic elements
+- Use gradients or glossy effects
+
+## Quality Markers
+
+- ✓ Authentic chalk texture throughout
+- ✓ Imperfect, hand-drawn quality
+- ✓ Readable despite sketchy style
+- ✓ Nostalgic classroom feel
+- ✓ Effective color hierarchy
+- ✓ Playful educational aesthetic
+
+## Compatibility
+
+| Tone | Fit | Notes |
+|------|-----|-------|
+| neutral | ✓✓ | Classic educational |
+| warm | ✓✓ | Nostalgic feel |
+| dramatic | ✗ | Style mismatch |
+| vintage | ✓ | Old school feel |
+| romantic | ✗ | Style mismatch |
+| energetic | ✓✓ | Fun learning |
+| action | ✗ | Style mismatch |
+
+## Best For
+
+Educational content, tutorials, classroom themes, teaching materials, workshops, informal learning, knowledge sharing
@@ -0,0 +1,97 @@
+# ink-brush
+
+水墨画风 - Chinese ink brush aesthetics with dynamic strokes
+
+## Overview
+
+Traditional Chinese ink brush painting style adapted for comics. Combines calligraphic brush strokes with ink wash effects. Creates atmospheric, artistic visuals rooted in East Asian aesthetics.
+
+## Line Work
+
+- 2-3px dynamic brush strokes with varying weight
+- Ink wash effects, traditional Chinese brush feel
+- Bold, confident strokes with sharp edges
+- Flowing lines for fabric and hair
+- Pressure-sensitive stroke variation
+
+## Character Design
+
+- Realistic human proportions (7.5-8 head heights)
+- Defined features with ink brush definition
+- Dynamic poses capturing movement
+- Flowing hair and clothing in motion
+- Traditional attire options (robes, hanfu)
+- Intense, expressive faces
+
+## Brush Techniques
+
+| Technique | Usage |
+|-----------|-------|
+| Bold strokes | Character outlines |
+| Fine lines | Details, hair |
+| Ink wash | Atmosphere, shadows |
+| Dry brush | Texture, aging |
+| Splatter | Impact, drama |
+
+## Background Treatment
+
+- Dramatic landscapes: mountains, waterfalls, temples
+- Ink wash atmospheric effects
+- Misty, layered depth
+- Traditional architecture elements
+- High contrast silhouettes
+- Negative space as design element
+
+## Color Approach
+
+- Ink gradients as primary
+- Limited accent colors
+- Traditional Chinese palette
+- Atmospheric color washes
+- High contrast compositions
+
+## Default Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary | Deep black ink | #1A1A1A |
+| Accent | Crimson red | #8B0000 |
+| Accent | Imperial gold | #D4AF37 |
+| Skin | Natural tan | #D4A574 |
+| Background | Misty gray | #9CA3AF |
+| Background | Earth tone | #8B7355 |
+| Wash | Ink gradient | #2D3748 |
+
+## Visual Elements
+
+- Calligraphic text integration
+- Seal stamps (optional)
+- Ink splatter effects
+- Flowing fabric trails
+- Atmospheric mist
+- Mountain silhouettes
+
+## Quality Markers
+
+- ✓ Dynamic brush stroke quality
+- ✓ Authentic ink wash atmosphere
+- ✓ High contrast compositions
+- ✓ Flowing movement in fabric/hair
+- ✓ Traditional aesthetic elements
+- ✓ Atmospheric depth
+
+## Compatibility
+
+| Tone | Fit | Notes |
+|------|-----|-------|
+| neutral | ✓ | Contemplative stories |
+| warm | ✓ | Nostalgic, gentle |
+| dramatic | ✓✓ | High contrast |
+| vintage | ✓✓ | Historical pieces |
+| romantic | ✗ | Style mismatch |
+| energetic | ✗ | Too refined |
+| action | ✓✓ | Martial arts |
+
+## Best For
+
+Chinese historical stories, martial arts, traditional tales, contemplative narratives, artistic adaptations
@@ -0,0 +1,75 @@
+# ligne-claire
+
+清线画风 - Uniform lines, flat colors, European comic tradition
+
+## Overview
+
+Classic European comic style originating from Hergé's Tintin. Characterized by clean, uniform outlines and flat color fills without gradients. Creates a timeless, accessible aesthetic suitable for educational and narrative content.
+
+## Line Work
+
+- Uniform, clean outlines with consistent weight (2px)
+- No hatching or cross-hatching for shading
+- Sharp, precise edges on all elements
+- Black ink outlines on all figures and objects
+- Shadows indicated through flat color areas, not line techniques
+
+## Character Design
+
+- Slightly stylized/cartoonish characters with realistic proportions
+- Distinctive, recognizable facial features
+- Expressive faces with clear emotions
+- Period-appropriate clothing with attention to detail
+- Consistent character appearance across panels
+- 6-7 head height proportions
+
+## Background Treatment
+
+- Detailed, realistic backgrounds with architectural accuracy
+- Period-specific props and technology
+- Clear spatial depth and perspective
+- Environmental storytelling through details
+- Contrast between simplified characters and detailed backgrounds
+
+## Color Approach
+
+- Flat colors without gradients (true to Ligne Claire tradition)
+- Limited palette per page for cohesion
+- Colors support narrative mood
+- Consistent lighting logic within scenes
+
+## Default Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary Blue | Clean blue | #3182CE |
+| Primary Red | Classic red | #E53E3E |
+| Primary Yellow | Warm yellow | #ECC94B |
+| Skin | Warm tan | #F7CFAE |
+| Background Light | Light cream | #FFFAF0 |
+| Background Sky | Sky blue | #BEE3F8 |
+
+## Quality Markers
+
+- ✓ Clean, uniform line weight throughout
+- ✓ Flat colors without gradients
+- ✓ Detailed backgrounds, stylized characters
+- ✓ Clear panel borders and reading flow
+- ✓ Hand-drawn text style
+- ✓ Proper perspective in environments
+
+## Compatibility
+
+| Tone | Fit | Notes |
+|------|-----|-------|
+| neutral | ✓✓ | Classic combination |
+| warm | ✓✓ | Nostalgic stories |
+| dramatic | ✓ | Works with high contrast |
+| vintage | ✓ | Period pieces |
+| romantic | ✗ | Style mismatch |
+| energetic | ✓ | Lighter stories |
+| action | ✗ | Lacks dynamic lines |
+
+## Best For
+
+Educational content, balanced narratives, biography comics, historical stories
@@ -0,0 +1,93 @@
+# manga
+
+日漫画风 - Anime/manga aesthetics with expressive characters
+
+## Overview
+
+Japanese manga art style characterized by large expressive eyes, dynamic poses, and visual emotion indicators. Versatile style that works across genres from educational to romantic to action.
+
+## Line Work
+
+- Clean, smooth lines (1.5-2px)
+- Expressive weight variation for emphasis
+- Smooth curves, dynamic strokes
+- Speed lines and motion effects available
+- Screen tone effects for atmosphere
+
+## Character Design
+
+- Anime/manga proportions: larger eyes, expressive faces
+- 5-7 head height proportions (varies by sub-style)
+- Clear emotional indicators (！, ？, sweat drops, sparkles)
+- Dynamic poses and gestures
+- Detailed hair with individual strands
+- Fashionable clothing with natural folds
+
+## Eye Styles
+
+| Type | Description |
+|------|-------------|
+| Standard | Medium-large, 2-3 highlights |
+| Educational | Friendly, approachable eyes |
+| Dramatic | Intense, detailed irises |
+| Cute | Very large, sparkly eyes |
+
+## Background Treatment
+
+- Simplified during dialogue/explanation
+- Detailed for establishing shots
+- Screen tone gradients for mood
+- Abstract backgrounds for emotional moments
+- Technical diagrams styled as displays
+
+## Color Approach
+
+- Clean, bright anime colors
+- Soft gradients on skin
+- Vibrant palette options
+- Light and shadow with soft transitions
+- Color coding for character identification
+
+## Default Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary Blue | Bright blue | #4299E1 |
+| Primary Orange | Warm orange | #ED8936 |
+| Primary Green | Soft green | #68D391 |
+| Skin | Anime warm | #FEEBC8 |
+| Background | Clean white | #FFFFFF |
+| Highlight | Golden | #FFD700 |
+
+## Visual Elements
+
+- Speech bubbles: rounded (normal), spiky (excitement)
+- Sound effects integrated visually
+- Emotion symbols (sweat drops, anger marks, hearts)
+- Speed lines and motion blur
+- Sparkle and glow effects
+
+## Quality Markers
+
+- ✓ Expressive character faces
+- ✓ Clean, consistent line work
+- ✓ Dynamic poses and compositions
+- ✓ Appropriate use of manga conventions
+- ✓ Readable panel flow
+- ✓ Consistent character designs
+
+## Compatibility
+
+| Tone | Fit | Notes |
+|------|-----|-------|
+| neutral | ✓✓ | Educational manga |
+| warm | ✓ | Slice of life |
+| dramatic | ✓ | Intense moments |
+| romantic | ✓✓ | Shoujo style |
+| energetic | ✓✓ | Shonen style |
+| vintage | ✗ | Style mismatch |
+| action | ✓✓ | Battle manga |
+
+## Best For
+
+Educational tutorials, romance, action, coming-of-age, technical explanations, youth-oriented content
@@ -0,0 +1,89 @@
+# realistic
+
+写实画风 - Digital painting with realistic proportions and lighting
+
+## Overview
+
+Full-color realistic manga style using digital painting techniques. Features anatomically accurate characters, rich gradients, and detailed environmental rendering. Sophisticated aesthetic for mature audiences.
+
+## Line Work
+
+- Clean, precise outlines with clear contours
+- Uniform line weight for character definition
+- No excessive hatching - rely on color for depth
+- Smooth curves and realistic anatomical lines
+- Ligne Claire influence: clean but not simplified
+
+## Character Design
+
+- Realistic human proportions (7-8 head heights)
+- Anatomically accurate features and expressions
+- Detailed facial structure without exaggeration
+- Natural poses and body language
+- Consistent appearance across panels
+- Subtle expressions rather than manga-style
+
+## Rendering Style
+
+- Full-color digital painting with rich gradients
+- Soft shadow transitions on skin and fabric
+- Realistic material textures (glass, liquid, fabric, wood)
+- Detailed hair with natural shine and volume
+- Environmental lighting affects all elements
+- NOT flat cel-shading - smooth color blending
+
+## Background Treatment
+
+- Highly detailed, realistic environments
+- Accurate perspective and spatial depth
+- Atmospheric lighting (warm indoor, cool outdoor)
+- Professional settings rendered with precision
+- Props and objects with realistic textures
+
+## Color Approach
+
+- Rich gradients for depth and volume
+- Realistic lighting with warm/cool contrast
+- Material-specific rendering
+- Subtle color temperature shifts
+- Professional, sophisticated palette
+
+## Default Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Skin Light | Natural warm | #F5D6C6 |
+| Skin Shadow | Warm shadow | #E8C4B0 |
+| Environment | Warm wood | #8B7355 |
+| Environment Cool | Cool stone | #9CA3AF |
+| Accent | Wine red | #722F37 |
+| Accent Gold | Gold | #D4AF37 |
+| Light Warm | Amber | #FFB347 |
+| Light Cool | Cool blue | #B0C4DE |
+
+## Quality Markers
+
+- ✓ Anatomically accurate proportions
+- ✓ Smooth color gradients (not flat fills)
+- ✓ Realistic material textures
+- ✓ Detailed, atmospheric backgrounds
+- ✓ Natural lighting with soft shadows
+- ✓ Expressive but subtle expressions
+- ✓ Professional aesthetic
+- ✓ Clean speech bubbles
+
+## Compatibility
+
+| Tone | Fit | Notes |
+|------|-----|-------|
+| neutral | ✓✓ | Professional content |
+| warm | ✓✓ | Nostalgic stories |
+| dramatic | ✓✓ | High drama |
+| vintage | ✓✓ | Period pieces |
+| romantic | ✗ | Style mismatch |
+| energetic | ✗ | Too refined |
+| action | ✓ | Serious action |
+
+## Best For
+
+Professional topics (wine, food, business), lifestyle content, adult narratives, documentary-style, mature educational guides
@@ -0,0 +1,58 @@
+# Auto Selection
+
+Content signals determine default art + tone + layout (or preset).
+
+## Content Signal Matrix
+
+| Content Signals | Art Style | Tone | Layout | Preset |
+|-----------------|-----------|------|--------|--------|
+| Tutorial, how-to, beginner | manga | neutral | webtoon | **ohmsha** |
+| Computing, AI, programming | manga | neutral | dense | **ohmsha** |
+| Technical explanation, educational | manga | neutral | webtoon | **ohmsha** |
+| Pre-1950, classical, ancient | realistic | vintage | cinematic | - |
+| Personal story, mentor | ligne-claire | warm | standard | - |
+| Conflict, breakthrough | (inherit) | dramatic | splash | - |
+| Wine, food, business, lifestyle | realistic | neutral | cinematic | - |
+| Martial arts, wuxia, xianxia | ink-brush | action | splash | **wuxia** |
+| Romance, love, school life | manga | romantic | standard | **shoujo** |
+| Biography, balanced | ligne-claire | neutral | mixed | - |
+
+## Preset Recommendation Rules
+
+**When preset is recommended**: Load `presets/{preset}.md` and apply all special rules.
+
+### ohmsha
+- **Triggers**: Tutorial, technical, educational, computing, programming, how-to, beginner
+- **Special rules**: Visual metaphors, NO talking heads, gadget reveals, Doraemon-style characters
+- **Base**: manga + neutral + webtoon/dense
+
+### wuxia
+- **Triggers**: Martial arts, wuxia, xianxia, cultivation, swordplay
+- **Special rules**: Qi effects, combat visuals, atmospheric elements
+- **Base**: ink-brush + action + splash
+
+### shoujo
+- **Triggers**: Romance, love story, school life, emotional drama
+- **Special rules**: Decorative elements, eye details, romantic beats
+- **Base**: manga + romantic + standard
+
+## Compatibility Matrix
+
+Art Style × Tone combinations work best when matched appropriately:
+
+| Art Style | ✓✓ Best | ✓ Works | ✗ Avoid |
+|-----------|---------|---------|---------|
+| ligne-claire | neutral, warm | dramatic, vintage, energetic | romantic, action |
+| manga | neutral, romantic, energetic, action | warm, dramatic | vintage |
+| realistic | neutral, warm, dramatic, vintage | action | romantic, energetic |
+| ink-brush | neutral, dramatic, action, vintage | warm | romantic, energetic |
+| chalk | neutral, warm, energetic | vintage | dramatic, action, romantic |
+
+**Note**: Art Style × Tone × Layout can be freely combined. Incompatible combinations work but may produce unexpected results.
+
+## Priority Order
+
+1. User-specified options (`--art`, `--tone`, `--style`)
+2. EXTEND.md defaults
+3. Content signal analysis → auto-selection
+4. Fallback: ligne-claire + neutral + standard
@@ -0,0 +1,154 @@
+---
+name: first-time-setup
+description: First-time setup flow for baoyu-comic preferences
+---
+
+# First-Time Setup
+
+## Overview
+
+When no EXTEND.md is found, guide user through preference setup.
+
+**⛔ BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
+- Ask about content/source material
+- Ask about art style or tone
+- Ask about layout preferences
+- Proceed to content analysis
+
+ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
+
+## Setup Flow
+
+```
+No EXTEND.md found
+        │
+        ▼
+┌─────────────────────┐
+│ AskUserQuestion     │
+│ (all questions)     │
+└─────────────────────┘
+        │
+        ▼
+┌─────────────────────┐
+│ Create EXTEND.md    │
+└─────────────────────┘
+        │
+        ▼
+    Continue to Step 1
+```
+
+## Questions
+
+**Language**: Use user's input language or preferred language for all questions. Do not always use English.
+
+Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):
+
+### Question 1: Watermark
+
+```
+header: "Watermark"
+question: "Watermark text for generated comic pages? Type your watermark content (e.g., name, @handle)"
+options:
+  - label: "No watermark (Recommended)"
+    description: "No watermark, can enable later in EXTEND.md"
+```
+
+Position defaults to bottom-right.
+
+### Question 2: Preferred Art Style
+
+```
+header: "Art"
+question: "Default art style preference? Or type another style name"
+options:
+  - label: "Auto-select (Recommended)"
+    description: "Auto-select based on content analysis"
+  - label: "ligne-claire"
+    description: "Uniform lines, flat colors, European comic (Tintin style)"
+  - label: "manga"
+    description: "Japanese manga style, expressive eyes and emotions"
+  - label: "realistic"
+    description: "Digital painting, sophisticated and professional"
+```
+
+### Question 3: Preferred Tone
+
+```
+header: "Tone"
+question: "Default tone/mood preference?"
+options:
+  - label: "Auto-select (Recommended)"
+    description: "Auto-select based on content signals"
+  - label: "neutral"
+    description: "Balanced, rational, educational"
+  - label: "warm"
+    description: "Nostalgic, personal, comforting"
+  - label: "dramatic"
+    description: "High contrast, intense, powerful"
+```
+
+### Question 4: Language
+
+```
+header: "Language"
+question: "Output language for comic text?"
+options:
+  - label: "Auto-detect (Recommended)"
+    description: "Match source content language"
+  - label: "zh"
+    description: "Chinese (中文)"
+  - label: "en"
+    description: "English"
+```
+
+### Question 5: Save Location
+
+```
+header: "Save"
+question: "Where to save preferences?"
+options:
+  - label: "Project"
+    description: ".baoyu-skills/ (this project only)"
+  - label: "User"
+    description: "~/.baoyu-skills/ (all projects)"
+```
+
+## Save Locations
+
+| Choice | Path | Scope |
+|--------|------|-------|
+| Project | `.baoyu-skills/baoyu-comic/EXTEND.md` | Current project |
+| User | `~/.baoyu-skills/baoyu-comic/EXTEND.md` | All projects |
+
+## After Setup
+
+1. Create directory if needed
+2. Write EXTEND.md with frontmatter
+3. Confirm: "Preferences saved to [path]"
+4. Continue to Step 1
+
+## EXTEND.md Template
+
+```yaml
+---
+version: 2
+watermark:
+  enabled: [true/false]
+  content: "[user input or empty]"
+  position: bottom-right
+  opacity: 0.5
+preferred_art: [selected art style or null]
+preferred_tone: [selected tone or null]
+preferred_layout: null
+preferred_aspect: null
+language: [selected or null]
+character_presets: []
+---
+```
+
+## Modifying Preferences Later
+
+Users can edit EXTEND.md directly or run setup again:
+- Delete EXTEND.md to trigger setup
+- Edit YAML frontmatter for quick changes
+- Full schema: `config/preferences-schema.md`
@@ -0,0 +1,155 @@
+---
+name: preferences-schema
+description: EXTEND.md YAML schema for baoyu-comic user preferences
+---
+
+# Preferences Schema
+
+## Full Schema
+
+```yaml
+---
+version: 2
+
+watermark:
+  enabled: false
+  content: ""
+  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right
+
+preferred_art: null       # ligne-claire|manga|realistic|ink-brush|chalk
+preferred_tone: null      # neutral|warm|dramatic|romantic|energetic|vintage|action
+preferred_layout: null    # standard|cinematic|dense|splash|mixed|webtoon
+preferred_aspect: null    # 3:4|4:3|16:9
+
+language: null            # zh|en|ja|ko|auto
+
+character_presets:
+  - name: my-characters
+    roles:
+      learner: "Name"
+      mentor: "Name"
+      challenge: "Name"
+      support: "Name"
+---
+```
+
+## Field Reference
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `version` | int | 2 | Schema version |
+| `watermark.enabled` | bool | false | Enable watermark |
+| `watermark.content` | string | "" | Watermark text (@username or custom) |
+| `watermark.position` | enum | bottom-right | Position on image |
+| `preferred_art` | string | null | Art style (ligne-claire, manga, realistic, ink-brush, chalk) |
+| `preferred_tone` | string | null | Tone (neutral, warm, dramatic, romantic, energetic, vintage, action) |
+| `preferred_layout` | string | null | Layout preference or null |
+| `preferred_aspect` | string | null | Aspect ratio (3:4, 4:3, 16:9) |
+| `language` | string | null | Output language (null = auto-detect) |
+| `character_presets` | array | [] | Preset character roles for styles like ohmsha |
+
+## Art Style Options
+
+| Value | 中文 | Description |
+|-------|------|-------------|
+| `ligne-claire` | 清线 | Uniform lines, flat colors, European comic tradition |
+| `manga` | 日漫 | Large eyes, manga conventions, expressive emotions |
+| `realistic` | 写实 | Digital painting, realistic proportions |
+| `ink-brush` | 水墨 | Chinese brush strokes, ink wash effects |
+| `chalk` | 粉笔 | Chalkboard aesthetic, hand-drawn warmth |
+
+## Tone Options
+
+| Value | 中文 | Description |
+|-------|------|-------------|
+| `neutral` | 中性 | Balanced, rational, educational |
+| `warm` | 温馨 | Nostalgic, personal, comforting |
+| `dramatic` | 戏剧 | High contrast, intense, powerful |
+| `romantic` | 浪漫 | Soft, beautiful, decorative elements |
+| `energetic` | 活力 | Bright, dynamic, exciting |
+| `vintage` | 复古 | Historical, aged, period authenticity |
+| `action` | 动作 | Speed lines, impact effects, combat |
+
+## Position Options
+
+| Value | Description |
+|-------|-------------|
+| `bottom-right` | Lower right corner (default, works with most panel layouts) |
+| `bottom-left` | Lower left corner |
+| `bottom-center` | Bottom center (good for webtoon vertical scroll) |
+| `top-right` | Upper right corner (avoid - conflicts with page numbers) |
+
+## Character Preset Fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Unique preset identifier |
+| `roles.learner` | No | Character representing the learner/protagonist |
+| `roles.mentor` | No | Character representing the teacher/guide |
+| `roles.challenge` | No | Character representing obstacles/antagonist |
+| `roles.support` | No | Character providing support/comic relief |
+
+## Example: Minimal Preferences
+
+```yaml
+---
+version: 2
+watermark:
+  enabled: true
+  content: "@myusername"
+preferred_art: ligne-claire
+preferred_tone: neutral
+---
+```
+
+## Example: Full Preferences
+
+```yaml
+---
+version: 2
+watermark:
+  enabled: true
+  content: "@comicstudio"
+  position: bottom-right
+
+preferred_art: manga
+preferred_tone: neutral
+
+preferred_layout: webtoon
+
+preferred_aspect: "3:4"
+
+language: zh
+
+character_presets:
+  - name: tech-tutorial
+    roles:
+      learner: "小明"
+      mentor: "教授"
+      challenge: "难题怪"
+      support: "小助手"
+  - name: doraemon
+    roles:
+      learner: "大雄"
+      mentor: "哆啦A梦"
+      challenge: "胖虎"
+      support: "静香"
+---
+```
+
+## Migration from v1
+
+If you have a v1 preferences file with `preferred_style`, migrate as follows:
+
+| Old `preferred_style.name` | New `preferred_art` | New `preferred_tone` |
+|---------------------------|---------------------|---------------------|
+| classic | ligne-claire | neutral |
+| dramatic | ligne-claire | dramatic |
+| warm | ligne-claire | warm |
+| sepia | realistic | vintage |
+| vibrant | manga | energetic |
+| ohmsha | manga | neutral |
+| realistic | realistic | neutral |
+| wuxia | ink-brush | action |
+| shoujo | manga | romantic |
+| chalkboard | chalk | neutral |
@@ -0,0 +1,66 @@
+---
+name: watermark-guide
+description: Watermark configuration guide for baoyu-comic
+---
+
+# Watermark Guide
+
+## Position Diagram
+
+```
+┌─────────────────────────────┐
+│                  [top-right]│ ← Avoid (conflicts with page numbers)
+│                             │
+│                             │
+│       COMIC PAGE CONTENT    │
+│                             │
+│                             │
+│[bottom-left][bottom-center][bottom-right]│
+└─────────────────────────────┘
+```
+
+## Position Recommendations
+
+| Position | Best For | Avoid When |
+|----------|----------|------------|
+| `bottom-right` | Default choice, works with most panel layouts | Key panel in bottom-right |
+| `bottom-left` | Right-heavy layouts | Key panel in bottom-left |
+| `bottom-center` | Webtoon vertical scroll, centered designs | Text-heavy bottom area |
+| `top-right` | **Not recommended for comics** | Always - conflicts with page numbers |
+
+## Content Format
+
+| Format | Example | Style |
+|--------|---------|-------|
+| Handle | `@username` | Social media style |
+| Text | `Studio Name` | Professional branding |
+| Chinese | `漫画工作室` | Chinese market |
+| Initials | `ABC` | Minimal, clean |
+
+## Best Practices for Comics
+
+1. **Panel-aware placement**: Avoid placing over speech bubbles or key action
+2. **Consistency**: Use same watermark across all pages in comic
+3. **Size**: Keep subtle - should not distract from storytelling
+4. **Style matching**: Watermark style should complement comic's visual style
+5. **Webtoon special**: Use `bottom-center` for vertical scroll format
+
+## Prompt Integration
+
+When watermark is enabled, add to image generation prompt:
+
+```
+Include a subtle watermark "[content]" positioned at [position].
+The watermark should be legible but not distracting from the comic panels
+and storytelling. Ensure watermark does not overlap speech bubbles or key action.
+```
+
+## Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Watermark invisible on dark panels | Adjust contrast or add subtle outline |
+| Watermark overlaps speech bubble | Change position or lower on page |
+| Watermark inconsistent across pages | Use session ID for consistency |
+| Watermark too prominent | Change position or reduce size |
+| Conflicts with page number | Never use top-right position |
@@ -0,0 +1,123 @@
+# Partial Workflows
+
+Options to run specific parts of the workflow.
+
+## Options Summary
+
+| Option | Steps Executed | Output |
+|--------|----------------|--------|
+| `--storyboard-only` | 1-3 | `storyboard.md` + `characters/` |
+| `--prompts-only` | 1-5 | + `prompts/*.md` |
+| `--images-only` | 7-9 | + images + PDF |
+| `--regenerate N` | 7 (partial) | Specific page(s) + PDF |
+
+---
+
+## Using `--storyboard-only`
+
+Generate storyboard and characters without prompts or images:
+
+```bash
+/baoyu-comic content.md --storyboard-only
+```
+
+**Workflow**: Steps 1-3 only (stop after storyboard + characters)
+
+**Output**:
+- `analysis.md`
+- `storyboard.md`
+- `characters/characters.md`
+
+**Use case**: Review and edit the storyboard before generating images. Useful for:
+- Getting feedback on the narrative structure
+- Making manual adjustments to panel layouts
+- Defining custom characters
+
+---
+
+## Using `--prompts-only`
+
+Generate storyboard, characters, and prompts without images:
+
+```bash
+/baoyu-comic content.md --prompts-only
+```
+
+**Workflow**: Steps 1-5 (generate prompts, skip images)
+
+**Output**:
+- `analysis.md`
+- `storyboard.md`
+- `characters/characters.md`
+- `prompts/*.md`
+
+**Use case**: Review and edit prompts before image generation. Useful for:
+- Fine-tuning image generation prompts
+- Ensuring visual consistency before committing to generation
+- Making style adjustments at the prompt level
+
+---
+
+## Using `--images-only`
+
+Generate images from existing prompts (starts at Step 7):
+
+```bash
+/baoyu-comic comic/topic-slug/ --images-only
+```
+
+**Workflow**: Skip to Step 7, then 8-9
+
+**Prerequisites** (must exist in directory):
+- `prompts/` directory with page prompt files
+- `storyboard.md` with style information
+- `characters/characters.md` with character definitions
+
+**Output**:
+- `characters/characters.png` (if not exists)
+- `NN-{cover|page}-[slug].png` images
+- `{topic-slug}.pdf`
+
+**Use case**: Re-generate images after editing prompts. Useful for:
+- Recovering from failed image generation
+- Trying different image generation settings
+- Regenerating after manual prompt edits
+
+---
+
+## Using `--regenerate`
+
+Regenerate specific pages only:
+
+```bash
+# Single page
+/baoyu-comic comic/topic-slug/ --regenerate 3
+
+# Multiple pages
+/baoyu-comic comic/topic-slug/ --regenerate 2,5,8
+
+# Cover page
+/baoyu-comic comic/topic-slug/ --regenerate 0
+```
+
+**Workflow**:
+1. Read existing prompts for specified pages
+2. Regenerate images only for those pages
+3. Regenerate PDF
+
+**Prerequisites** (must exist):
+- `prompts/NN-{cover|page}-[slug].md` for specified pages
+- `characters/characters.png` (for reference)
+
+**Output**:
+- Regenerated `NN-{cover|page}-[slug].png` for specified pages
+- Updated `{topic-slug}.pdf`
+
+**Use case**: Fix specific pages without regenerating entire comic. Useful for:
+- Fixing a single problematic page
+- Iterating on specific visuals
+- Regenerating pages after prompt edits
+
+**Page numbering**:
+- `0` = Cover page
+- `1-N` = Content pages
@@ -0,0 +1,114 @@
+# ohmsha
+
+Ohmsha预设 - Educational manga with visual metaphors
+
+## Base Configuration
+
+| Dimension | Value |
+|-----------|-------|
+| Art Style | manga |
+| Tone | neutral |
+| Layout | webtoon (default) |
+
+Equivalent to: `--art manga --tone neutral`
+
+## Unique Rules
+
+This preset includes special rules beyond the art+tone combination. When `--style ohmsha` is used, ALL rules below must be applied.
+
+### Visual Metaphor Requirements (CRITICAL)
+
+Every technical concept MUST be visualized as a metaphor:
+
+| Concept Type | Visualization Approach |
+|-------------|----------------------|
+| Algorithm | Gadget/machine that demonstrates the process |
+| Data structure | Physical space characters can enter/explore |
+| Mathematical formula | Transformation visible in environment |
+| Abstract process | Tangible flow of particles/objects |
+
+**Wrong approach**: Character points at blackboard explaining
+**Right approach**: Character uses "Concept Visualizer" gadget, steps into metaphorical space
+
+### Visual Metaphor Examples
+
+| Concept | Wrong (Talking Head) | Right (Visual Metaphor) |
+|---------|---------------------|------------------------|
+| Attention mechanism | Character points at formula on blackboard | "Attention Flashlight" gadget illuminates key words in dark room |
+| Gradient descent | "The algorithm minimizes loss" | Character rides ball rolling down mountain valley |
+| Neural network | Diagram with arrows | Living network of glowing creatures passing messages |
+| Overfitting | "The model memorized the data" | Character wearing clothes that fit only one specific pose |
+
+### Character Roles (Required)
+
+**DEFAULT: Use Doraemon characters** unless user explicitly specifies `--characters` or has character presets in EXTEND.md.
+
+| Role | Default Character | Visual | Traits |
+|------|-------------------|--------|--------|
+| Student (Role A) | 大雄 (Nobita) | Boy, 10yo, round glasses, black hair, yellow shirt, navy shorts | Confused, asks basic but crucial questions, represents reader |
+| Mentor (Role B) | 哆啦A梦 (Doraemon) | Blue robot cat, white belly, 4D pocket, red nose, golden bell | Knowledgeable, patient, uses gadgets as technical metaphors |
+| Challenge (Role C) | 胖虎 (Gian) | Stocky boy, small eyes, orange shirt | Represents misunderstanding, or "noise" in the data |
+| Support (Role D) | 静香 (Shizuka) | Cute girl, black short hair, pink dress | Asks clarifying questions, provides alternative perspectives |
+
+**IMPORTANT**: These Doraemon characters ARE the default for ohmsha preset. Generate character definitions using these exact characters unless user requests otherwise.
+
+To use custom characters: `--characters "Student:小明,Mentor:教授"` or define in EXTEND.md.
+
+### Page Title Convention
+
+Every page MUST have a narrative title (not section header):
+
+**Wrong**: "Chapter 1: Introduction to Transformers"
+**Right**: "The Day Nobita Couldn't Understand Anyone"
+
+### Gadget Reveal Pattern
+
+When introducing a concept:
+
+1. Student expresses confusion with visual indicator (？, spiral eyes)
+2. Mentor dramatically produces gadget with sparkle effects
+3. Gadget name announced in bold with explanation
+4. Demonstration begins - student enters metaphorical space
+
+### Ending Requirements
+
+Final page MUST include:
+
+1. Student demonstrating understanding (applying the concept)
+2. Callback to opening problem (now resolved)
+3. Mentor's satisfied expression
+4. Optional: hint at next topic
+
+### NO Talking Heads Rule
+
+**Critical**: Characters must DO things, not just explain.
+
+Every panel should show:
+- Action being performed
+- Metaphor being demonstrated
+- Character interaction with concept-space
+- NOT: two characters facing each other talking
+
+### Special Visual Elements
+
+| Element | Usage |
+|---------|-------|
+| Gadget reveals | Dramatic unveiling with sparkle effects |
+| Concept spaces | Rounded borders, glowing edges for "imagination mode" |
+| Information displays | Holographic UI style for technical details |
+| Aha moments | Radial lines, light burst effects |
+| Confusion | Spiral eyes, question marks floating above head |
+
+## Quality Markers
+
+- ✓ Every concept is a visual metaphor
+- ✓ Characters are DOING things, not just talking
+- ✓ Clear student/mentor dynamic
+- ✓ Gadgets and props drive the explanation
+- ✓ Expressive manga-style emotions
+- ✓ Information density through visual design, not text walls
+- ✓ Narrative page titles
+
+## Reference
+
+For complete guidelines, see `references/ohmsha-guide.md`
@@ -0,0 +1,116 @@
+# shoujo
+
+少女预设 - Classic shoujo manga with romantic aesthetics
+
+## Base Configuration
+
+| Dimension | Value |
+|-----------|-------|
+| Art Style | manga |
+| Tone | romantic |
+| Layout | standard (default) |
+
+Equivalent to: `--art manga --tone romantic`
+
+## Unique Rules
+
+This preset includes special rules beyond the art+tone combination. When `--style shoujo` is used, ALL rules below must be applied.
+
+### Decorative Elements (Required)
+
+Every emotional moment must include decorative elements:
+
+| Emotion | Required Decorations |
+|---------|---------------------|
+| Love | Floating hearts, sparkles, rose petals |
+| Longing | Feathers, bubbles, distant sparkles |
+| Joy | Flowers blooming, light bursts, stars |
+| Sadness | Falling petals, fading sparkles |
+| Shyness | Soft sparkles, floating bubbles |
+| Realization | Radiating lines with sparkles |
+
+### Eye Detail Requirements
+
+Eyes are critical in shoujo style:
+
+| Aspect | Treatment |
+|--------|-----------|
+| Size | Larger than standard manga (1.2x) |
+| Highlights | Multiple (3-5), placed for emotion |
+| Reflection | Scene reflection in emotional moments |
+| Sparkle | Built-in sparkle effects |
+| Tears | Crystalline, detailed teardrops |
+
+### Character Beauty Standards
+
+| Feature | Treatment |
+|---------|-----------|
+| Hair | Flowing, detailed strands, shine highlights |
+| Skin | Porcelain, soft blush on cheeks |
+| Lips | Soft, slightly glossy |
+| Hands | Elegant, expressive gestures |
+| Posture | Graceful, elegant poses |
+
+### Background Effects
+
+**Abstract backgrounds** for emotional moments:
+
+| Moment Type | Background |
+|-------------|-----------|
+| Love confession | Soft gradient + floating flowers |
+| Shock | Screen tone speed lines + sparkles |
+| Memory | Dreamy blur + scattered petals |
+| Realization | Radial lines + light burst |
+| Intimate | Soft focus + floating elements |
+
+### Panel Flow
+
+- Overlap panels for intimate moments
+- Break panel borders for emotional impact
+- Float decorative elements between panels
+- Use screen tone gradients for mood
+- Irregular panel shapes for drama
+
+### Emotional Beat Timing
+
+Slow down pacing for emotional impact:
+
+| Scene Type | Panel Treatment |
+|------------|-----------------|
+| Confession | Multiple small panels, then splash |
+| Eye contact | Close-up sequence |
+| Touch | Slow-motion panel breakdown |
+| Realization | Build-up panels then impact |
+
+### Color Palette Application
+
+| Scene Type | Palette |
+|------------|---------|
+| Romantic | Pink, lavender, rose gold |
+| Happy | Soft yellow, peach, sky blue |
+| Sad | Pale blue, silver, gray lavender |
+| Dramatic | Deep rose, purple, contrast |
+
+### Screen Tone Usage
+
+| Mood | Tone Pattern |
+|------|-------------|
+| Neutral | Clean, minimal |
+| Romantic | Soft gradient overlays |
+| Dramatic | Heavy contrast tones |
+| Dreamy | Soft dot patterns |
+
+## Quality Markers
+
+- ✓ Large, sparkling detailed eyes
+- ✓ Decorative elements in emotional moments
+- ✓ Flowing, beautiful character designs
+- ✓ Soft, pastel color palette
+- ✓ Elegant panel compositions
+- ✓ Screen tone mood effects
+- ✓ Romantic atmosphere throughout
+- ✓ Beautiful, expressive poses
+
+## Best For
+
+Romance stories, coming-of-age, friendship narratives, school life, emotional drama, love stories
@@ -0,0 +1,110 @@
+# wuxia
+
+武侠预设 - Hong Kong martial arts comic style
+
+## Base Configuration
+
+| Dimension | Value |
+|-----------|-------|
+| Art Style | ink-brush |
+| Tone | action |
+| Layout | splash (default) |
+
+Equivalent to: `--art ink-brush --tone action`
+
+## Unique Rules
+
+This preset includes special rules beyond the art+tone combination. When `--style wuxia` is used, ALL rules below must be applied.
+
+### Qi/Energy Effects (Required)
+
+Martial arts power must be visible through qi effects:
+
+| Effect Type | Visual Treatment |
+|-------------|-----------------|
+| Internal qi | Glowing aura around character |
+| External qi | Visible energy projection |
+| Qi clash | Radiating impact waves |
+| Qi absorption | Flowing particles toward character |
+| Hidden power | Subtle glow in eyes/fists |
+
+### Energy Colors
+
+| Qi Type | Color |
+|---------|-------|
+| Righteous | Blue (#4299E1), Gold (#FFD700) |
+| Fierce | Red (#DC2626), Orange (#EA580C) |
+| Evil | Purple (#7C3AED), Green (#16A34A) |
+| Pure | White, Silver |
+| Ancient | Gold with particles |
+
+### Combat Visual Language
+
+**Impact moments** must include:
+
+1. Speed lines radiating from impact point
+2. Flying debris (stone, wood, cloth)
+3. Shockwave rings
+4. Dust/energy clouds
+5. Hair and clothing blown back
+
+### Movement Depiction
+
+| Speed Level | Visual Treatment |
+|-------------|-----------------|
+| Normal | Standard pose |
+| Fast | Motion blur, speed lines |
+| Lightning | Afterimages, multiple positions |
+| Teleport | Fade effect, particle trail |
+
+### Environmental Integration
+
+Backgrounds must support action:
+
+| Environment | Combat Enhancement |
+|-------------|-------------------|
+| Mountains | Crumbling peaks from impacts |
+| Forest | Exploding trees, flying leaves |
+| Water | Dramatic splashes, walking on water |
+| Temple | Breaking pillars, flying tiles |
+| Cliff | Dramatic falls, wind effects |
+
+### Character Pose Guidelines
+
+- Dynamic warrior stances with weight distribution
+- Flowing robes and hair showing movement
+- Muscle tension visible in action
+- Feet planted or in dynamic motion
+- Traditional martial arts postures
+
+### Weapon Effects
+
+| Weapon | Visual Treatment |
+|--------|-----------------|
+| Sword | Trailing light arc, blade glow |
+| Palm | Qi projection, wind effect |
+| Staff | Spinning blur, impact ripples |
+| Whip | Flowing energy trail |
+
+### Atmospheric Elements
+
+Always include:
+- Floating particles (leaves, petals, dust)
+- Ink wash mist for depth
+- Wind direction indicators
+- Dramatic sky/weather when appropriate
+
+## Quality Markers
+
+- ✓ Dynamic action poses with sense of motion
+- ✓ Ink brush aesthetic in line work
+- ✓ Visible qi/energy effects
+- ✓ High contrast dramatic lighting
+- ✓ Atmospheric backgrounds with Chinese elements
+- ✓ Flowing fabric and hair movement
+- ✓ Impactful combat moments
+- ✓ Speed lines and impact effects
+
+## Best For
+
+Martial arts stories, Chinese historical fiction, wuxia/xianxia adaptations, action-heavy narratives
@@ -1,61 +0,0 @@
-# chalkboard
-
-Black chalkboard background with colorful chalk drawing style
-
-## Design Aesthetic
-
-Classic classroom chalkboard aesthetic with hand-drawn chalk illustrations. Nostalgic educational feel with imperfect, sketchy lines that capture the warmth of traditional teaching. Colorful chalk creates visual hierarchy while maintaining the authentic chalkboard experience.
-
-## Background
-
- Color: Chalkboard Black (#1A1A1A) or Dark Green-Black (#1C2B1C)
- Texture: Realistic chalkboard texture with subtle scratches, dust particles, and faint eraser marks
-
-## Typography
-
-Hand-drawn chalk lettering style with visible chalk texture. Imperfect baseline adds authenticity. White or bright colored chalk for emphasis.
-
-## Color Palette
-
-| Role | Color | Hex | Usage |
-|------|-------|-----|-------|
-| Background | Chalkboard Black | #1A1A1A | Primary background |
-| Alt Background | Green-Black | #1C2B1C | Traditional green board |
-| Primary Text | Chalk White | #F5F5F5 | Main text, outlines |
-| Accent 1 | Chalk Yellow | #FFE566 | Highlights, emphasis |
-| Accent 2 | Chalk Pink | #FF9999 | Secondary highlights |
-| Accent 3 | Chalk Blue | #66B3FF | Diagrams, links |
-| Accent 4 | Chalk Green | #90EE90 | Success, nature |
-| Accent 5 | Chalk Orange | #FFB366 | Warnings, energy |
-
-## Visual Elements
-
- Hand-drawn chalk illustrations with sketchy, imperfect lines
- Chalk dust effects around text and key elements
- Doodles: stars, arrows, underlines, circles, checkmarks
- Mathematical formulas and simple diagrams
- Eraser smudges and chalk residue textures
- Wooden frame border optional
- Stick figures and simple icons
- Connection lines with hand-drawn feel
-
-## Style Rules
-
-### Do
-
- Maintain authentic chalk texture on all elements
- Use imperfect, hand-drawn quality throughout
- Add subtle chalk dust and smudge effects
- Create visual hierarchy with color variety
- Include playful doodles and annotations
-
-### Don't
-
- Use perfect geometric shapes
- Create clean digital-looking lines
- Add photorealistic elements
- Use gradients or glossy effects
-
-## Best For
-
-Educational content, tutorials, classroom themes, teaching materials, workshops, informal learning sessions, knowledge sharing
@@ -1,54 +0,0 @@
-# classic
-
-Traditional Ligne Claire, balanced and timeless
-
-## Style Guidelines
-
-### Line Work
- Uniform, clean outlines with consistent weight (approximately 2px)
- No hatching or cross-hatching for shading
- Sharp, precise edges on all elements
- Black ink outlines on all figures and objects
- Shadows indicated through flat color areas, not line techniques
-
-### Character Design
- Slightly stylized/cartoonish characters with realistic proportions
- Distinctive, recognizable facial features
- Expressive faces with clear emotions
- Period-appropriate clothing with attention to detail
- Consistent character appearance across panels
-
-### Background Treatment
- Detailed, realistic backgrounds with architectural accuracy
- Period-specific props and technology
- Clear spatial depth and perspective
- Environmental storytelling through details
- Contrast between simplified characters and detailed backgrounds
-
-## Color Palette
-
- Primary: Clean blue (#3182CE), red (#E53E3E), yellow (#ECC94B)
- Skin: Warm tan (#F7CFAE)
- Background: Light cream (#FFFAF0), sky blue (#BEE3F8)
-
-## Color Approach
- Flat colors without gradients (true to Ligne Claire tradition)
- Limited palette per page for cohesion
- Colors support narrative mood
- Consistent lighting logic within scenes
-
-## Quality Markers
-
-A good Ligne Claire comic page exhibits:
- ✓ Clean, uniform line weight throughout
- ✓ Flat colors without gradients
- ✓ Detailed backgrounds, stylized characters
- ✓ Clear panel borders and reading flow
- ✓ Hand-drawn text style
- ✓ Period-appropriate details
- ✓ Expressive but consistent characters
- ✓ Proper perspective in environments
-
-## Best For
-
-Educational content, balanced narratives, biography comics
@@ -1,34 +0,0 @@
-# dramatic
-
-High contrast, intense moments
-
-## Style Guidelines
-
-### Line Work
- 2-3px outlines, heavier on shadows
- Dramatic angles and perspectives
- Strong contrast between light and dark areas
-
-### Character Design
- Intense expressions, dynamic poses
- Dramatic lighting on faces
- Sharp angular features emphasized
-
-### Background Treatment
- High contrast, angular shadows
- Dramatic lighting effects
- Silhouettes and stark compositions
-
-## Color Palette
-
- Primary: Deep navy (#1A365D), crimson (#9B2C2C), stark white
- Shadows: Heavy blacks, dramatic contrast
- Highlights: Sharp whites, limited mid-tones
-
-## Mood
-
-Tension, breakthrough moments, conflict
-
-## Best For
-
-Pivotal discoveries, conflicts, climactic scenes
@@ -1,107 +0,0 @@
-# ohmsha
-
-Ohmsha Manga Guide style - educational manga with visual metaphors
-
-## Core Philosophy
-
-Educational manga where every concept becomes a visual metaphor or action. NO talking heads - characters must DO things, not just explain.
-
-## Visual Style
-
- **Type**: Manga-style educational comic
- **Orientation**: Portrait (vertical), optimized for scrolling
- **Colors**: Full color, bright and clean anime/manga aesthetic
- **Lines**: Clean manga lines (1.5-2px), smooth curves, expressive
-
-## Character Design (Manga Style)
-
- Anime/manga proportions: slightly larger eyes, expressive faces
- **Student character**: Confused expressions, question marks (？), sweat drops, represents reader
- **Mentor character**: Confident poses, explanatory gestures, produces gadgets/tools
- Clear emotional indicators using manga conventions (！, ？, sweat drops, sparkles)
- Consistent character designs across all panels
-
-## Background Treatment
-
- Simplified backgrounds during dialogue/explanation
- Detailed "imagination spaces" for concept visualization
- Technical diagrams styled as holographic displays or magical blueprints
- Screen tone effects for atmosphere
-
-## Visual Metaphor Requirements (CRITICAL)
-
-Every technical concept MUST be visualized as:
-
-| Concept Type | Visualization Approach |
-|-------------|----------------------|
-| Algorithm | Gadget/machine that demonstrates the process |
-| Data structure | Physical space characters can enter/explore |
-| Mathematical formula | Transformation visible in environment |
-| Abstract process | Tangible flow of particles/objects |
-
-**Wrong approach**: Character points at blackboard explaining
-**Right approach**: Character uses "Concept Visualizer" gadget, steps into metaphorical space
-
-### Visual Metaphor Examples
-
-| Concept | Wrong (Talking Head) | Right (Visual Metaphor) |
-|---------|---------------------|------------------------|
-| Attention mechanism | Character points at formula on blackboard | "Attention Flashlight" gadget illuminates key words in dark room |
-| Gradient descent | "The algorithm minimizes loss" | Character rides ball rolling down mountain valley |
-| Neural network | Diagram with arrows | Living network of glowing creatures passing messages |
-| Overfitting | "The model memorized the data" | Character wearing clothes that fit only one specific pose |
-
-## Panel Layout for Ohmsha
-
- Vertical scroll optimized (webtoon style)
- Single column, panels stack vertically
- Generous whitespace between major beats
- Panels can bleed to edges for impact
- "Float" elements between panels for emphasis
-
-## Special Visual Elements
-
- **Gadget reveals**: Dramatic unveiling with sparkle effects
- **Concept spaces**: Rounded borders, glowing edges for "imagination mode"
- **Information displays**: Holographic UI style for technical details
- **Aha moments**: Radial lines, light burst effects
- **Confusion**: Spiral eyes, question marks floating above head
-
-## Text Elements (Ohmsha)
-
- Hand-lettered manga style
- Sound effects integrated visually (ドキドキ, ピカーン, etc.)
- Speech bubbles: rounded for normal, spiky for excitement/shock
- Thought bubbles for internal process visualization
- Technical terms in bold with furigana-style annotations if needed
-
-## Color Palette
-
- Primary: Bright blue (#4299E1), warm orange (#ED8936), soft green (#68D391)
- Skin: Anime-style warm (#FEEBC8)
- Background: Clean white, soft gradients
- Gadgets: Metallic accents (#FFD700, #C0C0C0), vibrant highlights
- Concept spaces: Pastel backgrounds, glowing accents
-
-## Quality Markers (Ohmsha)
-
- ✓ Every concept is a visual metaphor, not just explained
- ✓ Characters are DOING things, not just talking
- ✓ Clear student/mentor dynamic
- ✓ Gadgets and props drive the explanation
- ✓ Expressive manga-style emotions
- ✓ Information density through visual design, not text walls
-
-## Character Setup (Required)
-
-Define characters before generating:
-
-| Role | Default | Traits |
-|------|---------|--------|
-| Student (Role A) | 大雄 | Confused, asks basic but crucial questions, represents reader |
-| Mentor (Role B) | 哆啦A梦 | Knowledgeable, patient, uses gadgets as technical metaphors |
-| Antagonist (Role C, optional) | 胖虎 | Represents misunderstanding, or "noise" in the data |
-
-## Best For
-
-Technical tutorials, complex concepts (ML, physics, math), self-study material
@@ -1,66 +0,0 @@
-# realistic
-
-Full-color realistic manga style with digital painting techniques
-
-## Style Guidelines
-
-### Line Work
- Clean, precise outlines with clear contours
- Uniform line weight for character definition
- No excessive hatching - rely on color for depth
- Smooth curves and realistic anatomical lines
- Ligne Claire influence: clean but not overly simplified
-
-### Character Design
- Realistic human proportions (7-8 head heights)
- Anatomically accurate features and expressions
- Detailed facial structure without exaggeration
- Natural poses and body language
- Consistent character appearance across all panels
- Subtle expressions rather than manga-style exaggeration
-
-### Rendering Style
- Full-color digital painting with rich gradients
- Soft shadow transitions on skin and fabric
- Realistic material textures (glass, liquid, fabric, wood)
- Detailed hair with natural shine and volume
- Environmental lighting affects all elements
- NOT flat cel-shading - use smooth color blending
-
-### Background Treatment
- Highly detailed, realistic environments
- Accurate perspective and spatial depth
- Atmospheric lighting (warm indoor, cool outdoor)
- Professional settings rendered with precision
- Props and objects with realistic textures
-
-## Color Palette
-
- Skin: Natural warm tones (#F5D6C6, #E8C4B0)
- Hair: Rich browns and blacks with highlights
- Environment: Warm wood tones (#8B7355), cool stone (#9CA3AF)
- Accent: Wine red (#722F37), gold (#D4AF37)
- Lighting: Warm amber (#FFB347), cool blue (#B0C4DE)
-
-## Color Approach
- Rich gradients for depth and volume
- Realistic lighting with warm/cool contrast
- Material-specific rendering (glass transparency, liquid reflection)
- Subtle color temperature shifts for atmosphere
- Professional, sophisticated palette
-
-## Quality Markers
-
-A good realistic manga page exhibits:
- ✓ Anatomically accurate character proportions
- ✓ Smooth color gradients (not flat fills)
- ✓ Realistic material textures
- ✓ Detailed, atmospheric backgrounds
- ✓ Natural lighting with soft shadows
- ✓ Expressive but subtle facial expressions
- ✓ Professional, sophisticated aesthetic
- ✓ Clean speech bubbles with clear typography
-
-## Best For
-
-Professional topics (wine, food, business), lifestyle content, adult-oriented narratives, educational guides for mature audiences, documentary-style storytelling
@@ -1,34 +0,0 @@
-# sepia
-
-Historical, archival feel
-
-## Style Guidelines
-
-### Line Work
- 2px, classic weight with aged texture
- Vintage illustration style
- Period-appropriate techniques
-
-### Character Design
- Period-accurate attire, formal poses
- Historical accuracy emphasized
- Classical proportions
-
-### Background Treatment
- Historical settings, vintage details
- Aged paper effect
- Period architecture and props
-
-## Color Palette
-
- Primary: Sepia brown (#8B7355), aged paper (#F5E6D3)
- Accents: Faded teal, muted burgundy
- Background: Yellowed paper, vintage tones
-
-## Mood
-
-Historical distance, period authenticity
-
-## Best For
-
-Pre-1950s stories, classical science, historical figures
@@ -1,45 +0,0 @@
-# shoujo
-
-Classic shoujo manga style with romantic, emotional aesthetics
-
-## Style Guidelines
-
-### Line Work
- 1-1.5px, delicate and flowing
- Elegant curves, graceful strokes
- Fine details on eyes, hair, and clothing
-
-### Character Design
- Large, sparkling eyes with multiple highlights
- Slender figures, elegant proportions
- Expressive poses, dramatic gestures
- Detailed hair with flowing strands
- Fashionable clothing with intricate folds
-
-### Background Treatment
- Decorative elements: flowers, sparkles, bubbles, feathers
- Soft focus, dreamy atmospheres
- Screen tones for emotional emphasis
- Abstract backgrounds during emotional moments
-
-### Special Effects
- Screentone gradients for mood
- Sparkle and glow effects
- Floating petals, stars, hearts
- Speed lines for dramatic moments
- Light halos around characters
-
-## Color Palette
-
- Primary: Soft pink (#FFB6C1), lavender (#E6E6FA), rose (#FF69B4)
- Accent: Pearl white (#FFFAF0), gold highlights (#FFD700)
- Skin: Porcelain (#FFF5EE), soft blush (#FFE4E1)
- Background: Pastel gradients, soft cream (#FFF8DC)
-
-## Mood
-
-Romance, emotion, beauty, youth, dreams
-
-## Best For
-
-Romance, coming-of-age, friendship stories, emotional drama, school life
@@ -1,34 +0,0 @@
-# vibrant
-
-Energetic, engaging, educational
-
-## Style Guidelines
-
-### Line Work
- 2-2.5px, expressive weight variation
- Dynamic, energetic lines
- Emphasis on movement and action
-
-### Character Design
- Expressive, animated, approachable
- Wide eyes, big reactions
- Dynamic poses
-
-### Background Treatment
- Simplified, focus on action
- Bright, clean compositions
- Energy effects and motion lines
-
-## Color Palette
-
- Primary: Bright red (#F56565), sunny yellow (#F6E05E), sky blue (#63B3ED)
- Accents: Magenta, lime green
- Background: Clean white, bright pastels
-
-## Mood
-
-Excitement, discovery, wonder
-
-## Best For
-
-Science explanations, "aha" moments, young audience
@@ -1,34 +0,0 @@
-# warm
-
-Nostalgic, personal storytelling
-
-## Style Guidelines
-
-### Line Work
- 1.5-2px, slightly softer edges
- Gentle curves, friendly feel
- Less rigid than classic style
-
-### Character Design
- Friendly expressions, relaxed poses
- Warm, inviting character designs
- Approachable proportions
-
-### Background Treatment
- Cozy interiors, warm lighting
- Nostalgic feel
- Soft focus on backgrounds
-
-## Color Palette
-
- Primary: Golden (#D69E2E), orange (#DD6B20), soft brown (#8B6F47)
- Skin: Warm golden (#FEEBC8)
- Background: Warm cream (#FEF3C7), sunset tones
-
-## Mood
-
-Memory, personal journey, reflection
-
-## Best For
-
-Personal stories, childhood scenes, mentorship
@@ -1,54 +0,0 @@
-# wuxia
-
-Hong Kong martial arts comic style (港漫武侠风格)
-
-## Style Guidelines
-
-### Line Work
- 2-3px dynamic brush strokes with varying weight
- Ink wash effects, traditional Chinese brush feel
- Speed lines and impact effects for action scenes
- Bold, confident strokes with sharp edges
-
-### Character Design
- Realistic human proportions (7.5-8 head heights)
- Defined musculature, dynamic warrior poses
- Flowing hair and clothing in motion
- Intense, determined facial expressions
- Traditional Chinese martial arts attire (robes, armor)
-
-### Background Treatment
- Dramatic landscapes: mountains, waterfalls, temples
- Ink wash atmospheric effects
- Flying debris, dust clouds during combat
- Energy/qi effects with flowing lines
- High contrast silhouettes
-
-## Color Palette
-
- Primary: Deep black ink, crimson red (#8B0000), gold (#D4AF37)
- Skin: Natural tan with dramatic shadows
- Background: Misty grays, earth tones, ink wash gradients
- Effects: Glowing qi energy (blue, gold, white)
-
-## Special Effects
-
- **Combat impact**: Radiating lines, shockwaves, debris
- **Qi/energy**: Flowing aura, glowing effects around characters
- **Movement**: Extreme speed lines, motion blur
- **Atmosphere**: Ink wash clouds, mist, flying leaves/petals
-
-## Quality Markers
-
-A good wuxia comic page exhibits:
- ✓ Dynamic action poses with sense of motion
- ✓ Ink brush aesthetic in line work
- ✓ High contrast dramatic lighting
- ✓ Atmospheric backgrounds with Chinese elements
- ✓ Energy/qi effects that feel powerful
- ✓ Flowing fabric and hair movement
- ✓ Impactful combat moments
-
-## Best For
-
-Martial arts stories, Chinese historical fiction, action-heavy narratives, wuxia/xianxia adaptations
@@ -0,0 +1,110 @@
+# action
+
+动作基调 - Speed, impact, power
+
+## Overview
+
+High-impact action atmosphere with dynamic movement, combat effects, and powerful visual energy. Creates visceral, exciting sequences.
+
+## Mood Characteristics
+
+- Speed and motion
+- Power and impact
+- Combat intensity
+- Physical energy
+- Visceral excitement
+
+## Color Modifiers
+
+When applied to any art style:
+
+| Adjustment | Direction |
+|------------|-----------|
+| Saturation | High contrast |
+| Contrast | Maximum |
+| Temperature | Variable per effect |
+| Brightness | Dynamic range |
+
+## Action Effects
+
+**Combat/motion effects** (apply liberally):
+
+| Effect | Usage |
+|--------|-------|
+| Speed lines | Motion, velocity |
+| Impact bursts | Hits, collisions |
+| Shockwaves | Powerful impacts |
+| Flying debris | Environmental destruction |
+| Dust clouds | Ground impacts |
+| Motion blur | Fast movement |
+| Afterimages | Super speed |
+
+## Special Effects
+
+| Effect Type | Visual Approach |
+|------------|-----------------|
+| Energy attacks | Glowing, radiating |
+| Physical impacts | Radiating lines, debris |
+| Movement | Speed lines, blur |
+| Atmosphere | Flying particles, wind |
+
+## Effect Colors
+
+| Effect | Color | Hex |
+|--------|-------|-----|
+| Energy glow | Blue | #4299E1 |
+| Fire/power | Gold | #FFD700 |
+| Impact | White burst | #FFFFFF |
+| Blood/intensity | Deep red | #8B0000 |
+
+## Lighting
+
+- Dynamic, shifting
+- Impact flashes
+- Energy glow sources
+- Rim lighting on figures
+- Dramatic contrast
+
+## Emotional Range
+
+| Emotion | Expression |
+|---------|-----------|
+| Determination | Fierce focus |
+| Rage | Intense, powerful |
+| Triumph | Victorious pose |
+| Struggle | Strained effort |
+
+## Composition
+
+- Dynamic angles
+- Extreme perspectives
+- Panel-breaking layouts
+- Asymmetric designs
+- Impact-focused framing
+
+## Pose Guidelines
+
+- Dynamic warrior poses
+- Weight and momentum visible
+- Muscle tension shown
+- Flow of movement captured
+- Impact points emphasized
+
+## Best For
+
+- Martial arts combat
+- Action sequences
+- Sports moments
+- Physical challenges
+- Battle scenes
+- Climactic confrontations
+
+## Combination Notes
+
+Works especially well with:
+- ink-brush: wuxia combat
+- manga: shonen battles
+
+Avoid with:
+- chalk: style mismatch
+- ligne-claire: style mismatch (too static)
@@ -0,0 +1,95 @@
+# dramatic
+
+戏剧基调 - High contrast, intense, powerful moments
+
+## Overview
+
+High-impact dramatic tone for pivotal moments, conflicts, and breakthroughs. Uses strong contrast and intense compositions to create emotional power.
+
+## Mood Characteristics
+
+- Tension and intensity
+- Pivotal moments
+- Conflict and resolution
+- Breakthrough discoveries
+- Emotional climaxes
+
+## Color Modifiers
+
+When applied to any art style:
+
+| Adjustment | Direction |
+|------------|-----------|
+| Saturation | High (vibrant or deep) |
+| Contrast | Maximum |
+| Temperature | Varies for effect |
+| Brightness | Strong highlights, deep shadows |
+
+## Contrast Approach
+
+- Sharp light/dark divisions
+- Minimal mid-tones
+- Stark compositions
+- Silhouette potential
+- Rim lighting effects
+
+## Accent Colors
+
+- Deep navy (#1A365D)
+- Crimson (#9B2C2C)
+- Stark white
+- Heavy blacks
+- Limited palette per scene
+
+## Lighting
+
+- Dramatic single-source
+- High contrast shadows
+- Rim lighting on characters
+- Spotlight effects
+- Chiaroscuro influence
+
+## Emotional Range
+
+| Emotion | Expression |
+|---------|-----------|
+| Anger | Intense, defined features |
+| Determination | Strong, focused gaze |
+| Shock | Wide eyes, stark lighting |
+| Triumph | Powerful, elevated pose |
+
+## Composition
+
+- Angular, dynamic layouts
+- Dramatic camera angles
+- Low/high viewpoints
+- Diagonal compositions
+- Negative space for impact
+
+## Visual Elements
+
+- Speed lines for tension
+- Impact effects
+- Dramatic backgrounds (storms, fire)
+- Silhouettes
+- Light burst effects
+- Environmental drama
+
+## Best For
+
+- Pivotal discoveries
+- Conflict scenes
+- Climactic moments
+- Breakthrough realizations
+- Emotional confrontations
+- Historical turning points
+
+## Combination Notes
+
+Works especially well with:
+- realistic: powerful drama
+- ink-brush: martial arts climax
+- ligne-claire: historical pivots
+- manga: shonen battles
+
+Avoid with: chalk (style mismatch)
@@ -0,0 +1,105 @@
+# energetic
+
+活力基调 - Bright, dynamic, exciting
+
+## Overview
+
+High-energy atmosphere for exciting, discovery-filled content. Bright colors, dynamic compositions, and movement create engaging visuals for younger audiences.
+
+## Mood Characteristics
+
+- Excitement and wonder
+- Discovery and learning
+- Energy and enthusiasm
+- Movement and action
+- Youthful spirit
+
+## Color Modifiers
+
+When applied to any art style:
+
+| Adjustment | Direction |
+|------------|-----------|
+| Saturation | High (vibrant) |
+| Contrast | Medium-high |
+| Temperature | Variable, punchy |
+| Brightness | Bright, clean |
+
+## Color Palette
+
+Shift toward vibrant tones:
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary Red | Bright red | #F56565 |
+| Primary Yellow | Sunny yellow | #F6E05E |
+| Primary Blue | Sky blue | #63B3ED |
+| Accent 1 | Magenta | #D53F8C |
+| Accent 2 | Lime green | #68D391 |
+| Background | Clean white | #FFFFFF |
+| Background Alt | Bright pastels | Various |
+
+## Lighting
+
+- Bright, clear lighting
+- Clean shadows
+- High energy
+- Spotlight effects for emphasis
+- Dynamic light sources
+
+## Dynamic Elements
+
+**Energy effects** (add to compositions):
+
+| Element | Usage |
+|---------|-------|
+| Speed lines | Motion, excitement |
+| Sparkles | Discoveries |
+| Burst effects | Aha moments |
+| Motion blur | Fast action |
+| Star bursts | Emphasis |
+| Sweat drops | Effort/surprise |
+
+## Emotional Range
+
+| Emotion | Expression |
+|---------|-----------|
+| Excitement | Wide eyes, big smile |
+| Surprise | Dramatic reaction |
+| Determination | Intense focus |
+| Wonder | Sparkling eyes |
+
+## Composition
+
+- Dynamic angles
+- Action-oriented layouts
+- Movement emphasis
+- Clean, punchy designs
+- Energy flows
+
+## Visual Style
+
+- Expressive, animated characters
+- Wide eyes, big reactions
+- Dynamic poses
+- Motion and action focus
+- Simplified backgrounds for energy
+
+## Best For
+
+- Science explanations
+- "Aha" moments
+- Young audience content
+- Discovery narratives
+- Learning adventures
+- Action tutorials
+
+## Combination Notes
+
+Works especially well with:
+- manga: shonen energy
+- chalk: fun education
+
+Avoid with:
+- realistic: style mismatch
+- ink-brush: style mismatch
@@ -0,0 +1,63 @@
+# neutral
+
+中性基调 - Balanced, rational, educational
+
+## Overview
+
+Default balanced tone suitable for educational and informative content. Neither overly emotional nor cold - creates accessible, professional atmosphere.
+
+## Mood Characteristics
+
+- Balanced emotional register
+- Clear, rational presentation
+- Educational focus
+- Professional but approachable
+- Objective storytelling
+
+## Color Modifiers
+
+When applied to any art style:
+
+| Adjustment | Direction |
+|------------|-----------|
+| Saturation | Standard (no shift) |
+| Contrast | Balanced |
+| Temperature | Neutral |
+| Brightness | Slightly bright |
+
+## Lighting
+
+- Even, clear lighting
+- Minimal dramatic shadows
+- Consistent across panels
+- Natural light sources
+- No extreme contrast
+
+## Emotional Range
+
+| Emotion | Expression Level |
+|---------|-----------------|
+| Joy | Moderate smile |
+| Concern | Thoughtful expression |
+| Surprise | Mild widening of eyes |
+| Frustration | Slight frown |
+
+## Composition
+
+- Balanced panel layouts
+- Clear focal points
+- Readable hierarchies
+- Standard framing
+- Functional compositions
+
+## Best For
+
+- Educational content
+- Technical tutorials
+- Informative biographies
+- Documentary style
+- Professional topics
+
+## Usage Notes
+
+Neutral is the default tone. Combine with any art style for baseline professional output. Most versatile tone option.
@@ -0,0 +1,100 @@
+# romantic
+
+浪漫基调 - Soft, beautiful, emotionally delicate
+
+## Overview
+
+Soft, dreamy atmosphere for romantic and emotionally delicate content. Features decorative elements, sparkles, and beautiful compositions that emphasize feeling and beauty.
+
+## Mood Characteristics
+
+- Romance and love
+- Beauty and elegance
+- Emotional delicacy
+- Dreams and hopes
+- Youth and idealism
+
+## Color Modifiers
+
+When applied to any art style:
+
+| Adjustment | Direction |
+|------------|-----------|
+| Saturation | Soft pastels |
+| Contrast | Low, gentle |
+| Temperature | Slightly warm pink |
+| Brightness | Soft, glowing |
+
+## Color Palette
+
+Shift toward romantic tones:
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary | Soft pink | #FFB6C1 |
+| Secondary | Lavender | #E6E6FA |
+| Accent | Rose | #FF69B4 |
+| Highlight | Pearl white | #FFFAF0 |
+| Gold | Gold sparkle | #FFD700 |
+| Skin | Porcelain | #FFF5EE |
+| Blush | Soft blush | #FFE4E1 |
+| Background | Soft cream | #FFF8DC |
+
+## Lighting
+
+- Soft, diffused light
+- Glowing effects
+- Backlighting halos
+- Sparkle highlights
+- Dreamy atmospheres
+
+## Decorative Elements
+
+**Essential decorations** (add to compositions):
+
+| Element | Usage |
+|---------|-------|
+| Flower petals | Floating, framing |
+| Sparkles | Emotional highlights |
+| Bubbles | Dreamy moments |
+| Feathers | Gentle floating |
+| Stars | Night scenes, wonder |
+| Hearts | Love emphasis |
+| Light halos | Character highlights |
+
+## Emotional Range
+
+| Emotion | Expression |
+|---------|-----------|
+| Love | Soft gaze, blush |
+| Longing | Distant, beautiful sadness |
+| Joy | Radiant smile, sparkles |
+| Shyness | Downcast eyes, blush |
+
+## Composition
+
+- Elegant, flowing layouts
+- Soft focus backgrounds
+- Characters framed by decorations
+- Beautiful angles (3/4 profiles)
+- Screen tone gradients
+
+## Best For
+
+- Romance stories
+- Coming-of-age
+- Friendship narratives
+- Emotional drama
+- School life
+- Beautiful moments
+
+## Combination Notes
+
+Works especially well with:
+- manga: classic shoujo style
+
+Avoid with:
+- realistic: style mismatch
+- ink-brush: style mismatch
+- ligne-claire: style mismatch
+- chalk: style mismatch
@@ -0,0 +1,104 @@
+# vintage
+
+复古基调 - Historical, aged, period authenticity
+
+## Overview
+
+Historical atmosphere with aged paper effects and period-appropriate aesthetics. Creates sense of time, authenticity, and historical distance.
+
+## Mood Characteristics
+
+- Historical authenticity
+- Period distance
+- Archival quality
+- Time and memory
+- Classical elegance
+
+## Color Modifiers
+
+When applied to any art style:
+
+| Adjustment | Direction |
+|------------|-----------|
+| Saturation | Reduced, muted |
+| Contrast | Medium, aged |
+| Temperature | Sepia shift |
+| Brightness | Slightly faded |
+
+## Color Palette
+
+Shift toward aged tones:
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary | Sepia brown | #8B7355 |
+| Background | Aged paper | #F5E6D3 |
+| Accent 1 | Faded teal | #6B8E8E |
+| Accent 2 | Muted burgundy | #7B3F3F |
+| Ink | Aged black | #3D3D3D |
+| Yellowed | Paper yellow | #F5DEB3 |
+
+## Visual Effects
+
+**Aging effects** (apply subtly):
+
+| Effect | Application |
+|--------|-------------|
+| Paper aging | Background texture |
+| Faded edges | Vignette effect |
+| Dust specks | Subtle overlay |
+| Yellowing | Color shift |
+| Wear marks | Corner/edge details |
+
+## Period Elements
+
+- Historical typography
+- Period-accurate details
+- Archival presentation
+- Classical compositions
+- Formal framing
+
+## Lighting
+
+- Natural, period-appropriate
+- Oil lamp/candle warmth
+- Soft, diffused light
+- Indoor historical lighting
+- Photographic quality
+
+## Emotional Range
+
+| Emotion | Expression |
+|---------|-----------|
+| Dignity | Formal, composed |
+| Sorrow | Restrained, elegant |
+| Pride | Classical posture |
+| Wisdom | Aged grace |
+
+## Composition
+
+- Classical framing
+- Formal compositions
+- Period-appropriate staging
+- Documentary style
+- Historical accuracy priority
+
+## Best For
+
+- Pre-1950s stories
+- Classical science history
+- Historical biographies
+- Period pieces
+- Documentary comics
+- Archival narratives
+
+## Combination Notes
+
+Works especially well with:
+- realistic: period drama
+- ligne-claire: historical adventure
+- ink-brush: classical Asian stories
+
+Avoid with:
+- manga: style mismatch (too modern)
+- chalk: style mismatch (modern educational)
@@ -0,0 +1,94 @@
+# warm
+
+温馨基调 - Nostalgic, personal, comforting
+
+## Overview
+
+Warm, inviting atmosphere for personal stories and nostalgic content. Creates emotional connection through cozy aesthetics and comforting visuals.
+
+## Mood Characteristics
+
+- Nostalgic feeling
+- Personal, intimate atmosphere
+- Comforting and healing
+- Memory and reflection
+- Gentle emotional warmth
+
+## Color Modifiers
+
+When applied to any art style:
+
+| Adjustment | Direction |
+|------------|-----------|
+| Saturation | Slightly reduced |
+| Contrast | Softer |
+| Temperature | Warm shift (+15%) |
+| Brightness | Soft, golden |
+
+## Color Temperature
+
+Shift palette toward warm tones:
+
+| Original | Warm Shift |
+|----------|-----------|
+| Cool blue | Soft teal |
+| Pure white | Cream |
+| Gray | Warm gray |
+| Black | Soft charcoal |
+
+## Accent Colors
+
+- Golden yellow (#D69E2E)
+- Soft orange (#DD6B20)
+- Warm brown (#8B6F47)
+- Sunset tones
+
+## Lighting
+
+- Golden hour lighting
+- Soft, diffused light
+- Warm indoor glow
+- Candle/lamp warmth
+- Gentle shadows
+
+## Emotional Range
+
+| Emotion | Expression |
+|---------|-----------|
+| Joy | Genuine warm smile |
+| Sadness | Gentle melancholy |
+| Love | Soft, tender expressions |
+| Memory | Distant, reflective gaze |
+
+## Composition
+
+- Intimate framing
+- Cozy environments
+- Soft focus backgrounds
+- Welcoming spaces
+- Personal moments highlighted
+
+## Visual Elements
+
+- Warm light rays
+- Soft edges
+- Nostalgic props (old photos, keepsakes)
+- Comfort objects (blankets, tea cups)
+- Nature elements (autumn leaves, sunset)
+
+## Best For
+
+- Personal stories
+- Childhood memories
+- Mentorship narratives
+- Family histories
+- Gentle biographies
+- Healing journeys
+
+## Combination Notes
+
+Works especially well with:
+- ligne-claire: nostalgic European comics
+- realistic: touching human stories
+- manga: slice-of-life warmth
+- chalk: nostalgic education
@@ -0,0 +1,509 @@
+# Complete Workflow
+
+Full workflow for generating knowledge comics.
+
+## Progress Checklist
+
+Copy and track progress:
+
+```
+Comic Progress:
+- [ ] Step 1: Setup & Analyze
+  - [ ] 1.1 Load preferences
+  - [ ] 1.2 Analyze content
+  - [ ] 1.3 Check existing ⚠️ REQUIRED
+- [ ] Step 2: Confirmation 1 - Style & options ⚠️ REQUIRED
+- [ ] Step 3: Generate storyboard + characters
+- [ ] Step 4: Review outline (conditional)
+- [ ] Step 5: Generate prompts
+- [ ] Step 6: Review prompts (conditional)
+- [ ] Step 7: Generate images
+- [ ] Step 8: Merge to PDF
+- [ ] Step 9: Completion report
+```
+
+## Flow Diagram
+
+```
+Input → Preferences → Analyze → [Check Existing?] → [Confirm 1: Style + Reviews] → Storyboard → [Review Outline?] → Prompts → [Review Prompts?] → Images → PDF → Complete
+```
+
+---
+
+## Step 1: Setup & Analyze
+
+### 1.1 Load Preferences (EXTEND.md)
+
+Use Bash to check EXTEND.md existence (priority order):
+
+```bash
+# Check project-level first
+test -f .baoyu-skills/baoyu-comic/EXTEND.md && echo "project"
+
+# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
+test -f "$HOME/.baoyu-skills/baoyu-comic/EXTEND.md" && echo "user"
+```
+
+| Path | Location |
+|------|----------|
+| `.baoyu-skills/baoyu-comic/EXTEND.md` | Project directory |
+| `$HOME/.baoyu-skills/baoyu-comic/EXTEND.md` | User home |
+
+**When EXTEND.md Found** → Read, parse, **output summary to user**:
+
+```
+📋 Loaded preferences from [full path]
+├─ Watermark: [enabled/disabled] [content if enabled]
+├─ Art Style: [style name or "auto-select"]
+├─ Tone: [tone name or "auto-select"]
+├─ Layout: [layout or "auto-select"]
+├─ Language: [language or "auto-detect"]
+└─ Character presets: [count] defined
+```
+
+**MUST output this summary** so user knows their current configuration. Do not skip or silently load.
+
+**When EXTEND.md Not Found** → First-time setup:
+
+1. Inform user: "No preferences found. Let's set up your defaults."
+2. Use AskUserQuestion to collect preferences (see `config/first-time-setup.md`)
+3. Create EXTEND.md at user-chosen location
+4. Confirm: "✓ Preferences saved to [path]"
+
+**EXTEND.md Supports**: Watermark | Preferred art/tone/layout | Custom style definitions | Character presets | Language preference
+
+Schema: `config/preferences-schema.md`
+
+**Important**: Once EXTEND.md exists, watermark, language, and style defaults are NOT asked again in Confirmation 1 or 2. These are session-persistent settings.
+
+### 1.2 Analyze Content → `analysis.md`
+
+Read source content, save it if needed, and perform deep analysis.
+
+**Actions**:
+1. **Save source content** (if not already a file):
+   - If user provides a file path: use as-is
+   - If user pastes content: save to `source.md` in target directory
+   - **Backup rule**: If `source.md` exists, rename to `source-backup-YYYYMMDD-HHMMSS.md`
+2. Read source content
+3. **Deep analysis** following `analysis-framework.md`:
+   - Target audience identification
+   - Value proposition for readers
+   - Core themes and narrative potential
+   - Key figures and their story arcs
+4. Detect source language
+5. **Determine language**:
+   - If EXTEND.md has `language` → use it
+   - Else if `--lang` option provided → use it
+   - Else → use detected source language
+6. Determine recommended page count:
+   - Short story: 5-8 pages
+   - Medium complexity: 9-15 pages
+   - Full biography: 16-25 pages
+7. Analyze content signals for art/tone/layout recommendations
+8. **Save to `analysis.md`**
+
+**analysis.md Format**: YAML front matter (title, topic, time_span, source_language, user_language, aspect_ratio, recommended_page_count, recommended_art, recommended_tone) + sections for Target Audience, Value Proposition, Core Themes, Key Figures & Story Arcs, Content Signals, Recommended Approaches. See `analysis-framework.md` for full template.
+
+### 1.3 Check Existing Content ⚠️ REQUIRED
+
+**MUST execute before proceeding to Step 2.**
+
+Use Bash to check if output directory exists:
+
+```bash
+test -d "comic/{topic-slug}" && echo "exists"
+```
+
+**If directory exists**, use AskUserQuestion:
+
+```
+header: "Existing"
+question: "Existing content found. How to proceed?"
+options:
+  - label: "Regenerate storyboard"
+    description: "Keep images, regenerate storyboard and characters only"
+  - label: "Regenerate images"
+    description: "Keep storyboard, regenerate images only"
+  - label: "Backup and regenerate"
+    description: "Backup to {slug}-backup-{timestamp}, then regenerate all"
+  - label: "Exit"
+    description: "Cancel, keep existing content unchanged"
+```
+
+Save result and handle accordingly:
+- **Regenerate storyboard**: Skip to Step 3, preserve `prompts/` and images
+- **Regenerate images**: Skip to Step 7, use existing prompts
+- **Backup and regenerate**: Move directory, start fresh from Step 2
+- **Exit**: End workflow immediately
+
+---
+
+## Step 2: Confirmation 1 - Style & Options ⚠️
+
+**Purpose**: Select visual style + decide whether to review outline before generation. **Do NOT skip.**
+
+**Note**: Watermark and language already configured in EXTEND.md (Step 1).
+
+**Display summary**:
+- Content type + topic identified
+- Key figures extracted
+- Time span detected
+- Recommended page count
+- Language: [from EXTEND.md or detected]
+- **Recommended style**: [art] + [tone] (based on content signals)
+
+**Use AskUserQuestion** for:
+
+### Question 1: Visual Style
+
+If a preset is recommended (see `auto-selection.md`), show it first:
+
+```
+header: "Style"
+question: "Which visual style for this comic?"
+options:
+  - label: "[preset name] preset (Recommended)"       # If preset recommended
+    description: "[preset description] - includes special rules"
+  - label: "[recommended art] + [recommended tone] (Recommended)"  # If no preset
+    description: "Best match for your content based on analysis"
+  - label: "ligne-claire + neutral"
+    description: "Classic educational, Logicomix style"
+  - label: "ohmsha preset"
+    description: "Educational manga with visual metaphors, gadgets, NO talking heads"
+  - label: "Custom"
+    description: "Specify your own art + tone or preset"
+```
+
+**Preset vs Art+Tone**: Presets include special rules beyond art+tone. `ohmsha` = manga + neutral + visual metaphor rules + character roles + NO talking heads. Plain `manga + neutral` does NOT include these rules.
+
+### Question 2: Narrative Focus (multiSelect: true)
+
+```
+header: "Focus"
+question: "What should the comic emphasize? (Select all that apply)"
+options:
+  - label: "Biography/life story"
+    description: "Follow a person's journey through key life events"
+  - label: "Concept explanation"
+    description: "Break down complex ideas visually"
+  - label: "Historical event"
+    description: "Dramatize important historical moments"
+  - label: "Tutorial/how-to"
+    description: "Step-by-step educational guide"
+```
+
+### Question 3: Target Audience
+
+```
+header: "Audience"
+question: "Who is the primary reader?"
+options:
+  - label: "General readers"
+    description: "Broad appeal, accessible content"
+  - label: "Students/learners"
+    description: "Educational focus, clear explanations"
+  - label: "Industry professionals"
+    description: "Technical depth, domain knowledge"
+  - label: "Children/young readers"
+    description: "Simplified language, engaging visuals"
+```
+
+### Question 4: Outline Review
+
+```
+header: "Review"
+question: "Do you want to review the outline before image generation?"
+options:
+  - label: "Yes, let me review (Recommended)"
+    description: "Review storyboard and characters before generating images"
+  - label: "No, generate directly"
+    description: "Skip outline review, start generating immediately"
+```
+
+### Question 5: Prompt Review
+
+```
+header: "Prompts"
+question: "Review prompts before generating images?"
+options:
+  - label: "Yes, review prompts (Recommended)"
+    description: "Review image generation prompts before generating"
+  - label: "No, skip prompt review"
+    description: "Proceed directly to image generation"
+```
+
+**After response**:
+1. Update `analysis.md` with user preferences
+2. **Store `skip_outline_review`** flag based on Question 4 response
+3. **Store `skip_prompt_review`** flag based on Question 5 response
+4. → Step 3
+
+---
+
+## Step 3: Generate Storyboard + Characters
+
+Create storyboard and character definitions using the confirmed style from Step 2.
+
+**Loading Style References**:
+- Art style: `art-styles/{art}.md`
+- Tone: `tones/{tone}.md`
+- If preset (ohmsha/wuxia/shoujo): also load `presets/{preset}.md`
+
+**Generate**:
+
+1. **Storyboard** (`storyboard.md`):
+   - YAML front matter with art_style, tone, layout, aspect_ratio
+   - Cover design
+   - Each page: layout, panel breakdown, visual prompts
+   - **Written in user's preferred language** (from Step 1)
+   - Reference: `storyboard-template.md`
+   - **If using preset**: Load and apply preset rules from `presets/`
+
+2. **Character definitions** (`characters/characters.md`):
+   - Visual specs matching the art style (in user's preferred language)
+   - Include Reference Sheet Prompt for later image generation
+   - Reference: `character-template.md`
+   - **If using ohmsha preset**: Use default Doraemon characters (see below)
+
+**Ohmsha Default Characters** (use these unless user specifies `--characters`):
+
+| Role | Character | Visual Description |
+|------|-----------|-------------------|
+| Student | 大雄 (Nobita) | Japanese boy, 10yo, round glasses, black hair parted in middle, yellow shirt, navy shorts |
+| Mentor | 哆啦A梦 (Doraemon) | Round blue robot cat, big white eyes, red nose, whiskers, white belly with 4D pocket, golden bell, no ears |
+| Challenge | 胖虎 (Gian) | Stocky boy, rough features, small eyes, orange shirt |
+| Support | 静香 (Shizuka) | Cute girl, black short hair, pink dress, gentle expression |
+
+These are the canonical ohmsha-style characters. Do NOT create custom characters for ohmsha unless explicitly requested.
+
+**After generation**:
+- If `skip_outline_review` is true → Skip Step 4, go directly to Step 5
+- If `skip_outline_review` is false → Continue to Step 4
+
+---
+
+## Step 4: Review Outline (Conditional)
+
+**Skip this step** if user selected "No, generate directly" in Step 2.
+
+**Purpose**: User reviews and confirms storyboard + characters before generation.
+
+**Display**:
+- Page count and structure
+- Art style + Tone combination
+- Page-by-page summary (Cover → P1 → P2...)
+- Character list with brief descriptions
+
+**Use AskUserQuestion**:
+
+```
+header: "Confirm"
+question: "Ready to generate images with this outline?"
+options:
+  - label: "Yes, proceed (Recommended)"
+    description: "Generate character sheet and comic pages"
+  - label: "Edit storyboard first"
+    description: "I'll modify storyboard.md before continuing"
+  - label: "Edit characters first"
+    description: "I'll modify characters/characters.md before continuing"
+  - label: "Edit both"
+    description: "I'll modify both files before continuing"
+```
+
+**After response**:
+1. If user wants to edit → Wait for user to finish editing, then ask again
+2. If user confirms → Continue to Step 5
+
+---
+
+## Step 5: Generate Prompts
+
+Create image generation prompts for all pages.
+
+**Style Reference Loading**:
+- Read `art-styles/{art}.md` for rendering guidelines
+- Read `tones/{tone}.md` for mood/color adjustments
+- If preset: Read `presets/{preset}.md` for special rules
+
+**For each page (cover + pages)**:
+1. Create prompt following art style + tone guidelines
+2. Include character visual descriptions for consistency
+3. Save to `prompts/NN-{cover|page}-[slug].md`
+   - **Backup rule**: If prompt file exists, rename to `prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`
+
+**Prompt File Format**:
+```markdown
+# Page NN: [Title]
+
+## Visual Style
+Art: [art style] | Tone: [tone] | Layout: [layout type]
+
+## Character Reference
+[Character descriptions from characters/characters.md]
+
+## Panel Breakdown
+[From storyboard.md - panel descriptions, actions, dialogue]
+
+## Generation Prompt
+[Combined prompt for image generation skill]
+```
+
+**Watermark Application** (if enabled in preferences):
+Add to each prompt:
+```
+Include a subtle watermark "[content]" positioned at [position]
+with approximately [opacity*100]% visibility. The watermark should
+be legible but not distracting from the comic panels and storytelling.
+Ensure watermark does not overlap speech bubbles or key action.
+```
+Reference: `config/watermark-guide.md`
+
+**After generation**:
+- If `skip_prompt_review` is true → Skip Step 6, go directly to Step 7
+- If `skip_prompt_review` is false → Continue to Step 6
+
+---
+
+## Step 6: Review Prompts (Conditional)
+
+**Skip this step** if user selected "No, skip prompt review" in Step 2.
+
+**Purpose**: User reviews and confirms prompts before image generation.
+
+**Display prompt summary table**:
+
+| Page | Title | Key Elements |
+|------|-------|--------------|
+| Cover | [title] | [main visual] |
+| P1 | [title] | [key elements] |
+| ... | ... | ... |
+
+**Use AskUserQuestion**:
+
+```
+header: "Confirm"
+question: "Ready to generate images with these prompts?"
+options:
+  - label: "Yes, proceed (Recommended)"
+    description: "Generate all comic page images"
+  - label: "Edit prompts first"
+    description: "I'll modify prompts/*.md before continuing"
+  - label: "Regenerate prompts"
+    description: "Regenerate all prompts with different approach"
+```
+
+**After response**:
+1. If user wants to edit → Wait for user to finish editing, then ask again
+2. If user wants to regenerate → Go back to Step 5
+3. If user confirms → Continue to Step 7
+
+---
+
+## Step 7: Generate Images
+
+With confirmed prompts from Step 5/6:
+
+### 7.1 Generate Character Reference Sheet (first)
+
+1. Use Reference Sheet Prompt from `characters/characters.md`
+2. **Backup rule**: If `characters/characters.png` exists, rename to `characters/characters-backup-YYYYMMDD-HHMMSS.png`
+3. Generate → `characters/characters.png`
+4. This ensures visual consistency for all subsequent pages
+
+### 7.2 Generate Comic Pages
+
+**CRITICAL: Character Reference is MANDATORY** for visual consistency across all pages.
+
+**Before generating any page**:
+1. Read the image generation skill's SKILL.md
+2. Check if it supports reference image input (`--ref`, `--reference`, etc.)
+3. Choose the appropriate strategy below
+
+**Character Reference Strategy**:
+
+| Skill Capability | Strategy | Action |
+|------------------|----------|--------|
+| Supports `--ref` | **Strategy A** | Pass `characters/characters.png` with EVERY page |
+| Does NOT support `--ref` | **Strategy B** | Prepend character descriptions to EVERY prompt |
+
+**Strategy A: Using `--ref` parameter** (e.g., baoyu-image-gen)
+
+```bash
+# Each page generation MUST include --ref
+npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
+  --promptfiles prompts/01-page-xxx.md \
+  --image 01-page-xxx.png \
+  --ar 3:4 \
+  --ref characters/characters.png
+```
+
+**Strategy B: Embedding character descriptions in prompt**
+
+When skill does NOT support reference images, create combined prompt files:
+
+```markdown
+# prompts/01-page-xxx.md (with embedded character reference)
+
+## Character Reference (maintain consistency)
+[Copy relevant sections from characters/characters.md here]
+- 大雄: Japanese boy, round glasses, yellow shirt, navy shorts...
+- 哆啦A梦: Round blue robot cat, white belly, red nose, golden bell...
+
+## Page Content
+[Original page prompt here]
+```
+
+**For each page (cover + pages)**:
+1. Read prompt from `prompts/NN-{cover|page}-[slug].md`
+2. **Backup rule**: If image file exists, rename to `NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`
+3. Generate image using Strategy A or B (based on skill capability)
+4. Save to `NN-{cover|page}-[slug].png`
+5. Report progress after each generation: "Generated X/N: [page title]"
+
+**Session Management**:
+If image generation skill supports `--sessionId`:
+1. Generate unique session ID: `comic-{topic-slug}-{timestamp}`
+2. Use same session ID for all pages
+3. Ensures visual consistency across generated images
+
+---
+
+## Step 8: Merge to PDF
+
+After all images generated:
+
+```bash
+npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts <comic-dir>
+```
+
+Creates `{topic-slug}.pdf` with all pages as full-page images.
+
+---
+
+## Step 9: Completion Report
+
+```
+Comic Complete!
+Title: [title] | Art: [art] | Tone: [tone] | Pages: [count] | Aspect: [ratio] | Language: [lang]
+Watermark: [enabled/disabled]
+Location: [path]
+✓ analysis.md
+✓ characters.png
+✓ 00-cover-[slug].png ... NN-page-[slug].png
+✓ {topic-slug}.pdf
+```
+
+---
+
+## Page Modification
+
+| Action | Steps |
+|--------|-------|
+| **Edit** | Update prompt → Regenerate image → Regenerate PDF |
+| **Add** | Create prompt at position → Generate image → Renumber subsequent (NN+1) → Update storyboard → Regenerate PDF |
+| **Delete** | Remove files → Renumber subsequent (NN-1) → Update storyboard → Regenerate PDF |
+
+**File naming**: `NN-{cover|page}-[slug].png` (e.g., `03-page-enigma-machine.png`)
+- Slugs: kebab-case, unique, derived from content
+- Renumbering: Update NN prefix only, slugs unchanged
@@ -1,188 +1,89 @@
 ---
 name: baoyu-compress-image
-description: Cross-platform image compression skill. Converts images to WebP by default with PNG-to-PNG support. Uses system tools (sips, cwebp, ImageMagick) with Sharp fallback.
+description: Compresses images to WebP (default) or PNG with automatic tool selection. Use when user asks to "compress image", "optimize image", "convert to webp", or reduce image file size.
 ---

 # Image Compressor

-Cross-platform image compression with WebP default output, PNG-to-PNG support, preferring system tools with Sharp fallback.
+Compresses images using best available tool (sips → cwebp → ImageMagick → Sharp).

 ## Script Directory

-**Important**: All scripts are located in the `scripts/` subdirectory of this skill.
+Scripts in `scripts/` subdirectory. Replace `${SKILL_DIR}` with this SKILL.md's directory path.

-**Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
-3. Replace all `${SKILL_DIR}` in this document with the actual path
-
-**Script Reference**:
 | Script | Purpose |
 |--------|---------|
-| `scripts/main.ts` | CLI entry point for image compression |
+| `scripts/main.ts` | Image compression CLI |

-## Quick Start
+## Preferences (EXTEND.md)
+
+Use Bash to check EXTEND.md existence (priority order):

 ```bash
-# Compress to WebP (default)
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png
+# Check project-level first
+test -f .baoyu-skills/baoyu-compress-image/EXTEND.md && echo "project"

-# Keep original format (PNG → PNG)
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --format png
-
-# Custom quality
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -q 75
-
-# Process directory
-npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r
+# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
+test -f "$HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md" && echo "user"
 ```

-## Commands
+┌────────────────────────────────────────────────────────┬───────────────────┐
+│                          Path                          │     Location      │
+├────────────────────────────────────────────────────────┼───────────────────┤
+│ .baoyu-skills/baoyu-compress-image/EXTEND.md           │ Project directory │
+├────────────────────────────────────────────────────────┼───────────────────┤
+│ $HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md     │ User home         │
+└────────────────────────────────────────────────────────┴───────────────────┘

-### Single File Compression
+┌───────────┬───────────────────────────────────────────────────────────────────────────┐
+│  Result   │                                  Action                                   │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Found     │ Read, parse, apply settings                                               │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Not found │ Use defaults                                                              │
+└───────────┴───────────────────────────────────────────────────────────────────────────┘
+
+**EXTEND.md Supports**: Default format | Default quality | Keep original preference
+
+## Usage

 ```bash
-# Basic (converts to WebP, replaces original)
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png
-
-# Custom output path
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -o compressed.webp
-
-# Keep original file
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --keep
-
-# Custom quality (0-100, default: 80)
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -q 75
-
-# Keep original format
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -f png
-```
-
-### Directory Processing
-
-```bash
-# Process all images in directory
-npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/
-
-# Recursive processing
-npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r
-
-# With custom quality
-npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r -q 75
-```
-
-### Output Formats
-
-```bash
-# Plain text (default)
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png
-
-# JSON output
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --json
+npx -y bun ${SKILL_DIR}/scripts/main.ts <input> [options]
 ```

 ## Options

 | Option | Short | Description | Default |
 |--------|-------|-------------|---------|
-| `<input>` | | Input file or directory | Required |
-| `--output <path>` | `-o` | Output path | Same path, new extension |
-| `--format <fmt>` | `-f` | webp, png, jpeg | webp |
-| `--quality <n>` | `-q` | Quality 0-100 | 80 |
-| `--keep` | `-k` | Keep original file | false |
-| `--recursive` | `-r` | Process directories recursively | false |
+| `<input>` | | File or directory | Required |
+| `--output` | `-o` | Output path | Same path, new ext |
+| `--format` | `-f` | webp, png, jpeg | webp |
+| `--quality` | `-q` | Quality 0-100 | 80 |
+| `--keep` | `-k` | Keep original | false |
+| `--recursive` | `-r` | Process subdirs | false |
 | `--json` | | JSON output | false |
-| `--help` | `-h` | Show help | |

-## Compressor Selection
+## Examples

-Priority order (auto-detected):
+```bash
+# Single file → WebP (replaces original)
+npx -y bun ${SKILL_DIR}/scripts/main.ts image.png

-1. **sips** (macOS built-in, WebP support since macOS 11)
-2. **cwebp** (Google's official WebP tool)
-3. **ImageMagick** (`convert` command)
-4. **Sharp** (npm package, auto-installed by Bun)
+# Keep PNG format
+npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -f png --keep

-The skill automatically selects the best available compressor.
+# Directory recursive
+npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r -q 75

-## Output Format
-
-### Text Mode (default)
+# JSON output
+npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --json
+```

+**Output**:
 ```
 image.png → image.webp (245KB → 89KB, 64% reduction)
 ```

-### JSON Mode
-
-```json
-{
-  "input": "image.png",
-  "output": "image.webp",
-  "inputSize": 250880,
-  "outputSize": 91136,
-  "ratio": 0.36,
-  "compressor": "sips"
-}
-```
-
-### Directory JSON Mode
-
-```json
-{
-  "files": [...],
-  "summary": {
-    "totalFiles": 10,
-    "totalInputSize": 2508800,
-    "totalOutputSize": 911360,
-    "ratio": 0.36,
-    "compressor": "sips"
-  }
-}
-```
-
-## Examples
-
-### Compress single image
-
-```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts photo.png
-# photo.png → photo.webp (1.2MB → 340KB, 72% reduction)
-```
-
-### Compress with custom quality
-
-```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts photo.png -q 60
-# photo.png → photo.webp (1.2MB → 280KB, 77% reduction)
-```
-
-### Keep original format
-
-```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts screenshot.png -f png --keep
-# screenshot.png → screenshot-compressed.png (500KB → 380KB, 24% reduction)
-```
-
-### Process entire directory
-
-```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts ./screenshots/ -r
-# Processed 15 files: 12.5MB → 4.2MB (66% reduction)
-```
-
-### Get JSON for scripting
-
-```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --json | jq '.ratio'
-```
-
 ## Extension Support

-Custom configurations via EXTEND.md.
-
-**Check paths** (priority order):
-1. `.baoyu-skills/baoyu-compress-image/EXTEND.md` (project)
-2. `~/.baoyu-skills/baoyu-compress-image/EXTEND.md` (user)
-
-If found, load before workflow. Extension content overrides defaults.
+Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.
@@ -147,7 +147,9 @@ async function processFile(
  const outputSize = statSync(tempOutput).size;

  if (!opts.keep && absInput !== output) {
-    unlinkSync(absInput);
+    const ext = extname(absInput);
+    const base = absInput.slice(0, -ext.length);
+    renameSync(absInput, `${base}_original${ext}`);
  }
  renameSync(tempOutput, output);

@@ -1,285 +1,497 @@
 ---
 name: baoyu-cover-image
-description: Generate elegant cover images for articles. Analyzes content and creates eye-catching hand-drawn style cover images with multiple style options. Use when user asks to "generate cover image", "create article cover", or "make a cover for article".
+description: Generates article cover images with 5 dimensions (type, palette, rendering, text, mood) combining 9 color palettes and 6 rendering styles. Supports cinematic (2.35:1), widescreen (16:9), and square (1:1) aspects. Use when user asks to "generate cover image", "create article cover", or "make cover".
 ---

 # Cover Image Generator

-Generate hand-drawn style cover images for articles with multiple style options.
+Generate elegant cover images for articles with 5-dimensional customization.

 ## Usage

 ```bash
-# From markdown file (auto-select style based on content)
+# Auto-select all dimensions based on content
 /baoyu-cover-image path/to/article.md

-# Specify a style
-/baoyu-cover-image path/to/article.md --style blueprint
-/baoyu-cover-image path/to/article.md --style warm
-/baoyu-cover-image path/to/article.md --style dark-atmospheric
+# Quick mode: skip confirmation, use auto-selection
+/baoyu-cover-image article.md --quick

-# Without title text
-/baoyu-cover-image path/to/article.md --no-title
+# Specify dimensions (new 5D system)
+/baoyu-cover-image article.md --type conceptual --palette warm --rendering flat-vector
+/baoyu-cover-image article.md --text title-subtitle --mood bold

-# Combine options
-/baoyu-cover-image path/to/article.md --style minimal --no-title
+# Style presets (backward-compatible shorthand for palette + rendering)
+/baoyu-cover-image article.md --style blueprint
+/baoyu-cover-image article.md --style blueprint --rendering hand-drawn  # override rendering

-# From direct text input
+# Visual only (no title text)
+/baoyu-cover-image article.md --no-title
+
+# Direct content input
 /baoyu-cover-image
-[paste content or describe the topic]
-
-# Direct input with style
-/baoyu-cover-image --style playful
 [paste content]
+
+# Direct input with options
+/baoyu-cover-image --palette mono --rendering digital --aspect 1:1 --quick
+[paste content]
+
+# With reference images
+/baoyu-cover-image article.md --ref style-ref.png
+/baoyu-cover-image article.md --ref ref1.png ref2.png --quick
 ```

 ## Options

 | Option | Description |
 |--------|-------------|
-| `--style <name>` | Specify cover style (see Style Gallery below) |
-| `--aspect <ratio>` | Aspect ratio: 2.35:1 (cinematic, default), 16:9 (widescreen), 1:1 (social) |
-| `--lang <code>` | Output language for title text (en, zh, ja, etc.) |
-| `--no-title` | Generate cover without title text (visual only) |
+| `--type <name>` | Cover type: hero, conceptual, typography, metaphor, scene, minimal |
+| `--palette <name>` | Color palette: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro |
+| `--rendering <name>` | Rendering style: flat-vector, hand-drawn, painterly, digital, pixel, chalk |
+| `--style <name>` | Preset shorthand (expands to palette + rendering, see [Style Presets](references/style-presets.md)) |
+| `--text <level>` | Text density: none, title-only, title-subtitle, text-rich |
+| `--mood <level>` | Emotional intensity: subtle, balanced, bold |
+| `--aspect <ratio>` | 16:9 (default), 2.35:1, 4:3, 3:2, 1:1, 3:4 |
+| `--lang <code>` | Title language (en, zh, ja, etc.) |
+| `--no-title` | Alias for `--text none` |
+| `--quick` | Skip confirmation, use auto-selection for missing dimensions |
+| `--ref <files...>` | Reference images for style/composition guidance |

-## Style Gallery
+## Five Dimensions

-| Style | Description |
-|-------|-------------|
-| `elegant` (Default) | Refined, sophisticated, understated |
-| `flat-doodle` | Bold outlines, pastel colors, cute rounded shapes |
-| `blueprint` | Technical schematics, engineering precision |
-| `bold-editorial` | Magazine cover impact, dramatic typography |
-| `chalkboard` | Black chalkboard, colorful chalk drawings |
-| `dark-atmospheric` | Cinematic dark mode, glowing accents |
-| `editorial-infographic` | Magazine explainer, visual storytelling |
-| `fantasy-animation` | Ghibli/Disney inspired, whimsical charm |
-| `intuition-machine` | Technical briefing, bilingual labels |
-| `minimal` | Ultra-clean, zen-like, focused |
-| `nature` | Organic, calm, earthy |
-| `notion` | Clean SaaS dashboard, productivity styling |
-| `pixel-art` | Retro 8-bit, nostalgic gaming aesthetic |
-| `playful` | Fun, creative, whimsical |
-| `retro` | Halftone dots, vintage badges, classic |
-| `sketch-notes` | Hand-drawn, educational, warm |
-| `vector-illustration` | Flat vector, black outlines, retro colors |
-| `vintage` | Aged paper, historical, expedition style |
-| `warm` | Friendly, approachable, human-centered |
-| `watercolor` | Soft hand-painted, natural warmth |
+| Dimension | Controls | Values | Default |
+|-----------|----------|--------|---------|
+| **Type** | Visual composition, information structure | hero, conceptual, typography, metaphor, scene, minimal | auto |
+| **Palette** | Colors, color scheme, decorative hints | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro | auto |
+| **Rendering** | Line quality, texture, depth, element style | flat-vector, hand-drawn, painterly, digital, pixel, chalk | auto |
+| **Text** | Text density, information hierarchy | none, title-only, title-subtitle, text-rich | title-only |
+| **Mood** | Emotional intensity, visual weight | subtle, balanced, bold | balanced |

-Detailed style definitions: `references/styles/<style>.md`
+Dimensions can be freely combined. Auto-selection rules: [references/auto-selection.md](references/auto-selection.md)

-## Auto Style Selection
+## Type Gallery

-When no `--style` is specified, the system analyzes content to select the best style:
+| Type | Description | Best For |
+|------|-------------|----------|
+| `hero` | Large visual impact, title overlay | Product launch, brand promotion, major announcements |
+| `conceptual` | Concept visualization, abstract core ideas | Technical articles, methodology, architecture design |
+| `typography` | Text-focused layout, prominent title | Opinion pieces, quotes, insights |
+| `metaphor` | Visual metaphor, concrete expressing abstract | Philosophy, growth, personal development |
+| `scene` | Atmospheric scene, narrative feel | Stories, travel, lifestyle |
+| `minimal` | Minimalist composition, generous whitespace | Zen, focus, core concepts |

-| Content Signals | Selected Style |
-|----------------|----------------|
-| Architecture, system design, engineering | `blueprint` |
-| Product launch, keynote, marketing, brand | `bold-editorial` |
-| Education, classroom, tutorial, teaching | `chalkboard` |
-| Entertainment, creative, premium, cinematic | `dark-atmospheric` |
-| Technology explainer, science, research | `editorial-infographic` |
-| Storytelling, children, fantasy, magical | `fantasy-animation` |
-| Technical docs, academic, bilingual | `intuition-machine` |
-| Personal story, emotion, growth, life | `warm` |
-| Simple, zen, focus, essential | `minimal` |
-| Fun, easy, beginner, casual | `playful` |
-| Nature, eco, wellness, health, organic | `nature` |
-| Pop culture, 80s/90s nostalgia, badges | `retro` |
-| Product, SaaS, dashboard, productivity | `notion` |
-| Productivity, workflow, app, tools, cute | `flat-doodle` |
-| Gaming, retro tech, developer, 8-bit | `pixel-art` |
-| Educational, tutorial, knowledge sharing | `sketch-notes` |
-| Creative proposals, brand, toy-like | `vector-illustration` |
-| History, exploration, heritage, biography | `vintage` |
-| Lifestyle, travel, food, personal | `watercolor` |
-| Business, professional, strategy, analysis | `elegant` |
+Type composition details: [references/types.md](references/types.md)

-## File Management
+## Palette Gallery

-### Output Directory
+| Palette | Vibe | Primary Colors |
+|---------|------|----------------|
+| `warm` | Friendly, approachable | Orange, golden yellow, terracotta |
+| `elegant` | Sophisticated, refined | Soft coral, muted teal, dusty rose |
+| `cool` | Technical, professional | Engineering blue, navy, cyan |
+| `dark` | Cinematic, premium | Electric purple, cyan, magenta |
+| `earth` | Natural, organic | Forest green, sage, earth brown |
+| `vivid` | Energetic, bold | Bright red, neon green, electric blue |
+| `pastel` | Gentle, whimsical | Soft pink, mint, lavender |
+| `mono` | Clean, focused | Black, near-black, white |
+| `retro` | Nostalgic, vintage | Muted orange, dusty pink, maroon |

-Each session creates an independent directory named by content slug:
+Palette definitions: [references/palettes/](references/palettes/)
+
+## Rendering Gallery
+
+| Rendering | Description | Key Characteristics |
+|-----------|-------------|---------------------|
+| `flat-vector` | Clean modern vector | Uniform outlines, flat fills, geometric icons |
+| `hand-drawn` | Sketchy organic illustration | Imperfect strokes, paper texture, doodles |
+| `painterly` | Soft watercolor/paint | Brush strokes, color bleeds, soft edges |
+| `digital` | Polished modern digital | Precise edges, subtle gradients, UI components |
+| `pixel` | Retro 8-bit pixel art | Pixel grid, dithering, chunky shapes |
+| `chalk` | Chalk on blackboard | Chalk strokes, dust effects, board texture |
+
+Rendering definitions: [references/renderings/](references/renderings/)
+
+## Text & Mood
+
+| Text Level | Title | Subtitle | Tags | Use Case |
+|------------|:-----:|:--------:|:----:|----------|
+| `none` | - | - | - | Pure visual, no text |
+| `title-only` | ✓ | - | - | Simple headline (default) |
+| `title-subtitle` | ✓ | ✓ | - | Title + supporting context |
+| `text-rich` | ✓ | ✓ | ✓ (2-4) | Information-dense |
+
+| Mood | Contrast | Saturation | Weight | Use Case |
+|------|:--------:|:----------:|:------:|----------|
+| `subtle` | Low | Muted | Light | Corporate, thought leadership |
+| `balanced` | Medium | Normal | Medium | General articles (default) |
+| `bold` | High | Vivid | Heavy | Announcements, promotions |
+
+Full guides: [references/dimensions/text.md](references/dimensions/text.md) | [references/dimensions/mood.md](references/dimensions/mood.md)
+
+## Style Presets & Compatibility
+
+- **Style Presets**: `--style X` expands to palette + rendering. See [references/style-presets.md](references/style-presets.md)
+- **Compatibility Matrices**: Palette×Rendering, Type×Rendering, Type×Text, Type×Mood. See [references/compatibility.md](references/compatibility.md)
+  - ✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## File Structure
+
+Output directory depends on `default_output_dir` preference:
+
+| Preference | Output Path |
+|------------|-------------|
+| `same-dir` | `{article-dir}/` |
+| `imgs-subdir` | `{article-dir}/imgs/` |
+| `independent` (default) | `cover-image/{topic-slug}/` |
+| Pasted content | `cover-image/{topic-slug}/` (always) |

 ```
-cover-image/{topic-slug}/
+<output-dir>/
 ├── source-{slug}.{ext}    # Source files (text, images, etc.)
-├── prompts/
-│   └── cover.md
-└── cover.png
+├── refs/                  # Reference images (if provided)
+│   ├── ref-01-{slug}.{ext}
+│   ├── ref-01-{slug}.md   # Description file (optional)
+│   ├── ref-02-{slug}.{ext}
+│   ├── ref-02-{slug}.md   # Description file (optional)
+│   └── extracted-style.md # Verbally extracted style (if no file path)
+├── prompts/cover.md       # Generation prompt
+└── cover.png              # Output image
 ```

-**Slug Generation**:
-1. Extract main topic from content (2-4 words, kebab-case)
-2. Example: "The Future of AI" → `future-of-ai`
-
-### Conflict Resolution
-
-If `cover-image/{topic-slug}/` already exists:
- Append timestamp: `{topic-slug}-YYYYMMDD-HHMMSS`
- Example: `ai-future` exists → `ai-future-20260118-143052`
-
-### Source Files
-
-Copy all sources with naming `source-{slug}.{ext}`:
- `source-article.md` (main text content)
- `source-logo.png` (image from conversation)
-
-Multiple sources supported: text, images, files from conversation.
+**Slug**: Extract main topic (2-4 words, kebab-case). Example: "The Future of AI" → `future-of-ai`
+**Conflict**: If directory exists, append timestamp: `{topic-slug}-YYYYMMDD-HHMMSS`
+**Source Files**: Copy all sources with naming `source-{slug}.{ext}` (multiple supported)

 ## Workflow

+### Progress Checklist
+
+```
+Cover Image Progress:
+- [ ] Step 0: Check preferences (EXTEND.md) ⛔ BLOCKING
+  - [ ] Found → load preferences → continue
+  - [ ] Not found → run first-time setup → MUST complete before Step 1
+- [ ] Step 1: Analyze content + determine output directory
+  - [ ] 1.1 Reference images ⚠️ (if provided)
+    - [ ] File path given → saved to refs/ ✓
+    - [ ] No path → asked user OR extracted verbally
+  - [ ] 1.2 Output directory determined
+- [ ] Step 2: Confirm options (5 dimensions) ⚠️ REQUIRED unless --quick or all specified
+- [ ] Step 3: Create prompt
+  - [ ] References in prompt ONLY if files exist in refs/
+  - [ ] Extracted style/palette appended to prompt body (if no file)
+- [ ] Step 4: Generate image
+  - [ ] 4.1 References verified before generation
+  - [ ] 4.2 Pass refs via --ref if skill supports AND files exist
+- [ ] Step 5: Completion report
+```
+
+### Flow
+
+```
+Input → [Step 0: Preferences] ─┬─ Found → Continue
+                               │
+                               └─ Not found → First-Time Setup ⛔ BLOCKING
+                                              │
+                                              └─ Complete setup → Save EXTEND.md → Continue
+                                                                                      │
+        ┌───────────────────────────────────────────────────────────────────────────┘
+        ↓
+Analyze + Save Refs → [Output Dir ⚠️] → [Confirm: 5 Dimensions] → Prompt → Generate → Complete
+                                                 ↓
+                                        (skip if --quick or all specified)
+```
+
+### Step 0: Load Preferences (EXTEND.md) ⛔ BLOCKING
+
+**Purpose**: Load user preferences or run first-time setup.
+
+**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to content analysis, do NOT ask about reference images, do NOT ask about dimensions — ONLY complete the preferences setup first.
+
+Use Bash to check EXTEND.md existence (priority order):
+
+```bash
+# Check project-level first
+test -f .baoyu-skills/baoyu-cover-image/EXTEND.md && echo "project"
+
+# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
+test -f "$HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md" && echo "user"
+```
+
+| Result | Action |
+|--------|--------|
+| Found | Read, parse, display preferences summary → Continue to Step 1 |
+| Not found | ⛔ **BLOCKING**: Run first-time setup ONLY ([references/config/first-time-setup.md](references/config/first-time-setup.md)) → Complete and save EXTEND.md → Then continue to Step 1 |
+
+**Preferences Summary** (when found):
+
+```
+Preferences loaded from [project/user]:
+• Watermark: [enabled/disabled] [content if enabled]
+• Type/Palette/Rendering: [value or "auto"]
+• Text: [value or "title-only"] | Mood: [value or "balanced"]
+• Aspect: [default_aspect] | Output: [dir or "not set — will ask in Step 1.5"]
+• Quick mode: [enabled/disabled] | Language: [value or "auto"]
+```
+
+**EXTEND.md Supports**: Watermark | Preferred type | Preferred palette | Preferred rendering | Preferred text | Preferred mood | Default aspect ratio | Default output directory | Quick mode | Custom palette definitions | Language preference
+
+Schema: [references/config/preferences-schema.md](references/config/preferences-schema.md)
+
 ### Step 1: Analyze Content

-1. **Save source content** (if not already a file):
-   - If user provides a file path: use as-is
-   - If user pastes content: save to `source.md` in target directory
+**1.0 Detect & Save Reference Images** ⚠️ REQUIRED if images provided

-2. **Extract key information**:
-   - **Main topic**: What is the article about?
-   - **Core message**: What's the key takeaway?
-   - **Tone**: Serious, playful, inspiring, educational?
-   - **Keywords**: Identify style-signaling words
+Check if user provided reference images. Handle based on input type:

-3. **Language detection**:
-   - Detect **source language** from content
-   - Detect **user language** from conversation context
-   - Note if source_language ≠ user_language (will ask in Step 3)
+| Input Type | Action |
+|------------|--------|
+| Image file path provided | Copy to `refs/` subdirectory → can use `--ref` |
+| Image in conversation (no path) | **ASK user for file path** with AskUserQuestion |
+| User can't provide path | Extract style/palette verbally → append to prompt (NO frontmatter references) |

-### Step 2: Determine Options
+**CRITICAL**: Only add `references` to prompt frontmatter if files are ACTUALLY SAVED to `refs/` directory.

-1. **Style selection**:
-   - If `--style` specified, use that style
-   - Otherwise, scan content for style signals and auto-select 3 candidates
-   - Default to `elegant` if no clear signals
+**If user provides file path**:
+1. Copy to `refs/ref-NN-{slug}.{ext}` (NN = 01, 02, ...)
+2. Create description: `refs/ref-NN-{slug}.md`
+3. Verify files exist before proceeding

-2. **Aspect ratio**:
-   - If `--aspect` specified, use that ratio
-   - Otherwise, prepare options: 2.35:1 (cinematic), 16:9 (widescreen), 1:1 (social)
+**If user can't provide path** (extracted verbally):
+1. Analyze image visually, extract: colors, style, composition
+2. Create `refs/extracted-style.md` with extracted info
+3. DO NOT add `references` to prompt frontmatter
+4. Instead, append extracted style/colors directly to prompt text

-### Step 3: Confirm Options
+**Description File Format** (only when file saved):
+```yaml
+---
+ref_id: NN
+filename: ref-NN-{slug}.{ext}
+usage: direct | style | palette
+---
+[User's description or auto-generated description]
+```

-**Purpose**: Let user confirm all options in a single step before generation.
+| Usage | When to Use |
+|-------|-------------|
+| `direct` | Reference matches desired output closely |
+| `style` | Extract visual style characteristics only |
+| `palette` | Extract color scheme only |

-**IMPORTANT**: Present ALL options in a single confirmation step using AskUserQuestion. Do NOT interrupt workflow with multiple separate confirmations.
+**Verification** (only for saved files):
+```
+Reference Images Saved:
+- ref-01-{slug}.png ✓ (can use --ref)
+- ref-02-{slug}.png ✓ (can use --ref)
+```

-**Determine which questions to ask**:
+**Or for extracted style**:
+```
+Reference Style Extracted (no file):
+- Colors: #E8756D coral, #7ECFC0 mint...
+- Style: minimal flat vector, clean lines...
+→ Will append to prompt text (not --ref)
+```

-| Question | When to Ask |
+---
+
+**1.1 Save Source Content**
+- If pasted, save to `source.md` in target directory; if file path, use as-is
+- **Backup rule**: If `source.md` exists, rename to `source-backup-YYYYMMDD-HHMMSS.md`
+
+**1.2 Content Analysis**
+- Extract topic, core message, tone, keywords
+- Identify visual metaphors
+- Detect content type
+
+**1.3 Reference Image Analysis** (if provided in Step 1.0)
+
+For each reference image:
+
+| Analysis | Description |
 |----------|-------------|
-| Style | Always (required) |
-| Aspect ratio | Always (offer common options) |
-| Language | Only if `source_language ≠ user_language` |
+| Visual characteristics | Style, colors, composition |
+| Content/subject | What the reference depicts |
+| Style match | Which type/palette/rendering align |
+| Usage recommendation | `direct` / `style` / `palette` |

-**Present options** (use AskUserQuestion with all applicable questions):
+**1.4 Language Detection**
+- Detect source language
+- Note user's input language
+- Compare with EXTEND.md preference

-**Question 1 (Style)** - always:
- Style A (recommended): [style name] - [brief description]
- Style B: [style name] - [brief description]
- Style C: [style name] - [brief description]
- Custom: Provide custom style reference
+**1.5 Determine Output Directory**
+- Per File Structure rules
+- If no `default_output_dir` preference + file path input, include in Step 2 Q4

-**Question 2 (Aspect)** - always:
- 2.35:1 Cinematic (Recommended) - ultra-wide, dramatic
- 16:9 Widescreen - standard video/presentation
- 1:1 Square - social media optimized
+### Step 2: Confirm Options ⚠️

-**Question 3 (Language)** - only if source ≠ user language:
- [Source language] (matches content)
- [User language] (your preference)
+Validate all 5 dimensions + aspect ratio. Full confirmation flow: [references/workflow/confirm-options.md](references/workflow/confirm-options.md)

-**Language handling**:
- If source language = user language: Just inform user (e.g., "Title will be in Chinese")
- If different: Ask which language to use for title text
+**Skip Conditions**:

-### Step 4: Generate Cover Concept
+| Condition | Skipped | Still Asked |
+|-----------|---------|-------------|
+| `--quick` or `quick_mode: true` | 5 dimensions | Aspect ratio (unless `--aspect`) |
+| All 5 + `--aspect` specified | All | None |

-Create a cover image concept based on selected style:
+### Step 3: Create Prompt

-**Title** (if included, max 8 characters):
- Distill the core message into a punchy headline
- Use hooks: numbers, questions, contrasts, pain points
- Skip if `--no-title` flag is used
+**Backup rule**: If `prompts/cover.md` exists, rename to `prompts/cover-backup-YYYYMMDD-HHMMSS.md`

-**Visual Elements**:
- Style-appropriate imagery and icons
- 1-2 symbolic elements representing the topic
- Metaphors or analogies that fit the style
+Save to `prompts/cover.md`. Full template: [references/workflow/prompt-template.md](references/workflow/prompt-template.md)

-### Step 5: Create Prompt File
+**CRITICAL - References in YAML Frontmatter**:

-Save prompt to `prompts/cover.md` with confirmed options.
+When reference files are saved to `refs/`, **MUST add `references` field in frontmatter**:

-**All prompts are written in the user's confirmed language preference.**
-
-**Prompt Format**:
-
-```markdown
-Cover theme: [topic in 2-3 words]
-Style: [selected style name]
-Aspect ratio: [confirmed aspect ratio]
-
-[If title included:]
-Title text: [8 characters or less, in confirmed language]
-Subtitle: [optional, in confirmed language]
-
-Visual composition:
- Main visual: [description matching style]
- Layout: [positioning based on title inclusion and aspect ratio]
- Decorative elements: [style-appropriate elements]
-
-Color scheme:
- Primary: [style primary color]
- Background: [style background color]
- Accent: [style accent color]
-
-Style notes: [specific style characteristics to emphasize]
-
-[If no title:]
-Note: No title text, pure visual illustration only.
+```yaml
+---
+type: cover
+palette: warm
+rendering: flat-vector
+references:
+  - ref_id: 01
+    filename: refs/ref-01-podcast-thumbnail.jpg
+    usage: style
+---
 ```

-### Step 6: Generate Image
+| Rule | Action |
+|------|--------|
+| Files saved to `refs/` | Add to frontmatter `references` list |
+| Style extracted verbally (no file) | Omit `references` field, describe in body |
+| Before writing | Verify: `test -f refs/ref-NN-{slug}.{ext}` |

-**Image Generation Skill Selection**:
-1. Check available image generation skills
-2. If multiple skills available, ask user to choose
+**Reference Embedding**:

-**Generation**:
-Call selected image generation skill with prompt file, output path, and confirmed aspect ratio.
+| Situation | Frontmatter | Body |
+|-----------|-------------|------|
+| Reference file saved to `refs/` | Add to `references` ✓ | Brief style note |
+| Style extracted verbally (no file) | Omit `references` | Full style description |
+| File in frontmatter but doesn't exist | ERROR - fix or remove | — |

-### Step 7: Output Summary
+### Step 4: Generate Image
+
+**4.1 Backup existing** `cover.png` → `cover-backup-YYYYMMDD-HHMMSS.png` (if regenerating)
+
+**4.2 Check available image generation skills**; if multiple, ask user preference
+
+**4.3 Process References** ⚠️ REQUIRED if references in frontmatter
+
+**Read `references` from prompt frontmatter** and process each entry:
+
+1. **Parse frontmatter** to get references list:
+   ```yaml
+   references:
+     - ref_id: 01
+       filename: refs/ref-01-podcast-thumbnail.jpg
+       usage: style
+   ```
+
+2. **VERIFY each file exists**:
+   ```bash
+   test -f refs/ref-NN-{slug}.{ext} && echo "exists" || echo "MISSING"
+   ```
+   - If file MISSING → ERROR, fix prompt or remove from references
+   - If file exists → proceed with processing
+
+3. Process based on `usage` type:
+
+| Usage | Action | Example |
+|-------|--------|---------|
+| `direct` | Add reference path to `--ref` parameter | `--ref refs/ref-01-brand.png` |
+| `style` | Analyze reference, append style traits to prompt | "Style: clean lines, gradient backgrounds..." |
+| `palette` | Extract colors from reference, append to prompt | "Colors: #E8756D coral, #7ECFC0 mint..." |
+
+3. Check image generation skill capability:
+
+| Skill Supports `--ref` | Action |
+|------------------------|--------|
+| Yes (e.g., baoyu-image-gen with Google) | Pass reference images via `--ref` |
+| No | Convert to text description, append to prompt |
+
+**Verification**: Before generating, confirm reference processing:
+```
+Reference Processing:
+- ref-01-brand.png: using as direct reference ✓
+- ref-02-style.png: extracted palette ✓
+```
+
+**4.4 Generate**
+
+1. Call selected skill with prompt file path, output path (`cover.png`), aspect ratio
+2. If references with `direct` usage AND skill supports `--ref`: include `--ref` parameter
+3. On failure: auto-retry once before reporting error
+
+### Step 5: Completion Report

 ```
-Cover Image Generated!
+Cover Generated!

 Topic: [topic]
-Style: [style name]
-Aspect: [aspect ratio]
-Title: [cover title] (or "No title - visual only")
-Language: [confirmed language]
-Location: [output path]
+Type: [type] | Palette: [palette] | Rendering: [rendering]
+Text: [text] | Mood: [mood] | Aspect: [ratio]
+Title: [title text or "visual only"]
+Language: [lang] | Watermark: [enabled/disabled]
+References: [N images (direct/style/palette) or "extracted style" or "none"]
+Location: [directory path]

-Preview the image to verify it matches your expectations.
+Files:
+✓ source-{slug}.{ext}
+[✓ refs/ref-01-{slug}.{ext} ... (if references saved)]
+[✓ refs/ref-01-{slug}.md ... (description files)]
+[✓ refs/extracted-style.md (if style extracted verbally)]
+✓ prompts/cover.md
+✓ cover.png
+[✓ cover-backup-{timestamp}.png (if regenerated)]
 ```

+## Image Modification
+
+| Action | Steps |
+|--------|-------|
+| **Regenerate** | Backup existing → **Update prompt file FIRST** → Regenerate with same settings |
+| **Change dimension** | Backup existing → Confirm new value → **Update prompt file FIRST** → Regenerate |
+
+**IMPORTANT**: When regenerating, ALWAYS update the prompt file (`prompts/cover.md`) FIRST before regenerating. This ensures changes are documented and reproducible.
+
+All modifications automatically backup existing `cover.png` before regenerating.
+
 ## Notes

- Cover should be instantly understandable at small preview sizes
- Title (if included) must be readable and impactful
- Visual metaphors work better than literal representations
- Maintain style consistency throughout the cover
- Image generation typically takes 10-30 seconds
- Title text uses user's confirmed language preference
- Aspect ratio: 2.35:1 for cinematic/dramatic, 16:9 for widescreen, 1:1 for social media
+- Cover must be readable at small preview sizes
+- Visual metaphors > literal representations
+- Title: readable, impactful
+- Two confirmation points: Step 0 (first-time setup) + Step 2 (options) - skip Step 2 with `--quick`
+- Use confirmed language for title text
+- Maintain watermark consistency if enabled
+- Check compatibility matrices when selecting combinations
+- `--no-title` is alias for `--text none`
+- `--style` presets are backward-compatible; explicit `--palette`/`--rendering` override preset values

-## Extension Support
+### Composition Principles

-Custom styles and configurations via EXTEND.md.
+- **Generous whitespace**: 40-60% breathing room; avoid cluttered layouts
+- **Visual anchor**: Main element centered or offset left (reserve right for title)
+- **Character handling**: Simplified silhouettes or icon-style figures; NO realistic humans
+- **Icon vocabulary**: Use simple, recognizable symbols (see [references/visual-elements.md](references/visual-elements.md))

-**Check paths** (priority order):
-1. `.baoyu-skills/baoyu-cover-image/EXTEND.md` (project)
-2. `~/.baoyu-skills/baoyu-cover-image/EXTEND.md` (user)
+### Title Handling

-If found, load before Step 1. Extension content overrides defaults.
+- **Source**: Use the exact title provided by user, or extract from source content
+- **Do NOT invent titles**: Stay faithful to the original
+- If no title in source and user doesn't provide one, ask user to specify
+
+## References
+
+**Dimensions**: [text.md](references/dimensions/text.md) | [mood.md](references/dimensions/mood.md)
+**Palettes**: [references/palettes/](references/palettes/)
+**Renderings**: [references/renderings/](references/renderings/)
+**Auto-Selection**: [references/auto-selection.md](references/auto-selection.md)
+**Style Presets**: [references/style-presets.md](references/style-presets.md)
+**Compatibility**: [references/compatibility.md](references/compatibility.md)
+**Types**: [references/types.md](references/types.md)
+**Visual Elements**: [references/visual-elements.md](references/visual-elements.md)
+**Workflow**: [confirm-options.md](references/workflow/confirm-options.md) | [prompt-template.md](references/workflow/prompt-template.md)
+**Config**: [preferences-schema.md](references/config/preferences-schema.md) | [first-time-setup.md](references/config/first-time-setup.md) | [watermark-guide.md](references/config/watermark-guide.md)
@@ -0,0 +1,60 @@
+# Auto-Selection Rules
+
+When a dimension is omitted, select based on content signals.
+
+## Auto Type Selection
+
+| Signals | Type |
+|---------|------|
+| Product, launch, announcement, release, reveal | `hero` |
+| Architecture, framework, system, API, technical, model | `conceptual` |
+| Quote, opinion, insight, thought, headline, statement | `typography` |
+| Philosophy, growth, abstract, meaning, reflection | `metaphor` |
+| Story, journey, travel, lifestyle, experience, narrative | `scene` |
+| Zen, focus, essential, core, simple, pure | `minimal` |
+
+## Auto Palette Selection
+
+| Signals | Palette |
+|---------|---------|
+| Personal story, emotion, lifestyle, human | `warm` |
+| Business, professional, thought leadership, luxury | `elegant` |
+| Architecture, system, API, technical, code | `cool` |
+| Entertainment, premium, cinematic, dark mode | `dark` |
+| Nature, wellness, eco, organic, travel | `earth` |
+| Product launch, gaming, promotion, event | `vivid` |
+| Fantasy, children, gentle, creative, whimsical | `pastel` |
+| Zen, focus, essential, pure, simple | `mono` |
+| History, vintage, retro, classic, exploration | `retro` |
+
+## Auto Rendering Selection
+
+| Signals | Rendering |
+|---------|-----------|
+| Clean, modern, tech, WeChat, icon-based, infographic | `flat-vector` |
+| Sketch, note, personal, casual, doodle, warm | `hand-drawn` |
+| Art, watercolor, soft, dreamy, creative, fantasy | `painterly` |
+| Data, dashboard, SaaS, corporate, polished | `digital` |
+| Gaming, retro, 8-bit, nostalgic | `pixel` |
+| Education, tutorial, classroom, teaching | `chalk` |
+
+## Auto Text Selection
+
+| Signals | Text Level |
+|---------|------------|
+| Visual-only, photography, abstract, art | `none` |
+| Article, blog, standard cover | `title-only` |
+| Series, tutorial, technical with context | `title-subtitle` |
+| Announcement, features, multiple points, infographic | `text-rich` |
+
+Default: `title-only`
+
+## Auto Mood Selection
+
+| Signals | Mood Level |
+|---------|------------|
+| Professional, corporate, thought leadership, academic, luxury | `subtle` |
+| General, educational, standard, blog, documentation | `balanced` |
+| Launch, announcement, promotion, event, gaming, entertainment | `bold` |
+
+Default: `balanced`
@@ -1,31 +1,119 @@
-Create a WeChat article cover image following these guidelines:
+Create a cover image following these guidelines:

 ## Image Specifications

 - **Type**: Cover image / Hero image
- **Aspect Ratio**: 2.35:1 (WeChat article cover standard)
- **Style**: Hand-drawn illustration
+- **Aspect Ratio**: As specified in the prompt below

 ## Core Principles

- Hand-drawn quality throughout - NO realistic or photographic elements
 - If content involves sensitive or copyrighted figures, create stylistically similar alternatives - DO NOT refuse to generate
 - Ample whitespace, highlight core message, avoid cluttered layouts
 - Main visual elements centered or slightly left (leave right side for title area if title included)
+- Simplified silhouettes for any characters — NO realistic human faces or bodies
+- Icon-based vocabulary: use simple, recognizable icons to represent concepts
+
+## Five Dimensions
+
+### Type (Visual Composition)
+- `hero`: Large focal visual (60-70% area), dramatic composition
+- `conceptual`: Abstract shapes, information hierarchy, clean zones
+- `typography`: Title as primary element (40%+ area), minimal visuals
+- `metaphor`: Concrete object representing abstract idea, symbolic elements
+- `scene`: Atmospheric environment, narrative elements, mood lighting
+- `minimal`: Single focal element, generous whitespace (60%+)
+
+### Palette (Color Scheme)
+Apply the specified palette's color values and decorative hints:
+- Use primary colors for main visual elements
+- Use background colors for base and surrounding areas
+- Use accent colors for highlights and secondary elements
+- Follow palette-specific decorative hints for ornamentation
+
+### Rendering (Visual Style)
+Apply the specified rendering's characteristics:
+- **Lines**: Follow line quality rules (clean/sketchy/brush/pixel/chalk)
+- **Texture**: Apply or avoid texture per rendering definition
+- **Depth**: Follow depth rules (flat/minimal/soft edges)
+- **Elements**: Use rendering-specific element vocabulary
+
+### Text (Density Level)
+- `none`: No text elements, full visual area
+- `title-only`: Single headline, 85% visual area
+- `title-subtitle`: Title + context, 75% visual area
+- `text-rich`: Title + subtitle + 2-4 keyword tags, 60% visual area
+
+### Mood (Emotional Intensity)
+- `subtle`: Low contrast, muted/desaturated colors, light visual weight, calm aesthetic
+- `balanced`: Medium contrast, normal saturation, balanced visual weight
+- `bold`: High contrast, vivid/saturated colors, heavy visual weight, dynamic energy

 ## Text Style (When Title Included)

- **ALL text MUST be hand-drawn style**
- Title text: Large, eye-catching, max 8 characters
- May include 1 line of subtitle or keyword tags
- Font style harmonizes with illustration style
- **DO NOT use realistic or computer-generated fonts**
+- **Title source**: Use the exact title provided by user, or extract from source content. Do NOT invent or modify titles.
+- Title text: Large, eye-catching, faithful to source
+- Subtitle: Secondary element (if title-subtitle or text-rich)
+- Tags: 2-4 keyword badges (if text-rich)
+- Font style harmonizes with rendering style
+
+## Composition Guidance
+
+### Layout Principles
+
+- **Generous whitespace**: Maintain 40-60% breathing room; avoid cluttered compositions
+- **Visual anchor placement**: Main element centered or offset left (reserve right side for title if included)
+- **Information hierarchy**: One dominant focal point, 1-2 supporting elements, decorative accents
+- **Clean backgrounds**: Solid colors or subtle gradients; no complex textures or patterns
+
+### Icon & Symbol Vocabulary
+
+Represent concepts with simple, recognizable icons rather than detailed illustrations:
+
+| Category | Examples |
+|----------|----------|
+| Tech | Code window, gear, circuit, cloud, lock, API brackets |
+| Ideas | Lightbulb, rocket, target, puzzle, key, magnifier |
+| Communication | Speech bubble, chat dots, megaphone, mail |
+| Growth | Plant/sprout, tree, arrow, chart, mountain |
+| Tools | Wrench, pencil, brush, checklist, clock |
+
+Use the rendering style to determine icon complexity (flat-vector = geometric, hand-drawn = sketchy, etc.)
+
+Full library: [references/visual-elements.md](visual-elements.md)
+
+### Character Handling
+
+When people are needed:
+- Use simplified silhouettes or abstract stick figures
+- Symbolic representations (head + shoulders outline)
+- NO realistic faces, detailed anatomy, or photographic representations
+- Cartoon/icon style consistent with rendering choice
+
+## Mood Application
+
+Apply mood adjustments to the base palette:
+
+| Mood | Contrast | Saturation | Weight |
+|------|----------|------------|--------|
+| subtle | Reduce 20-30% | Desaturate 20-30% | Lighter strokes/fills |
+| balanced | Standard | Standard | Standard |
+| bold | Increase 20-30% | Increase 20-30% | Heavier strokes/fills |

 ## Language

 - Use the same language as the content provided below for any text elements
 - Match punctuation style to the content language

+## Reference Images
+
+When reference images are provided:
+
+- **Style extraction**: Identify rendering technique, line quality, texture, and visual vocabulary
+- **Composition learning**: Note layout patterns, whitespace usage, element placement
+- **Mood matching**: Capture the emotional tone and visual weight
+- **Adaptation**: Apply extracted characteristics while respecting the specified Type, Palette, and Rendering dimensions
+- **Priority**: If reference style conflicts with specified dimensions, dimensions take precedence for structural choices; reference influences decorative details
+
 ---

-Please use nano banana pro to generate the cover image based on the content provided below:
+Please generate the cover image based on the content provided below:
@@ -0,0 +1,50 @@
+# Compatibility Matrices
+
+✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## Palette × Rendering
+
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|
+| warm | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
+| elegant | ✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✗ |
+| cool | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
+| dark | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ |
+| earth | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ |
+| vivid | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ |
+| pastel | ✓✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ |
+| mono | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
+| retro | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✗ |
+
+## Type × Rendering
+
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|
+| hero | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ |
+| conceptual | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
+| typography | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ |
+| metaphor | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓ |
+| scene | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✗ |
+| minimal | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✗ |
+
+## Type × Text
+
+| | none | title-only | title-subtitle | text-rich |
+|---|:---:|:---:|:---:|:---:|
+| hero | ✓ | ✓✓ | ✓✓ | ✓ |
+| conceptual | ✓✓ | ✓✓ | ✓ | ✓ |
+| typography | ✗ | ✓ | ✓✓ | ✓✓ |
+| metaphor | ✓✓ | ✓ | ✓ | ✗ |
+| scene | ✓✓ | ✓ | ✓ | ✗ |
+| minimal | ✓✓ | ✓✓ | ✓ | ✗ |
+
+## Type × Mood
+
+| | subtle | balanced | bold |
+|---|:---:|:---:|:---:|
+| hero | ✓ | ✓✓ | ✓✓ |
+| conceptual | ✓✓ | ✓✓ | ✓ |
+| typography | ✓ | ✓✓ | ✓✓ |
+| metaphor | ✓✓ | ✓✓ | ✓ |
+| scene | ✓✓ | ✓✓ | ✓ |
+| minimal | ✓✓ | ✓✓ | ✗ |
@@ -0,0 +1,202 @@
+---
+name: first-time-setup
+description: First-time setup flow for baoyu-cover-image preferences
+---
+
+# First-Time Setup
+
+## Overview
+
+When no EXTEND.md is found, guide user through preference setup.
+
+**⛔ BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
+- Ask about reference images
+- Ask about content/article
+- Ask about dimensions (type, palette, rendering)
+- Proceed to content analysis
+
+ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
+
+## Setup Flow
+
+```
+No EXTEND.md found
+        │
+        ▼
+┌─────────────────────┐
+│ AskUserQuestion     │
+│ (all questions)     │
+└─────────────────────┘
+        │
+        ▼
+┌─────────────────────┐
+│ Create EXTEND.md    │
+└─────────────────────┘
+        │
+        ▼
+    Continue to Step 1
+```
+
+## Questions
+
+**Language**: Use user's input language or saved language preference.
+
+Use AskUserQuestion with ALL questions in ONE call:
+
+### Question 1: Watermark
+
+```yaml
+header: "Watermark"
+question: "Watermark text for generated cover images?"
+options:
+  - label: "No watermark (Recommended)"
+    description: "Clean covers, can enable later in EXTEND.md"
+```
+
+### Question 2: Preferred Type
+
+```yaml
+header: "Type"
+question: "Default cover type preference?"
+options:
+  - label: "Auto-select (Recommended)"
+    description: "Choose based on content analysis each time"
+  - label: "hero"
+    description: "Large visual impact - product launch, announcements"
+  - label: "conceptual"
+    description: "Concept visualization - technical, architecture"
+```
+
+### Question 3: Preferred Palette
+
+```yaml
+header: "Palette"
+question: "Default color palette preference?"
+options:
+  - label: "Auto-select (Recommended)"
+    description: "Choose based on content analysis each time"
+  - label: "elegant"
+    description: "Sophisticated - soft coral, muted teal, dusty rose"
+  - label: "warm"
+    description: "Friendly - orange, golden yellow, terracotta"
+  - label: "cool"
+    description: "Technical - engineering blue, navy, cyan"
+```
+
+### Question 4: Preferred Rendering
+
+```yaml
+header: "Rendering"
+question: "Default rendering style preference?"
+options:
+  - label: "Auto-select (Recommended)"
+    description: "Choose based on content analysis each time"
+  - label: "hand-drawn"
+    description: "Sketchy organic illustration with personal touch"
+  - label: "flat-vector"
+    description: "Clean modern vector with geometric shapes"
+  - label: "digital"
+    description: "Polished precise digital illustration"
+```
+
+### Question 5: Default Aspect Ratio
+
+```yaml
+header: "Aspect"
+question: "Default aspect ratio for cover images?"
+options:
+  - label: "16:9 (Recommended)"
+    description: "Standard widescreen - YouTube, presentations, versatile"
+  - label: "2.35:1"
+    description: "Cinematic widescreen - article headers, blog posts"
+  - label: "1:1"
+    description: "Square - Instagram, WeChat, social cards"
+  - label: "3:4"
+    description: "Portrait - Xiaohongshu, Pinterest, mobile content"
+```
+
+Note: More ratios (4:3, 3:2) available during generation. This sets the default recommendation.
+
+### Question 6: Default Output Directory
+
+```yaml
+header: "Output"
+question: "Default output directory for cover images?"
+options:
+  - label: "Independent (Recommended)"
+    description: "cover-image/{topic-slug}/ - separate from article"
+  - label: "Same directory"
+    description: "{article-dir}/ - alongside the article file"
+  - label: "imgs subdirectory"
+    description: "{article-dir}/imgs/ - images folder near article"
+```
+
+### Question 7: Quick Mode
+
+```yaml
+header: "Quick"
+question: "Enable quick mode by default?"
+options:
+  - label: "No (Recommended)"
+    description: "Confirm dimension choices each time"
+  - label: "Yes"
+    description: "Skip confirmation, use auto-selection"
+```
+
+### Question 8: Save Location
+
+```yaml
+header: "Save"
+question: "Where to save preferences?"
+options:
+  - label: "Project (Recommended)"
+    description: ".baoyu-skills/ (this project only)"
+  - label: "User"
+    description: "~/.baoyu-skills/ (all projects)"
+```
+
+## Save Locations
+
+| Choice | Path | Scope |
+|--------|------|-------|
+| Project | `.baoyu-skills/baoyu-cover-image/EXTEND.md` | Current project |
+| User | `~/.baoyu-skills/baoyu-cover-image/EXTEND.md` | All projects |
+
+## After Setup
+
+1. Create directory if needed
+2. Write EXTEND.md with frontmatter
+3. Confirm: "Preferences saved to [path]"
+4. Continue to Step 1
+
+## EXTEND.md Template
+
+```yaml
+---
+version: 3
+watermark:
+  enabled: [true/false]
+  content: "[user input or empty]"
+  position: bottom-right
+  opacity: 0.7
+preferred_type: [selected type or null]
+preferred_palette: [selected palette or null]
+preferred_rendering: [selected rendering or null]
+preferred_text: title-only
+preferred_mood: balanced
+default_aspect: [16:9/2.35:1/1:1/3:4]
+default_output_dir: [independent/same-dir/imgs-subdir]
+quick_mode: [true/false]
+language: null
+custom_palettes: []
+---
+```
+
+## Modifying Preferences Later
+
+Users can edit EXTEND.md directly or run setup again:
+- Delete EXTEND.md to trigger setup
+- Edit YAML frontmatter for quick changes
+- Full schema: `preferences-schema.md`
+
+**EXTEND.md Supports**: Watermark | Preferred type | Preferred palette | Preferred rendering | Preferred text | Preferred mood | Default aspect ratio | Default output directory | Quick mode | Custom palette definitions | Language preference
@@ -0,0 +1,261 @@
+---
+name: preferences-schema
+description: EXTEND.md YAML schema for baoyu-cover-image user preferences
+---
+
+# Preferences Schema
+
+## Full Schema
+
+```yaml
+---
+version: 3
+
+watermark:
+  enabled: false
+  content: ""
+  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right
+
+preferred_type: null      # hero|conceptual|typography|metaphor|scene|minimal or null for auto-select
+
+preferred_palette: null   # warm|elegant|cool|dark|earth|vivid|pastel|mono|retro or null for auto-select
+
+preferred_rendering: null # flat-vector|hand-drawn|painterly|digital|pixel|chalk or null for auto-select
+
+preferred_text: title-only  # none|title-only|title-subtitle|text-rich
+
+preferred_mood: balanced    # subtle|balanced|bold
+
+default_aspect: "2.35:1"  # 2.35:1|16:9|1:1
+
+quick_mode: false         # Skip confirmation when true
+
+language: null            # zh|en|ja|ko|auto (null = auto-detect)
+
+custom_palettes:
+  - name: my-palette
+    description: "Palette description"
+    colors:
+      primary: ["#1E3A5F", "#4A90D9"]
+      background: "#F5F7FA"
+      accents: ["#00B4D8"]
+    decorative_hints: "Clean lines, geometric shapes"
+    best_for: "Business, tech content"
+---
+```
+
+## Field Reference
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `version` | int | 3 | Schema version |
+| `watermark.enabled` | bool | false | Enable watermark |
+| `watermark.content` | string | "" | Watermark text (@username or custom) |
+| `watermark.position` | enum | bottom-right | Position on image |
+| `preferred_type` | string | null | Type name or null for auto |
+| `preferred_palette` | string | null | Palette name or null for auto |
+| `preferred_rendering` | string | null | Rendering name or null for auto |
+| `preferred_text` | string | title-only | Text density level |
+| `preferred_mood` | string | balanced | Mood intensity level |
+| `default_aspect` | string | "2.35:1" | Default aspect ratio |
+| `quick_mode` | bool | false | Skip confirmation step |
+| `language` | string | null | Output language (null = auto-detect) |
+| `custom_palettes` | array | [] | User-defined palettes |
+
+## Type Options
+
+| Value | Description |
+|-------|-------------|
+| `hero` | Large visual impact, title overlay |
+| `conceptual` | Concept visualization, abstract core ideas |
+| `typography` | Text-focused layout, prominent title |
+| `metaphor` | Visual metaphor, concrete expressing abstract |
+| `scene` | Atmospheric scene, narrative feel |
+| `minimal` | Minimalist composition, generous whitespace |
+
+## Palette Options
+
+| Value | Description |
+|-------|-------------|
+| `warm` | Friendly, approachable — orange, golden yellow, terracotta |
+| `elegant` | Sophisticated, refined — soft coral, muted teal, dusty rose |
+| `cool` | Technical, professional — engineering blue, navy, cyan |
+| `dark` | Cinematic, premium — electric purple, cyan, magenta |
+| `earth` | Natural, organic — forest green, sage, earth brown |
+| `vivid` | Energetic, bold — bright red, neon green, electric blue |
+| `pastel` | Gentle, whimsical — soft pink, mint, lavender |
+| `mono` | Clean, focused — black, near-black, white |
+| `retro` | Nostalgic, vintage — muted orange, dusty pink, maroon |
+
+## Rendering Options
+
+| Value | Description |
+|-------|-------------|
+| `flat-vector` | Clean outlines, uniform fills, geometric icons |
+| `hand-drawn` | Sketchy, organic, imperfect strokes, paper texture |
+| `painterly` | Soft brush strokes, color bleeds, watercolor feel |
+| `digital` | Polished, precise edges, subtle gradients, UI components |
+| `pixel` | Pixel grid, dithering, chunky 8-bit shapes |
+| `chalk` | Chalk strokes, dust effects, blackboard texture |
+
+## Text Options
+
+| Value | Description |
+|-------|-------------|
+| `none` | Pure visual, no text elements |
+| `title-only` | Single headline |
+| `title-subtitle` | Title + subtitle |
+| `text-rich` | Title + subtitle + keyword tags (2-4) |
+
+## Mood Options
+
+| Value | Description |
+|-------|-------------|
+| `subtle` | Low contrast, muted colors, calm aesthetic |
+| `balanced` | Medium contrast, normal saturation, versatile |
+| `bold` | High contrast, vivid colors, dynamic energy |
+
+## Position Options
+
+| Value | Description |
+|-------|-------------|
+| `bottom-right` | Lower right corner (default, most common) |
+| `bottom-left` | Lower left corner |
+| `bottom-center` | Bottom center |
+| `top-right` | Upper right corner |
+
+## Aspect Ratio Options
+
+| Value | Description | Best For |
+|-------|-------------|----------|
+| `2.35:1` | Cinematic widescreen | Article headers, blog covers |
+| `16:9` | Standard widescreen | Presentations, video thumbnails |
+| `1:1` | Square | Social media, profile images |
+
+## Custom Palette Fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Unique palette identifier (kebab-case) |
+| `description` | Yes | What the palette conveys |
+| `colors.primary` | No | Main colors (array of hex) |
+| `colors.background` | No | Background color (hex) |
+| `colors.accents` | No | Accent colors (array of hex) |
+| `decorative_hints` | No | Decorative elements and patterns |
+| `best_for` | No | Recommended content types |
+
+## Example: Minimal Preferences
+
+```yaml
+---
+version: 3
+watermark:
+  enabled: true
+  content: "@myhandle"
+preferred_type: null
+preferred_palette: elegant
+preferred_rendering: hand-drawn
+preferred_text: title-only
+preferred_mood: balanced
+quick_mode: false
+---
+```
+
+## Example: Full Preferences
+
+```yaml
+---
+version: 3
+watermark:
+  enabled: true
+  content: "myblog.com"
+  position: bottom-right
+
+preferred_type: conceptual
+
+preferred_palette: cool
+
+preferred_rendering: digital
+
+preferred_text: title-subtitle
+
+preferred_mood: subtle
+
+default_aspect: "16:9"
+
+quick_mode: true
+
+language: en
+
+custom_palettes:
+  - name: corporate-tech
+    description: "Professional B2B tech palette"
+    colors:
+      primary: ["#1E3A5F", "#4A90D9"]
+      background: "#F5F7FA"
+      accents: ["#00B4D8", "#48CAE4"]
+    decorative_hints: "Clean lines, subtle gradients, circuit patterns"
+    best_for: "SaaS, enterprise, technical"
+---
+```
+
+## Migration from v2
+
+When loading v2 schema, auto-upgrade:
+
+| v2 Field | v3 Field | Migration |
+|----------|----------|-----------|
+| `version: 2` | `version: 3` | Update |
+| `preferred_style` | `preferred_palette` + `preferred_rendering` | Use preset mapping table |
+| `custom_styles` | `custom_palettes` | Rename, restructure fields |
+
+**Style → Palette + Rendering mapping**:
+
+| v2 `preferred_style` | v3 `preferred_palette` | v3 `preferred_rendering` |
+|----------------------|----------------------|-------------------------|
+| `elegant` | `elegant` | `hand-drawn` |
+| `blueprint` | `cool` | `digital` |
+| `chalkboard` | `dark` | `chalk` |
+| `dark-atmospheric` | `dark` | `digital` |
+| `editorial-infographic` | `cool` | `digital` |
+| `fantasy-animation` | `pastel` | `painterly` |
+| `flat-doodle` | `pastel` | `flat-vector` |
+| `intuition-machine` | `retro` | `digital` |
+| `minimal` | `mono` | `flat-vector` |
+| `nature` | `earth` | `hand-drawn` |
+| `notion` | `mono` | `digital` |
+| `pixel-art` | `vivid` | `pixel` |
+| `playful` | `pastel` | `hand-drawn` |
+| `retro` | `retro` | `digital` |
+| `sketch-notes` | `warm` | `hand-drawn` |
+| `vector-illustration` | `retro` | `flat-vector` |
+| `vintage` | `retro` | `hand-drawn` |
+| `warm` | `warm` | `hand-drawn` |
+| `watercolor` | `earth` | `painterly` |
+| null (auto) | null | null |
+
+**Custom style migration**:
+
+| v2 Field | v3 Field |
+|----------|----------|
+| `custom_styles[].name` | `custom_palettes[].name` |
+| `custom_styles[].description` | `custom_palettes[].description` |
+| `custom_styles[].color_palette` | `custom_palettes[].colors` |
+| `custom_styles[].visual_elements` | `custom_palettes[].decorative_hints` |
+| `custom_styles[].typography` | (removed — determined by rendering) |
+| `custom_styles[].best_for` | `custom_palettes[].best_for` |
+
+## Migration from v1
+
+When loading v1 schema, auto-upgrade to v3:
+
+| v1 Field | v3 Field | Default Value |
+|----------|----------|---------------|
+| (missing) | `version` | 3 |
+| (missing) | `preferred_palette` | null |
+| (missing) | `preferred_rendering` | null |
+| (missing) | `preferred_text` | title-only |
+| (missing) | `preferred_mood` | balanced |
+| (missing) | `quick_mode` | false |
+
+v1 `--no-title` flag maps to `preferred_text: none`.
@@ -0,0 +1,69 @@
+---
+name: watermark-guide
+description: Watermark configuration guide for baoyu-cover-image
+---
+
+# Watermark Guide
+
+## Position Diagram
+
+```
+┌─────────────────────────────┐
+│                  [top-right]│
+│                             │
+│                             │
+│       COVER IMAGE           │
+│                             │
+│                             │
+│[bottom-left][bottom-center][bottom-right]│
+└─────────────────────────────┘
+```
+
+## Position Recommendations
+
+| Position | Best For | Avoid When |
+|----------|----------|------------|
+| `bottom-right` | Default choice, most common | Title in bottom-right |
+| `bottom-left` | Right-heavy layouts | Key visual in bottom-left |
+| `bottom-center` | Centered designs | Text-heavy bottom area |
+| `top-right` | Bottom-heavy content | Title/header in top-right |
+
+## Content Format
+
+| Format | Example | Style |
+|--------|---------|-------|
+| Handle | `@username` | Social media |
+| Domain | `myblog.com` | Cross-platform |
+| Brand | `MyBrand` | Simple branding |
+| Chinese | `博客名` | Chinese platforms |
+
+## Best Practices
+
+1. **Consistency**: Use same watermark across all covers
+2. **Legibility**: Ensure watermark readable on both light/dark areas
+3. **Size**: Keep subtle - should not distract from content
+
+## Prompt Integration
+
+When watermark is enabled, add to image generation prompt:
+
+```
+Include a subtle watermark "[content]" positioned at [position].
+The watermark should be legible but not distracting from the main content.
+```
+
+## Cover-Specific Considerations
+
+| Aspect Ratio | Recommended Position | Notes |
+|--------------|---------------------|-------|
+| 2.35:1 | bottom-right | Cinematic - keep corners clean |
+| 16:9 | bottom-right | Standard - flexible placement |
+| 1:1 | bottom-center | Square - centered often works better |
+
+## Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Watermark invisible | Adjust position or check contrast |
+| Watermark too prominent | Change position or reduce size |
+| Watermark overlaps title | Change position or reduce title area |
@@ -0,0 +1,139 @@
+---
+name: mood-dimension
+description: Emotional intensity dimension for cover images
+---
+
+# Mood Dimension
+
+Controls emotional intensity and visual weight of cover images.
+
+## Values
+
+| Value | Contrast | Saturation | Weight | Energy |
+|-------|:--------:|:----------:|:------:|:------:|
+| `subtle` | Low | Muted | Light | Calm |
+| `balanced` | Medium | Normal | Medium | Moderate |
+| `bold` | High | Vivid | Heavy | Dynamic |
+
+## Detail
+
+### subtle
+
+Calm, understated visual presence.
+
+**Characteristics**:
+- Low contrast between elements
+- Muted, desaturated colors
+- Light visual weight
+- Gentle, refined aesthetic
+- Soft edges and transitions
+
+**Use Cases**:
+- Thought leadership content
+- Professional/corporate communications
+- Meditation, wellness topics
+- Academic or scholarly articles
+- Luxury brand aesthetics
+
+**Color Guidance**:
+- Pastels, earth tones, neutrals
+- Low saturation (30-50%)
+- Soft gradients
+- Minimal color variety (2-3 colors)
+
+### balanced
+
+Versatile, harmonious visual presence.
+
+**Characteristics**:
+- Medium contrast
+- Natural saturation levels
+- Balanced visual weight
+- Clear but not aggressive
+- Standard aesthetic approach
+
+**Use Cases**:
+- General articles (default)
+- Most blog content
+- Educational material
+- Product documentation
+- News and updates
+
+**Color Guidance**:
+- Standard saturation (50-70%)
+- Complementary color schemes
+- Clear foreground/background separation
+- Moderate color variety (3-4 colors)
+
+### bold
+
+Dynamic, high-impact visual presence.
+
+**Characteristics**:
+- High contrast between elements
+- Vivid, saturated colors
+- Heavy visual weight
+- Energetic, attention-grabbing
+- Sharp edges and strong shapes
+
+**Use Cases**:
+- Product launches
+- Promotional announcements
+- Event marketing
+- Call-to-action content
+- Entertainment/gaming topics
+
+**Color Guidance**:
+- High saturation (70-100%)
+- Vibrant, primary colors
+- Strong contrast ratios
+- Dynamic color combinations (4+ colors)
+
+## Type Compatibility
+
+| Type | subtle | balanced | bold |
+|------|:------:|:--------:|:----:|
+| hero | ✓ | ✓✓ | ✓✓ |
+| conceptual | ✓✓ | ✓✓ | ✓ |
+| typography | ✓ | ✓✓ | ✓✓ |
+| metaphor | ✓✓ | ✓✓ | ✓ |
+| scene | ✓✓ | ✓✓ | ✓ |
+| minimal | ✓✓ | ✓✓ | ✗ |
+
+✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## Palette Interaction
+
+Mood modifies the base palette characteristics:
+
+| Palette Category | subtle | balanced | bold |
+|------------------|--------|----------|------|
+| Warm palettes (warm, earth, pastel) | More whitespace, softer tones | Standard colors | Deeper, richer warm tones |
+| Cool palettes (cool, mono, elegant) | Lighter lines, muted colors | Standard colors | Stronger contrast, sharper definition |
+| Dark palettes (dark, vivid) | Reduced contrast, softer glow | Standard colors | Maximum impact, vivid saturation |
+| Vintage palettes (retro) | More faded, sepia-heavy | Standard colors | Bolder retro contrasts |
+
+## Rendering Interaction
+
+Mood adjusts rendering characteristics:
+
+| Rendering | subtle | balanced | bold |
+|-----------|--------|----------|------|
+| flat-vector | Thinner strokes, lighter fills | Standard weight | Thicker strokes, stronger fills |
+| hand-drawn | Lighter pencil pressure, more space | Standard strokes | Heavier marker strokes, denser elements |
+| painterly | Diluted washes, more white | Standard brush | Thicker paint, saturated strokes |
+| digital | Reduced shadows, lower contrast | Standard rendering | Stronger shadows, sharper edges |
+| pixel | Fewer colors, simpler shapes | Standard palette | More colors, denser pixel detail |
+| chalk | Lighter chalk, more board showing | Standard chalk | Heavy chalk, vivid colors, dense marks |
+
+## Auto Selection
+
+When `--mood` is omitted, select based on signals:
+
+| Signals | Mood Level |
+|---------|------------|
+| Professional, corporate, thought leadership, academic, luxury | `subtle` |
+| General, educational, standard, blog, documentation | `balanced` |
+| Launch, announcement, promotion, event, gaming, entertainment | `bold` |
+
+Default: `balanced`
@@ -0,0 +1,130 @@
+---
+name: text-dimension
+description: Text density dimension for cover images
+---
+
+# Text Dimension
+
+Controls text density and information hierarchy on cover images.
+
+## Values
+
+| Value | Title | Subtitle | Tags | Visual Area |
+|-------|:-----:|:--------:|:----:|:-----------:|
+| `none` | - | - | - | 100% |
+| `title-only` | ✓ | - | - | 85% |
+| `title-subtitle` | ✓ | ✓ | - | 75% |
+| `text-rich` | ✓ | ✓ | ✓ (2-4) | 60% |
+
+## Detail
+
+### none
+
+Pure visual cover with no text elements.
+
+**Use Cases**:
+- Photography-focused covers
+- Abstract art pieces
+- Visual-only social sharing
+- When title added externally
+
+**Composition**:
+- Full visual area available
+- No reserved text zones
+- Emphasis on visual metaphor
+
+### title-only
+
+Single headline, maximum impact.
+
+**Use Cases**:
+- Most article covers (default)
+- Clear single message
+- Strong brand recognition
+
+**Composition**:
+- Title: prominent placement
+- Reserved zone: top or bottom 15%
+- Visual supports title message
+
+**Title Guidelines**:
+- Use exact title from source content or user-provided title
+- Do NOT invent or modify titles
+- Match content language
+
+### title-subtitle
+
+Title with supporting context.
+
+**Use Cases**:
+- Technical articles needing clarification
+- Series with episode/part info
+- Content with dual messages
+
+**Composition**:
+- Title: primary element
+- Subtitle: secondary element
+- Reserved zone: 25%
+- Clear hierarchy between title/subtitle
+
+**Title Guidelines**:
+- Use exact title from source content or user-provided title
+- Do NOT invent or modify titles
+
+**Subtitle Guidelines**:
+- Clarify or contextualize title
+- Can include series name, author, date
+- Smaller, less prominent than title
+
+### text-rich
+
+Information-dense cover with multiple text elements.
+
+**Use Cases**:
+- Infographic-style covers
+- Event announcements with details
+- Promotional material with features
+- Content with multiple key points
+
+**Composition**:
+- Title: primary focus
+- Subtitle: supporting info
+- Tags: 2-4 keyword labels
+- Reserved zone: 40%
+- Clear visual hierarchy
+
+**Title Guidelines**:
+- Use exact title from source content or user-provided title
+- Do NOT invent or modify titles
+
+**Tag Guidelines**:
+- 2-4 tags maximum
+- Short keywords (1-2 words each)
+- Positioned as badges/labels
+- Can highlight: category, date, author, key features
+
+## Type Compatibility
+
+| Type | none | title-only | title-subtitle | text-rich |
+|------|:----:|:----------:|:--------------:|:---------:|
+| hero | ✓ | ✓✓ | ✓✓ | ✓ |
+| conceptual | ✓✓ | ✓✓ | ✓ | ✓ |
+| typography | ✗ | ✓ | ✓✓ | ✓✓ |
+| metaphor | ✓✓ | ✓ | ✓ | ✗ |
+| scene | ✓✓ | ✓ | ✓ | ✗ |
+| minimal | ✓✓ | ✓✓ | ✓ | ✗ |
+
+✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## Auto Selection
+
+When `--text` is omitted, select based on signals:
+
+| Signals | Text Level |
+|---------|------------|
+| Visual-only, photography, abstract, art | `none` |
+| Article, blog, standard cover | `title-only` |
+| Series, tutorial, technical with context | `title-subtitle` |
+| Announcement, features, multiple points, infographic | `text-rich` |
+
+Default: `title-only`
@@ -0,0 +1,26 @@
+# cool
+
+Technical, professional, precise
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Engineering Blue | #2563EB |
+| Primary 2 | Navy Blue | #1E3A5F |
+| Primary 3 | Cyan | #06B6D4 |
+| Background | Light Gray | #F8F9FA |
+| Background Alt | Blueprint Off-White | #FAF8F5 |
+| Accent 1 | Amber | #F59E0B |
+| Accent 2 | Light Blue | #BFDBFE |
+
+## Decorative Hints
+
+- Grid lines and alignment guides
+- Dimension indicators and measurements
+- Technical schematics and diagrams
+- Geometric precision elements
+
+## Best For
+
+Architecture, system design, API, technical documentation, engineering, data analysis
@@ -0,0 +1,26 @@
+# dark
+
+Cinematic, premium, atmospheric
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Electric Purple | #8B5CF6 |
+| Primary 2 | Cyan Blue | #06B6D4 |
+| Primary 3 | Magenta Pink | #EC4899 |
+| Background | Deep Purple-Black | #0A0A0A |
+| Background Alt | Rich Navy | #1A1A2E |
+| Accent 1 | Amber | #F59E0B |
+| Accent 2 | Pure White | #FFFFFF |
+
+## Decorative Hints
+
+- Glowing accent elements and neon highlights
+- Atmospheric fog or particle effects
+- Silhouettes with backlit edges
+- Subtle gradient backgrounds
+
+## Best For
+
+Entertainment, premium brands, cinematic storytelling, dark mode, gaming, night themes
@@ -0,0 +1,26 @@
+# earth
+
+Natural, organic, grounded
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Forest Green | #276749 |
+| Primary 2 | Sage | #9AE6B4 |
+| Primary 3 | Earth Brown | #744210 |
+| Background | Sand Beige | #F5E6D3 |
+| Background Alt | Sky Blue | #E0F2FE |
+| Accent 1 | Sunset Orange | #ED8936 |
+| Accent 2 | Water Blue | #63B3ED |
+
+## Decorative Hints
+
+- Leaves, trees, mountains, natural forms
+- Sun, clouds, organic flowing lines
+- Botanical illustrations
+- Earthy textures and natural patterns
+
+## Best For
+
+Nature, wellness, eco, organic, travel, sustainability, outdoor topics, slow living
@@ -0,0 +1,26 @@
+# elegant
+
+Sophisticated, refined, understated luxury
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Soft Coral | #E8A598 |
+| Primary 2 | Muted Teal | #5B8A8A |
+| Primary 3 | Dusty Rose | #D4A5A5 |
+| Background | Warm Cream | #F5F0E6 |
+| Background Alt | Soft Beige | #F0EBE0 |
+| Accent 1 | Gold | #C9A962 |
+| Accent 2 | Copper | #B87333 |
+
+## Decorative Hints
+
+- Delicate ornamental details
+- Subtle gradients and soft transitions
+- Refined geometric patterns
+- Balanced, symmetrical compositions
+
+## Best For
+
+Business, professional, thought leadership, luxury, corporate communications
@@ -0,0 +1,26 @@
+# mono
+
+Clean, focused, essential
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Pure Black | #000000 |
+| Primary 2 | Near Black | #1F1F1F |
+| Primary 3 | Dark Gray | #374151 |
+| Background | White | #FFFFFF |
+| Background Alt | Off-White | #FAFAFA |
+| Accent 1 | Content-derived single color | - |
+| Accent 2 | Medium Gray | #9CA3AF |
+
+## Decorative Hints
+
+- Maximum negative space
+- Thin lines and minimal strokes
+- Single focal point emphasis
+- Stark contrast between elements
+
+## Best For
+
+Zen, focus, essential concepts, pure, simple, minimalist philosophy, clean design
@@ -0,0 +1,26 @@
+# pastel
+
+Gentle, whimsical, soft
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Soft Pink | #FFB6C1 |
+| Primary 2 | Mint | #98D8C8 |
+| Primary 3 | Lavender | #C8A2C8 |
+| Background | White | #FFFFFF |
+| Background Alt | Light Cream | #FFF8E7 |
+| Accent 1 | Butter Yellow | #FFFACD |
+| Accent 2 | Sky Blue | #BEE3F8 |
+
+## Decorative Hints
+
+- Cute rounded proportions
+- Stars, sparkles, flowers, decorative flourishes
+- Soft shadows and gentle highlights
+- Storybook-style elements
+
+## Best For
+
+Fantasy, children, gentle content, creative, whimsical, casual, beginner guides
@@ -0,0 +1,30 @@
+# retro
+
+Nostalgic, vintage, classic
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Coral Red | #E07A5F |
+| Primary 2 | Mint Green | #81B29A |
+| Primary 3 | Mustard Yellow | #F2CC8F |
+| Primary 4 | Dark Maroon | #5D3A3A |
+| Background | Cream Off-White | #F5F0E6 |
+| Background Alt | Aged Paper | #F5E6D3 |
+| Accent 1 | Burnt Orange | #D4764A |
+| Accent 2 | Rock Blue | #577590 |
+| Accent 3 | Vintage Gold | #C9A227 |
+| Accent 4 | Faded Teal | #2F7373 |
+
+## Decorative Hints
+
+- Halftone dots and vintage badges
+- Aged textures with subtle paper grain
+- Sunburst/radiating lines for energy
+- Pill-shaped clouds, small dots and stars
+- Classic icons and retro motifs
+
+## Best For
+
+History, vintage, retro, classic, exploration, retrospectives, throwback content, creative proposals, educational
@@ -0,0 +1,26 @@
+# vivid
+
+Energetic, bold, attention-grabbing
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Bright Red | #EF4444 |
+| Primary 2 | Neon Green | #22C55E |
+| Primary 3 | Electric Blue | #3B82F6 |
+| Background | Light Blue | #EFF6FF |
+| Background Alt | Soft Lavender | #F5F3FF |
+| Accent 1 | Bright Orange | #FB923C |
+| Accent 2 | Vivid Yellow | #FACC15 |
+
+## Decorative Hints
+
+- Dynamic diagonal lines and angles
+- Bold geometric shapes and color blocks
+- Dramatic lighting effects
+- High-energy visual compositions
+
+## Best For
+
+Product launch, gaming, promotion, event, marketing, announcements, brand showcases
@@ -0,0 +1,26 @@
+# warm
+
+Friendly, approachable, human-centered
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Warm Orange | #ED8936 |
+| Primary 2 | Golden Yellow | #F6AD55 |
+| Primary 3 | Terracotta | #C05621 |
+| Background | Cream | #FFFAF0 |
+| Background Alt | Soft Peach | #FED7AA |
+| Accent 1 | Deep Brown | #744210 |
+| Accent 2 | Soft Red | #E53E3E |
+
+## Decorative Hints
+
+- Sun rays, warm lighting effects
+- Rounded shapes, organic curves
+- Hearts, smiling faces, friendly icons
+- Warm gradient overlays
+
+## Best For
+
+Personal growth, lifestyle, education, human stories, emotion, community
@@ -0,0 +1,43 @@
+# chalk
+
+Educational, authentic, classroom
+
+## Core Characteristics
+
+Chalk on blackboard aesthetic with imperfect strokes, dust effects, and authentic classroom feel. Nostalgic educational warmth.
+
+## Lines
+
+- Imperfect chalk strokes with variable pressure
+- Visible chalk texture and grain
+- Slightly wobbly, hand-drawn quality
+- Thick strokes for emphasis, thin for details
+
+## Texture
+
+- Chalk dust effects around text and elements
+- Board surface (dark, slightly worn)
+- Eraser smudges and residue
+- Grainy chalk quality on all elements
+
+## Depth
+
+- None: flat chalk drawings on board surface
+- Layering through erasure and redrawing
+- No shadows or perspective
+
+## Element Vocabulary
+
+- Chalk doodles: stars, arrows, underlines
+- Mathematical formulas and diagrams
+- Stick figures and simple icons
+- Connection lines with chalk feel
+- Checkmarks, circles, boxes for lists
+- Wooden frame border optional
+
+## Typography Approach
+
+- Hand-drawn chalk lettering
+- Imperfect baseline, authentic classroom feel
+- White or bright colored chalk for emphasis
+- Variable sizing for hierarchy
@@ -0,0 +1,42 @@
+# digital
+
+Polished, precise, modern
+
+## Core Characteristics
+
+Clean digital illustration with polished finish, precise edges, and subtle modern effects. Feels like a professional UI mockup or corporate illustration.
+
+## Lines
+
+- Clean, precise, computer-perfect edges
+- Consistent stroke weights
+- Sharp corners where appropriate
+- Anti-aliased smooth rendering
+
+## Texture
+
+- Smooth surfaces with no visible texture
+- Subtle gradients permitted (soft, controlled)
+- Frosted glass and blur effects
+- Clean shadows with consistent direction
+
+## Depth
+
+- Subtle gradients and soft drop shadows
+- Layered card-based layouts
+- Light 3D effects (subtle, not realistic)
+- Material Design-inspired elevation
+
+## Element Vocabulary
+
+- Polished icons and UI components
+- Data visualizations: charts, graphs, metrics
+- Card layouts and structured grids
+- Tag chips, progress bars, status indicators
+- Clean geometric shapes
+
+## Typography Approach
+
+- System UI or modern sans-serif (Inter, SF Pro style)
+- Clean, functional, high readability
+- Structured hierarchy with consistent spacing
@@ -0,0 +1,42 @@
+# flat-vector
+
+Clean, modern, geometric illustration
+
+## Core Characteristics
+
+Flat design with clean outlines, uniform fills, and no texture or depth. Think modern app icons, infographic illustrations, and vector-based editorial art.
+
+## Lines
+
+- Clean outlines with uniform stroke weight
+- Closed shapes (coloring-book style)
+- Rounded line endings, avoid sharp corners
+- Consistent stroke width throughout
+
+## Texture
+
+- None: smooth, flat color fills only
+- No gradients, shadows, or noise
+- Solid color blocks
+
+## Depth
+
+- Flat: no shadows, no perspective
+- 2D layering with overlap for depth illusion
+- Optional 2.5D isometric layering (front/back occlusion, no atmospheric perspective)
+- No 3D effects or bevels
+
+## Element Vocabulary
+
+- Geometric icons and simple shapes
+- Bold outlined objects with clean fills
+- Geometric simplification: complex objects → basic shapes (trees → lollipop/triangle, buildings → rectangles)
+- "Toy model" aesthetic: cute, rounded proportions
+- Decorative: dots, lines, sunbursts, pill-shaped clouds, small stars
+- Isolated elements on clean backgrounds
+
+## Typography Approach
+
+- Clean sans-serif or bold geometric lettering
+- Strong readability, consistent weight
+- Easily scalable at any size
@@ -0,0 +1,40 @@
+# hand-drawn
+
+Sketchy, organic, personal
+
+## Core Characteristics
+
+Hand-drawn illustration with visible imperfections, organic line quality, and personal touch. Feels like a skilled artist's sketchbook or whiteboard drawing.
+
+## Lines
+
+- Sketchy, organic, slightly imperfect strokes
+- Variable line weight (thicker at pressure points)
+- Wavy connectors and arrows
+- Natural hand tremor visible
+
+## Texture
+
+- Paper grain and subtle surface texture
+- Pencil/pen/marker texture on strokes
+- Casual fills with visible brush direction
+
+## Depth
+
+- Minimal: light hand-drawn shadows or hatching
+- No realistic depth or perspective
+- Simple layering with overlap
+
+## Element Vocabulary
+
+- Doodles, organic shapes, hand-lettered labels
+- Conceptual icons with sketchy quality
+- Connection lines with hand-drawn wavy feel
+- Stars, arrows, underlines, circles, checkmarks
+- Stick figures and simple characters
+
+## Typography Approach
+
+- Hand-lettered or marker-style text
+- Bouncy baselines, organic feel
+- Variable sizes for emphasis hierarchy
@@ -0,0 +1,40 @@
+# painterly
+
+Soft, artistic, expressive
+
+## Core Characteristics
+
+Watercolor or paint-style illustration with visible brush strokes, color bleeds, and artistic texture. Feels like a hand-painted art piece.
+
+## Lines
+
+- Soft brush strokes with variable opacity
+- No hard outlines; edges defined by color transitions
+- Organic flowing strokes with natural blending
+
+## Texture
+
+- Visible paint or watercolor wash textures
+- Color bleeds and wet-on-wet effects
+- Paper texture showing through transparent areas
+- Brush stroke patterns visible
+
+## Depth
+
+- Soft edges with natural color blending
+- Atmospheric depth through color fading
+- Layered washes creating depth illusion
+
+## Element Vocabulary
+
+- Watercolor washes as backgrounds
+- Natural elements: leaves, flowers, organic forms
+- Soft gradients and color transitions
+- Splatter and drip effects as accents
+- Botanical and environmental motifs
+
+## Typography Approach
+
+- Elegant brush script or handwritten style
+- Organic letterforms with brush texture
+- Integrated with paint environment
@@ -0,0 +1,42 @@
+# pixel
+
+Retro 8-bit, nostalgic, chunky
+
+## Core Characteristics
+
+Pixel art aesthetic with visible pixel grid, limited color palette, and nostalgic gaming feel. Emulates classic 8-bit and 16-bit era graphics.
+
+## Lines
+
+- Pixel grid alignment, no anti-aliasing
+- Staircase edges on diagonals
+- Single-pixel or double-pixel outlines
+- Blocky, angular forms
+
+## Texture
+
+- Dithering patterns for gradients
+- No smooth transitions
+- Cross-hatching with pixel precision
+- Limited 16-32 color palette per scene
+
+## Depth
+
+- None: flat pixel planes only
+- Parallax layering (foreground/background)
+- No perspective or 3D effects
+
+## Element Vocabulary
+
+- 8-bit sprites and chunky shapes
+- Simple iconography: stars, hearts, arrows
+- Text bubbles with pixel borders
+- Progress bars with chunky segments
+- Retro gaming UI elements
+
+## Typography Approach
+
+- Pixelated bitmap font style
+- Chunky blocky letterforms
+- Fixed-width or monospace feel
+- All-caps for headers
@@ -0,0 +1,32 @@
+# Style Presets
+
+`--style X` expands to a palette + rendering combination. Users can override either dimension.
+
+| --style | Palette | Rendering |
+|---------|---------|-----------|
+| `elegant` | `elegant` | `hand-drawn` |
+| `blueprint` | `cool` | `digital` |
+| `chalkboard` | `dark` | `chalk` |
+| `dark-atmospheric` | `dark` | `digital` |
+| `editorial-infographic` | `cool` | `digital` |
+| `fantasy-animation` | `pastel` | `painterly` |
+| `flat-doodle` | `pastel` | `flat-vector` |
+| `intuition-machine` | `retro` | `digital` |
+| `minimal` | `mono` | `flat-vector` |
+| `nature` | `earth` | `hand-drawn` |
+| `notion` | `mono` | `digital` |
+| `pixel-art` | `vivid` | `pixel` |
+| `playful` | `pastel` | `hand-drawn` |
+| `retro` | `retro` | `digital` |
+| `sketch-notes` | `warm` | `hand-drawn` |
+| `vector-illustration` | `retro` | `flat-vector` |
+| `vintage` | `retro` | `hand-drawn` |
+| `warm` | `warm` | `hand-drawn` |
+| `watercolor` | `earth` | `painterly` |
+
+## Override Examples
+
+- `--style blueprint --rendering hand-drawn` = cool palette with hand-drawn rendering
+- `--style elegant --palette warm` = warm palette with hand-drawn rendering
+
+Explicit `--palette`/`--rendering` flags always override preset values.
@@ -1,25 +0,0 @@
-# blueprint
-
-Precise technical blueprint style with engineering aesthetic
-
-## Color Palette
-
- Primary: Engineering Blue (#2563EB), Navy Blue (#1E3A5F)
- Background: Blueprint Off-White (#FAF8F5), subtle grid overlay
- Accents: Amber (#F59E0B), Light Blue (#BFDBFE)
-
-## Visual Elements
-
- Precise lines with consistent stroke weights
- Technical schematics and clean vector graphics
- Dimension lines and measurement indicators
- Grid alignment for all elements
- Geometric precision for all shapes
-
-## Typography
-
- Clean sans-serif hand lettering, technical and authoritative
-
-## Best For
-
-Technical architecture, system design, data analysis, engineering documentation
@@ -1,26 +0,0 @@
-# bold-editorial
-
-High-impact magazine editorial with bold visual expression
-
-## Color Palette
-
- Primary: Pure White (#FFFFFF), Electric Blue (#3B82F6), Bright Orange (#FB923C)
- Background: Deep Black (#0A0A0A), Deep Blue (#0F172A)
- Accents: Magenta (#EC4899), Neon Green (#22C55E), Violet (#8B5CF6)
-
-## Visual Elements
-
- Strong typography as visual element itself
- Geometric shapes and bold color blocks
- Full-bleed solid color backgrounds
- Dynamic diagonal lines and angles
- Dramatic lighting effects on text
- Minimal decoration, maximum impact
-
-## Typography
-
- Bold condensed typeface, oversized headlines, all-caps, tight letter-spacing
-
-## Best For
-
-Product launches, marketing, keynote speeches, brand showcases, investor pitches
@@ -1,61 +0,0 @@
-# chalkboard
-
-Black chalkboard background with colorful chalk drawing style
-
-## Design Aesthetic
-
-Classic classroom chalkboard aesthetic with hand-drawn chalk illustrations. Nostalgic educational feel with imperfect, sketchy lines that capture the warmth of traditional teaching. Colorful chalk creates visual hierarchy while maintaining the authentic chalkboard experience.
-
-## Background
-
- Color: Chalkboard Black (#1A1A1A) or Dark Green-Black (#1C2B1C)
- Texture: Realistic chalkboard texture with subtle scratches, dust particles, and faint eraser marks
-
-## Typography
-
-Hand-drawn chalk lettering style with visible chalk texture. Imperfect baseline adds authenticity. White or bright colored chalk for emphasis.
-
-## Color Palette
-
-| Role | Color | Hex | Usage |
-|------|-------|-----|-------|
-| Background | Chalkboard Black | #1A1A1A | Primary background |
-| Alt Background | Green-Black | #1C2B1C | Traditional green board |
-| Primary Text | Chalk White | #F5F5F5 | Main text, outlines |
-| Accent 1 | Chalk Yellow | #FFE566 | Highlights, emphasis |
-| Accent 2 | Chalk Pink | #FF9999 | Secondary highlights |
-| Accent 3 | Chalk Blue | #66B3FF | Diagrams, links |
-| Accent 4 | Chalk Green | #90EE90 | Success, nature |
-| Accent 5 | Chalk Orange | #FFB366 | Warnings, energy |
-
-## Visual Elements
-
- Hand-drawn chalk illustrations with sketchy, imperfect lines
- Chalk dust effects around text and key elements
- Doodles: stars, arrows, underlines, circles, checkmarks
- Mathematical formulas and simple diagrams
- Eraser smudges and chalk residue textures
- Wooden frame border optional
- Stick figures and simple icons
- Connection lines with hand-drawn feel
-
-## Style Rules
-
-### Do
-
- Maintain authentic chalk texture on all elements
- Use imperfect, hand-drawn quality throughout
- Add subtle chalk dust and smudge effects
- Create visual hierarchy with color variety
- Include playful doodles and annotations
-
-### Don't
-
- Use perfect geometric shapes
- Create clean digital-looking lines
- Add photorealistic elements
- Use gradients or glossy effects
-
-## Best For
-
-Educational content, tutorials, classroom themes, teaching materials, workshops, informal learning sessions, knowledge sharing
@@ -1,25 +0,0 @@
-# dark-atmospheric
-
-Dark moody aesthetic with glowing accent elements
-
-## Color Palette
-
- Primary: Electric Purple (#8B5CF6), Cyan Blue (#06B6D4), Magenta Pink (#EC4899)
- Background: Deep Purple-Black (#0D0D1A), Rich Navy (#1A1A2E)
- Accents: Amber (#F59E0B), Pure White (#FFFFFF)
-
-## Visual Elements
-
- Glowing accent elements and borders
- Subtle gradient backgrounds
- Atmospheric fog or particle effects
- Neon-style highlights on key elements
- Silhouettes with backlit edges
-
-## Typography
-
- Elegant serif or refined sans-serif in light/white with subtle glow
-
-## Best For
-
-Entertainment, creative industries, premium brands, cinematic storytelling
@@ -1,26 +0,0 @@
-# editorial-infographic
-
-Modern magazine-style editorial with clear visual storytelling
-
-## Color Palette
-
- Primary: Near Black (#1A1A1A), Editorial Blue (#2563EB)
- Background: Pure White (#FFFFFF), Light Gray (#F8F9FA)
- Accents: Coral (#F97316), Emerald (#10B981), Amber (#F59E0B)
-
-## Visual Elements
-
- Clean flat illustrations (not photos)
- Structured multi-section layouts
- Callout boxes for key insights
- Icon-based data visualization
- Visual metaphors for abstract concepts
- Pull quotes and highlight boxes
-
-## Typography
-
- Bold display serif or modern sans-serif, editorial sophistication
-
-## Best For
-
-Technology explainers, science communication, research summaries, thought leadership
@@ -1,23 +0,0 @@
-# elegant
-
-Refined, sophisticated, understated
-
-## Color Palette
-
- Primary: Soft coral (#E8A598), muted teal (#5B8A8A), dusty rose (#D4A5A5)
- Background: Warm cream (#F5F0E6), soft beige
- Accents: Gold (#C9A962), copper
-
-## Visual Elements
-
- Delicate lines, refined icons
- Subtle gradients
- Balanced composition
-
-## Typography
-
- Elegant serif-style hand lettering
-
-## Best For
-
-Professional content, thought leadership, business topics
@@ -1,25 +0,0 @@
-# fantasy-animation
-
-Whimsical hand-drawn animation style inspired by Ghibli and Disney
-
-## Color Palette
-
- Primary: Golden Yellow (#F4D03F), Rose Pink (#E8A0BF), Deep Forest (#2D5A3D)
- Background: Soft Sky Blue (#E8F4FC), Warm Cream (#FFF8E7)
- Accents: Sage Green (#87A96B), Sky Blue (#7EC8E3), Coral (#F08080)
-
-## Visual Elements
-
- Central illustrated character (friendly, expressive)
- Magical floating objects (books, orbs, sparkles)
- Storybook-style environment backgrounds
- Soft shadows and gentle highlights
- Decorative elements: stars, sparkles, flowers, leaves
-
-## Typography
-
- Whimsical serif or decorative hand-lettered style, organic feel
-
-## Best For
-
-Educational content, storytelling, creative workshops, fantasy/gaming content
@@ -1,27 +0,0 @@
-# flat-doodle
-
-Cute, simple doodle illustrations with bold outlines
-
-## Color Palette
-
- Primary: Bright pastel pink (#FFB6C1), mint (#98D8C8), lavender (#C8A2C8), butter yellow (#FFFACD)
- Background: Clean white (#FFFFFF)
- Accents: Bold black outlines, soft coral, sky blue
-
-## Visual Elements
-
- Bold black outlines around all shapes
- Simple flat shapes with no shading
- Cute rounded proportions
- Productivity-themed icons
- Isolated elements on white background
- Minimal decorative details
-
-## Typography
-
- Simple, clean sans-serif or hand-lettering
- Bold and easily readable
-
-## Best For
-
-Productivity content, SaaS articles, workflow tutorials, app features, beginner guides, casual business
@@ -1,26 +0,0 @@
-# intuition-machine
-
-Technical briefing style with aged paper and bilingual labels
-
-## Color Palette
-
- Primary: Dark Maroon (#5D3A3A), Teal (#2F7373)
- Background: Aged Cream (#F5F0E6), subtle paper texture with light creases
- Accents: Warm Brown (#8B7355), Maroon (#722F37), Deep Charcoal (#2D2D2D)
-
-## Visual Elements
-
- Isometric 3D technical illustrations or flat 2D diagrams
- Bilingual callout labels (English + Chinese)
- Faded thematic background patterns
- Clean black outlines on all elements
- Split or triptych layouts
- Key quote box at bottom
-
-## Typography
-
- Bold display font in dark maroon, ALL CAPS for titles, bilingual labels
-
-## Best For
-
-Technical explanations, academic presentations, bilingual audiences, knowledge docs
@@ -1,23 +0,0 @@
-# minimal
-
-Ultra-clean, zen-like, focused
-
-## Color Palette
-
- Primary: Pure black (#000000), white (#FFFFFF)
- Background: White or off-white (#FAFAFA)
- Accents: Single color (user's choice or content-derived)
-
-## Visual Elements
-
- Single focal point
- Maximum negative space
- Thin lines
-
-## Typography
-
- Clean, simple hand lettering, lots of breathing room
-
-## Best For
-
-Philosophy, minimalism, focused concepts
@@ -1,22 +0,0 @@
-# nature
-
-Organic, calm, earthy
-
-## Color Palette
-
- Primary: Forest green (#276749), sage (#9AE6B4), earth brown (#744210)
- Background: Sand beige (#F5E6D3), sky blue (#E0F2FE)
- Accents: Sunset orange, water blue
-
-## Visual Elements
-
- Leaves, trees, mountains
- Sun, clouds, organic flowing lines
-
-## Typography
-
- Organic, flowing hand lettering with natural textures
-
-## Best For
-
-Sustainability, wellness, outdoor topics, slow living
@@ -1,25 +0,0 @@
-# notion
-
-Clean SaaS dashboard aesthetic with productivity tool styling
-
-## Color Palette
-
- Primary: Near Black (#1F1F1F), Notion Blue (#2383E2)
- Background: Light Gray (#F7F7F5), Pure White (#FFFFFF)
- Accents: Success Green (#0F7B6C), Alert Red (#E03E3E), Warning Yellow (#DFAB01)
-
-## Visual Elements
-
- Card-based layouts with subtle borders
- Clean data visualizations
- Tag and label chips
- Icon-based navigation hints
- Progress bars and metric displays
-
-## Typography
-
- System UI or Inter style, clean and functional
-
-## Best For
-
-Product demos, SaaS presentations, productivity content, B2B topics
@@ -1,26 +0,0 @@
-# pixel-art
-
-Retro 8-bit pixel art aesthetic with nostalgic gaming style
-
-## Color Palette
-
- Primary: Dark Navy (#1A1A2E), Pixel Green (#00FF00)
- Background: Light Blue (#87CEEB), Soft Lavender (#E6E6FA)
- Accents: Pixel Red (#FF0000), Pixel Yellow (#FFFF00), Pixel Cyan (#00FFFF)
-
-## Visual Elements
-
- All elements with visible pixel structure
- Simple iconography: stars, hearts, arrows
- Text bubbles with pixel borders
- Progress bars with chunky segments
- Dithering patterns for gradients
- Limited 16-32 color palette
-
-## Typography
-
- Pixelated bitmap font style, chunky blocky letterforms
-
-## Best For
-
-Gaming content, tech tutorials, developer talks, retro-themed topics
@@ -1,23 +0,0 @@
-# playful
-
-Fun, creative, whimsical
-
-## Color Palette
-
- Primary: Pastel pink (#FED7E2), mint (#C6F6D5), lavender (#E9D8FD), sky blue (#BEE3F8)
- Background: Light cream (#FFFBEB), soft white
- Accents: Bright pops - yellow, coral, turquoise
-
-## Visual Elements
-
- Doodles, stars, swirls
- Cute characters, emoji-style icons
- Playful compositions
-
-## Typography
-
- Bouncy, irregular hand lettering, playful angles
-
-## Best For
-
-Casual content, tutorials, beginner guides, fun topics
@@ -1,22 +0,0 @@
-# retro
-
-Vintage, nostalgic, classic
-
-## Color Palette
-
- Primary: Muted orange (#ED8936 at 70%), dusty pink (#FED7E2 at 80%), faded teal
- Background: Aged paper (#F5E6D3), sepia tones
- Accents: Faded red, vintage gold
-
-## Visual Elements
-
- Halftone dots, vintage badges
- Classic icons, aged textures
-
-## Typography
-
- Vintage-style hand lettering, classic serif influence
-
-## Best For
-
-History, retrospectives, classic topics, throwback content
@@ -1,25 +0,0 @@
-# sketch-notes
-
-Soft hand-drawn illustration style with fresh minimalist aesthetic
-
-## Color Palette
-
- Primary: Deep Charcoal (#2C3E50), Soft Orange (#F4A261)
- Background: Warm Off-White (#FAF8F0), subtle paper grain
- Accents: Mustard Yellow (#E9C46A), Sage Green (#87A96B), Light Blue (#7EC8E3)
-
-## Visual Elements
-
- Connection lines with hand-drawn wavy feel
- Conceptual abstract icons illustrating ideas
- Color fills with hand-painted casual feel
- Doodle-style decorative elements
- Arrows and pointers with sketchy style
-
-## Typography
-
- Bold hand-written marker font for headlines, casual handwriting for body
-
-## Best For
-
-Educational content, knowledge sharing, technical explanations, tutorials
@@ -1,25 +0,0 @@
-# vector-illustration
-
-Flat vector illustration with black outlines and retro soft colors
-
-## Color Palette
-
- Primary: Coral Red (#E07A5F), Mint Green (#81B29A), Mustard Yellow (#F2CC8F)
- Background: Cream Off-White (#F5F0E6), subtle paper texture
- Accents: Burnt Orange (#D4764A), Rock Blue (#577590), Deep Charcoal (#2D2D2D) outlines
-
-## Visual Elements
-
- All objects have closed black outlines (coloring book style)
- Rounded line endings, avoid sharp corners
- Simplified geometric shapes
- 2.5D perspective with layering
- Decorative elements: sunbursts, pill clouds, dots, stars
-
-## Typography
-
- Large bold retro serif for titles, clean geometric sans-serif for body
-
-## Best For
-
-Educational content, creative proposals, brand showcases, explainer content
@@ -1,26 +0,0 @@
-# vintage
-
-Vintage aged-paper aesthetic with historical document styling
-
-## Color Palette
-
- Primary: Dark Brown (#3D2914), Forest Green (#2D5A3D), Navy Blue (#1E3A5F)
- Background: Aged Parchment (#F5E6D3), Sepia Cream (#FFF8DC)
- Accents: Burgundy (#722F37), Gold (#C9A227), Sepia Black (#3D3D3D)
-
-## Visual Elements
-
- Antique maps with route lines and landmarks
- Compass roses and nautical elements
- Specimen drawings (flora, fauna)
- Handwritten-style annotations
- Rope, leather, brass decorative motifs
- Aged texture with subtle creases
-
-## Typography
-
- Classic serif with historical character, elegant flourishes
-
-## Best For
-
-Historical content, travel, heritage storytelling, biography, scientific discovery
@@ -1,22 +0,0 @@
-# warm
-
-Friendly, approachable, human-centered
-
-## Color Palette
-
- Primary: Warm orange (#ED8936), golden yellow (#F6AD55), terracotta (#C05621)
- Background: Cream (#FFFAF0), soft peach (#FED7AA)
- Accents: Deep brown (#744210), soft red
-
-## Visual Elements
-
- Rounded shapes, smiling faces
- Sun rays, hearts, warm lighting
-
-## Typography
-
- Friendly rounded hand lettering
-
-## Best For
-
-Personal growth, lifestyle, education, human stories
@@ -1,25 +0,0 @@
-# watercolor
-
-Soft watercolor illustration style with hand-painted textures
-
-## Color Palette
-
- Primary: Soft Coral (#F4A261), Dusty Rose (#E8A0A0)
- Background: Warm Off-White (#FAF8F0), Soft Cream (#FFF9E6)
- Accents: Sage Green (#87A96B), Sky Blue (#7EC8E3), Soft Lavender (#C5B4E3)
-
-## Visual Elements
-
- Watercolor washes as backgrounds
- Visible brush strokes and textures
- Natural elements: leaves, flowers, organic shapes
- Color bleeds and soft edges
- Hand-drawn arrows and connections
-
-## Typography
-
- Elegant handwritten or brush script, organic letterforms
-
-## Best For
-
-Lifestyle content, wellness, travel guides, personal stories, creative topics
@@ -0,0 +1,23 @@
+# Type Composition Guidelines
+
+## Type Gallery
+
+| Type | Description | Best For |
+|------|-------------|----------|
+| `hero` | Large visual impact, title overlay | Product launch, brand promotion, major announcements |
+| `conceptual` | Concept visualization, abstract core ideas | Technical articles, methodology, architecture design |
+| `typography` | Text-focused layout, prominent title | Opinion pieces, quotes, insights |
+| `metaphor` | Visual metaphor, concrete expressing abstract | Philosophy, growth, personal development |
+| `scene` | Atmospheric scene, narrative feel | Stories, travel, lifestyle |
+| `minimal` | Minimalist composition, generous whitespace | Zen, focus, core concepts |
+
+## Type-Specific Composition
+
+| Type | Composition Guidelines |
+|------|------------------------|
+| `hero` | Large focal visual (60-70% area), title overlay on visual, dramatic composition |
+| `conceptual` | Abstract shapes representing core concepts, information hierarchy, clean zones |
+| `typography` | Title as primary element (40%+ area), minimal supporting visuals, strong hierarchy |
+| `metaphor` | Concrete object/scene representing abstract idea, symbolic elements, emotional resonance |
+| `scene` | Atmospheric environment, narrative elements, mood-setting lighting and colors |
+| `minimal` | Single focal element, generous whitespace (60%+), essential shapes only |
@@ -0,0 +1,101 @@
+# Visual Elements Library
+
+Icon and symbol vocabulary organized by topic. Use these as building blocks for cover compositions.
+
+## Tech & Development
+
+| Element | Use For |
+|---------|---------|
+| Code window / Terminal | Programming, development |
+| Gear / Cog | Engineering, settings, process |
+| Circuit board / Chip | Hardware, AI, computing |
+| Binary / Data stream | Data, algorithms |
+| API brackets `</>` | Web development, APIs |
+| Cloud | Cloud computing, SaaS |
+| Lock / Shield | Security, privacy |
+| Network nodes | Distributed systems, connections |
+
+## Ideas & Innovation
+
+| Element | Use For |
+|---------|---------|
+| Lightbulb | Ideas, insights, innovation |
+| Rocket | Launch, growth, startups |
+| Target / Bullseye | Goals, precision, focus |
+| Puzzle piece | Problem solving, integration |
+| Key | Solutions, access, unlocking |
+| Magnifying glass | Analysis, search, discovery |
+| Chart / Graph | Data, trends, growth |
+| Arrow / Path | Direction, journey, progress |
+
+## Communication & Collaboration
+
+| Element | Use For |
+|---------|---------|
+| Speech bubble | Communication, dialogue |
+| Chat dots `...` | Conversation, messaging |
+| Handshake | Partnership, agreement |
+| Team / Figures | Collaboration, community |
+| Mail / Envelope | Notifications, outreach |
+| Megaphone | Announcements, marketing |
+| Network / Web | Social, connections |
+
+## Nature & Growth
+
+| Element | Use For |
+|---------|---------|
+| Plant / Sprout | Growth, organic, sustainability |
+| Tree | Established, structure, branching |
+| Leaf | Eco, natural, fresh |
+| Sun / Rays | Energy, positivity, new beginnings |
+| Mountain | Challenge, achievement, scale |
+| Wave | Flow, change, rhythm |
+| Seed → Plant | Transformation, potential |
+
+## Tools & Actions
+
+| Element | Use For |
+|---------|---------|
+| Wrench / Hammer | Building, fixing, tools |
+| Pencil / Pen | Writing, creation, editing |
+| Brush | Design, creativity, art |
+| Scissors | Cutting, editing, trimming |
+| Clock / Timer | Time, scheduling, deadlines |
+| Calendar | Planning, events, milestones |
+| Checklist / Checkbox | Tasks, completion, validation |
+
+## Abstract Concepts
+
+| Element | Use For |
+|---------|---------|
+| Infinity ∞ | Continuous, endless, loops |
+| Yin-yang | Balance, duality, harmony |
+| Spiral | Evolution, recursion, cycles |
+| Stack / Layers | Depth, hierarchy, structure |
+| Bridge | Connection, transition, spanning |
+| Door / Portal | Opportunity, entry, access |
+| Mirror / Reflection | Self-improvement, analysis |
+
+## Combination Patterns
+
+Create visual metaphors by combining elements:
+
+| Combination | Represents |
+|-------------|------------|
+| Lightbulb + Gear | Innovative engineering |
+| Plant + Code | Organic tech growth |
+| Rocket + Target | Precise acceleration |
+| Key + Lock | Security solutions |
+| Bridge + People | Team connections |
+| Magnifier + Data | Analytics, insights |
+
+## Rendering-Specific Treatment
+
+| Rendering | Element Style |
+|-----------|---------------|
+| `flat-vector` | Geometric, simple shapes, uniform fills |
+| `hand-drawn` | Sketchy, organic, doodle-like |
+| `painterly` | Soft edges, brush strokes |
+| `digital` | Precise, gradient hints, polished |
+| `pixel` | 8-bit chunky, grid-aligned |
+| `chalk` | Dusty, textured, board style |
@@ -0,0 +1,132 @@
+# Step 2: Confirm Options
+
+## Purpose
+
+Validate all 5 dimensions + aspect ratio.
+
+## Skip Conditions
+
+| Condition | Skipped Questions | Still Asked |
+|-----------|-------------------|-------------|
+| `--quick` flag | Type, Palette, Rendering, Text, Mood | **Aspect Ratio** (unless `--aspect` specified) |
+| All 5 dimensions + `--aspect` specified | All | None |
+| `quick_mode: true` in EXTEND.md | Type, Palette, Rendering, Text, Mood | **Aspect Ratio** (unless `--aspect` specified) |
+| Otherwise | None | All 6 questions |
+
+**Important**: Aspect ratio is ALWAYS asked unless explicitly specified via `--aspect` CLI flag. User presets in EXTEND.md are shown as recommended option, not auto-selected.
+
+## Quick Mode Output
+
+When skipping 5 dimensions:
+
+```
+Quick Mode: Auto-selected dimensions
+• Type: [type] ([reason])
+• Palette: [palette] ([reason])
+• Rendering: [rendering] ([reason])
+• Text: [text] ([reason])
+• Mood: [mood] ([reason])
+
+[Then ask Question 6: Aspect Ratio]
+```
+
+## Confirmation Flow
+
+**Language**: Auto-determined (user's input language > saved preference > source language). No need to ask.
+
+Present ALL options in a **single AskUserQuestion call** (4 questions max).
+
+Skip any question where the dimension is already specified via CLI flag or `--style` preset.
+
+### Q1: Type (skip if `--type`)
+
+```yaml
+header: "Type"
+question: "Which cover type?"
+multiSelect: false
+options:
+  - label: "[auto-recommended type] (Recommended)"
+    description: "[reason based on content signals]"
+  - label: "hero"
+    description: "Large visual impact, title overlay - product launch, announcements"
+  - label: "conceptual"
+    description: "Concept visualization - technical, architecture"
+  - label: "typography"
+    description: "Text-focused layout - opinions, quotes"
+```
+
+### Q2: Palette (skip if `--palette` or `--style`)
+
+```yaml
+header: "Palette"
+question: "Which color palette?"
+multiSelect: false
+options:
+  - label: "[auto-recommended palette] (Recommended)"
+    description: "[reason based on content signals]"
+  - label: "warm"
+    description: "Friendly - orange, golden yellow, terracotta"
+  - label: "elegant"
+    description: "Sophisticated - soft coral, muted teal, dusty rose"
+  - label: "cool"
+    description: "Technical - engineering blue, navy, cyan"
+```
+
+### Q3: Rendering (skip if `--rendering` or `--style`)
+
+Show compatible renderings (✓✓ first from compatibility matrix):
+
+```yaml
+header: "Rendering"
+question: "Which rendering style?"
+multiSelect: false
+options:
+  - label: "[best compatible rendering] (Recommended)"
+    description: "[reason based on palette + type + content]"
+  - label: "flat-vector"
+    description: "Clean outlines, flat fills, geometric icons"
+  - label: "hand-drawn"
+    description: "Sketchy, organic, imperfect strokes"
+  - label: "digital"
+    description: "Polished, precise, subtle gradients"
+```
+
+### Q4: Other Settings (skip if all remaining dimensions already specified)
+
+Combine remaining settings into one question. Include: Output Dir (if no preference + file path input), Text, Mood, Aspect. Show auto-selected values as recommended option. User can accept all or type adjustments via "Other".
+
+**When output dir needs asking** (no `default_output_dir` preference + file path input):
+
+```yaml
+header: "Settings"
+question: "Output / Text / Mood / Aspect?"
+multiSelect: false
+options:
+  - label: "imgs/ / [auto-text] / [auto-mood] / [preset-aspect] (Recommended)"
+    description: "{article-dir}/imgs/, [text reason], [mood reason], [aspect source]"
+  - label: "same-dir / [auto-text] / [auto-mood] / [preset-aspect]"
+    description: "{article-dir}/, same directory as article"
+  - label: "independent / [auto-text] / [auto-mood] / [preset-aspect]"
+    description: "cover-image/{topic-slug}/, separate from article"
+```
+
+**When output dir already set** (preference exists or pasted content):
+
+```yaml
+header: "Settings"
+question: "Text / Mood / Aspect?"
+multiSelect: false
+options:
+  - label: "[auto-text] / [auto-mood] / [preset-aspect] (Recommended)"
+    description: "Auto-selected: [text reason], [mood reason], [aspect source]"
+  - label: "[auto-text] / bold / [preset-aspect]"
+    description: "High contrast, vivid — matches [content signal]"
+  - label: "[auto-text] / subtle / [preset-aspect]"
+    description: "Low contrast, muted — calm, professional"
+```
+
+*Note*: "Other" (auto-added) allows typing custom combo. Parse `/`-separated values matching the question format.
+
+## After Response
+
+Proceed to Step 3 with confirmed dimensions.
@@ -0,0 +1,229 @@
+# Step 3: Prompt Template
+
+Save to `prompts/cover.md`:
+
+```markdown
+---
+type: cover
+palette: [confirmed palette]
+rendering: [confirmed rendering]
+references:
+  - ref_id: 01
+    filename: refs/ref-01-{slug}.{ext}
+    usage: direct | style | palette
+  - ref_id: 02
+    filename: refs/ref-02-{slug}.{ext}
+    usage: direct | style | palette
+---
+
+# Content Context
+Article title: [full original title from source]
+Content summary: [2-3 sentence summary of key points and themes]
+Keywords: [5-8 key terms extracted from content]
+
+# Visual Design
+Cover theme: [2-3 words visual interpretation]
+Type: [confirmed type]
+Palette: [confirmed palette]
+Rendering: [confirmed rendering]
+Text level: [confirmed text level]
+Mood: [confirmed mood]
+Aspect ratio: [confirmed ratio]
+Language: [confirmed language]
+
+# Text Elements
+[Based on text level:]
+- none: "No text elements"
+- title-only: "Title: [exact title from source or user]"
+- title-subtitle: "Title: [title] / Subtitle: [context]"
+- text-rich: "Title: [title] / Subtitle: [context] / Tags: [2-4 keywords]"
+
+# Mood Application
+[Based on mood level:]
+- subtle: "Use low contrast, muted colors, light visual weight, calm aesthetic"
+- balanced: "Use medium contrast, normal saturation, balanced visual weight"
+- bold: "Use high contrast, vivid saturated colors, heavy visual weight, dynamic energy"
+
+# Composition
+Type composition:
+- [Type-specific layout and structure]
+
+Visual composition:
+- Main visual: [metaphor derived from content meaning]
+- Layout: [positioning based on type and aspect ratio]
+- Decorative: [palette-specific elements that reinforce content theme]
+
+Color scheme: [primary, background, accent from palette definition, adjusted by mood]
+Rendering notes: [key characteristics from rendering definition — lines, texture, depth, element style]
+Type notes: [key characteristics from type definition]
+Palette notes: [key characteristics from palette definition]
+
+[Watermark section if enabled]
+
+[Reference images section if provided — see below]
+```
+
+## Content-Driven Design
+
+- Article title and summary inform the visual metaphor choice
+- Keywords guide decorative elements and symbols
+- The skill controls visual style; the content drives meaning
+
+## Visual Element Selection
+
+Match content themes to icon vocabulary:
+
+| Content Theme | Suggested Elements |
+|---------------|-------------------|
+| Programming/Dev | Code window, terminal, API brackets, gear |
+| AI/ML | Brain, neural network, robot, circuit |
+| Growth/Business | Chart, rocket, plant, mountain, arrow |
+| Security | Lock, shield, key, fingerprint |
+| Communication | Speech bubble, megaphone, mail, handshake |
+| Tools/Methods | Wrench, checklist, pencil, puzzle |
+
+Full library: [../visual-elements.md](../visual-elements.md)
+
+## Type-Specific Composition
+
+| Type | Composition Guidelines |
+|------|------------------------|
+| `hero` | Large focal visual (60-70% area), title overlay on visual, dramatic composition |
+| `conceptual` | Abstract shapes representing core concepts, information hierarchy, clean zones |
+| `typography` | Title as primary element (40%+ area), minimal supporting visuals, strong hierarchy |
+| `metaphor` | Concrete object/scene representing abstract idea, symbolic elements, emotional resonance |
+| `scene` | Atmospheric environment, narrative elements, mood-setting lighting and colors |
+| `minimal` | Single focal element, generous whitespace (60%+), essential shapes only |
+
+## Title Guidelines
+
+When text level includes title:
+- **Source**: Use the exact title provided by user, or extract from source content
+- **Do NOT invent titles**: Stay faithful to the original
+- Match confirmed language
+
+## Watermark Application
+
+If enabled in preferences, add to prompt:
+
+```
+Include a subtle watermark "[content]" positioned at [position].
+The watermark should be legible but not distracting from the main content.
+```
+
+Reference: `config/watermark-guide.md`
+
+## Reference Image Handling
+
+When user provides reference images (`--ref` or pasted images):
+
+### ⚠️ CRITICAL - Frontmatter References
+
+**MUST add `references` field in YAML frontmatter** when reference files are saved to `refs/`:
+
+```yaml
+---
+type: cover
+palette: warm
+rendering: flat-vector
+references:
+  - ref_id: 01
+    filename: refs/ref-01-podcast-thumbnail.jpg
+    usage: style
+---
+```
+
+| Field | Description |
+|-------|-------------|
+| `ref_id` | Sequential number (01, 02, ...) |
+| `filename` | Relative path from prompt file's parent directory |
+| `usage` | `direct` / `style` / `palette` |
+
+**Omit `references` field entirely** if no reference files saved (style extracted verbally only).
+
+### When to Include References in Frontmatter
+
+| Situation | Frontmatter Action | Generation Action |
+|-----------|-------------------|-------------------|
+| Reference file saved to `refs/` | Add to `references` list ✓ | Pass via `--ref` parameter |
+| Style extracted verbally (no file) | Omit `references` field | Describe in prompt body only |
+| File path in frontmatter but doesn't exist | ERROR - fix or remove | Generation will fail |
+
+**Before writing prompt with references, verify**: `test -f refs/ref-NN-{slug}.{ext}`
+
+### Reference Usage Types
+
+| Usage | When to Use | Generation Action |
+|-------|-------------|-------------------|
+| `direct` | Reference matches desired output closely | Pass to `--ref` parameter |
+| `style` | Extract visual style characteristics only | Describe style in prompt text |
+| `palette` | Extract color palette only | Include colors in prompt |
+
+### Step 1: Analyze References
+
+For each reference image, extract:
+- **Style**: Rendering technique, line quality, texture
+- **Composition**: Layout, visual hierarchy, focal points
+- **Color mood**: Palette characteristics (without specific colors)
+- **Elements**: Key visual elements and symbols used
+
+### Step 2: Embed in Prompt
+
+**If file saved AND skill supports `--ref`** (e.g., baoyu-image-gen with Google):
+- Pass ref images directly via `--ref` parameter
+- Add brief style note in prompt:
+
+```
+# Reference Style
+Follow the visual style of the attached reference image(s):
+- [1-2 sentence style summary from analysis]
+```
+
+**If file saved BUT skill does NOT support `--ref`**:
+- Embed detailed text description in prompt:
+
+```
+# Reference Style (Text Description)
+Emulate the following visual style from reference image(s):
+
+Reference 1: [filename]
+- Style: [detailed rendering technique description]
+- Composition: [layout and hierarchy description]
+- Elements: [key visual elements used]
+- Mood: [emotional tone and visual weight]
+
+[Repeat for additional references]
+
+Apply these style characteristics to the cover design while maintaining the specified Type, Palette, and Rendering dimensions.
+```
+
+**If style/palette extracted verbally (NO file saved)**:
+- DO NOT add references metadata to prompt
+- Append extracted info directly to prompt body:
+
+```
+# Extracted Style (from reference)
+
+COLORS (from reference):
+- Primary: #E8756D coral
+- Secondary: #7ECFC0 mint
+...
+
+STYLE (from reference):
+- Clean lines, minimal shadows
+- Gradient backgrounds
+- Flat vector icons
+...
+```
+
+### Reference Analysis Template
+
+Use this format when analyzing reference images:
+
+| Aspect | Analysis Points |
+|--------|-----------------|
+| **Rendering** | Line quality (clean/sketchy/painted), texture presence, depth treatment |
+| **Composition** | Element placement, whitespace ratio, visual flow |
+| **Typography** | Font style, text placement, hierarchy (if present) |
+| **Elements** | Icon vocabulary, decorative motifs, character style |
+| **Mood** | Contrast level, saturation, visual weight |
@@ -1,15 +1,11 @@
 ---
 name: baoyu-danger-gemini-web
-description: Image generation skill using Gemini Web. Generates images from text prompts via Google Gemini. Also supports text generation. Use as the image generation backend for other skills like cover-image, xhs-images, article-illustrator.
+description: Generates images and text via reverse-engineered Gemini Web API. Supports text generation, image generation from prompts, reference images for vision input, and multi-turn conversations. Use when other skills need image generation backend, or when user requests "generate image with Gemini", "Gemini text generation", or needs vision-capable AI generation.
 ---

 # Gemini Web Client

-Supports:
- Text generation
- Image generation (download + save)
- Reference images for vision input (attach local images)
- Multi-turn conversations via persisted `--sessionId`
+Text/image generation via Gemini Web API. Supports reference images and multi-turn conversations.

 ## Script Directory

@@ -26,146 +22,73 @@ Supports:
 | `scripts/main.ts` | CLI entry point for text/image generation |
 | `scripts/gemini-webapi/*` | TypeScript port of `gemini_webapi` (GeminiClient, types, utils) |

-## ⚠️ Disclaimer (REQUIRED)
+## Consent Check (REQUIRED)

-**Before using this skill**, the consent check MUST be performed.
+Before first use, verify user consent for reverse-engineered API usage.

-### Consent Check Flow
+**Consent file locations**:
+- macOS: `~/Library/Application Support/baoyu-skills/gemini-web/consent.json`
+- Linux: `~/.local/share/baoyu-skills/gemini-web/consent.json`
+- Windows: `%APPDATA%\baoyu-skills\gemini-web\consent.json`

-**Step 1**: Check consent file
-
-```bash
-# macOS
-cat ~/Library/Application\ Support/baoyu-skills/gemini-web/consent.json 2>/dev/null
-
-# Linux
-cat ~/.local/share/baoyu-skills/gemini-web/consent.json 2>/dev/null
-
-# Windows (PowerShell)
-Get-Content "$env:APPDATA\baoyu-skills\gemini-web\consent.json" 2>$null
-```
-
-**Step 2**: If consent exists and `accepted: true` with matching `disclaimerVersion: "1.0"`:
-
-Print warning and proceed:
-```
-⚠️  Warning: Using reverse-engineered Gemini Web API (not official). Accepted on: <acceptedAt date>
-```
-
-**Step 3**: If consent file doesn't exist or `disclaimerVersion` mismatch:
-
-Display disclaimer and ask user:
-
-```
-⚠️  DISCLAIMER
-
-This tool uses a reverse-engineered Gemini Web API, NOT an official Google API.
-
-Risks:
- May break without notice if Google changes their API
- No official support or guarantees
- Use at your own risk
-
-Do you accept these terms and wish to continue?
-```
-
-Use `AskUserQuestion` tool with options:
- **Yes, I accept** - Continue and save consent
- **No, I decline** - Exit immediately
-
-**Step 4**: On acceptance, create consent file:
-
-```bash
-# macOS
-mkdir -p ~/Library/Application\ Support/baoyu-skills/gemini-web
-cat > ~/Library/Application\ Support/baoyu-skills/gemini-web/consent.json << 'EOF'
-{
-  "version": 1,
-  "accepted": true,
-  "acceptedAt": "<ISO timestamp>",
-  "disclaimerVersion": "1.0"
-}
-EOF
-
-# Linux
-mkdir -p ~/.local/share/baoyu-skills/gemini-web
-cat > ~/.local/share/baoyu-skills/gemini-web/consent.json << 'EOF'
-{
-  "version": 1,
-  "accepted": true,
-  "acceptedAt": "<ISO timestamp>",
-  "disclaimerVersion": "1.0"
-}
-EOF
-```
-
-**Step 5**: On decline, output message and stop:
-```
-User declined the disclaimer. Exiting.
-```
+**Flow**:
+1. Check if consent file exists with `accepted: true` and `disclaimerVersion: "1.0"`
+2. If valid consent exists → print warning with `acceptedAt` date, proceed
+3. If no consent → show disclaimer, ask user via `AskUserQuestion`:
+   - "Yes, I accept" → create consent file with ISO timestamp, proceed
+   - "No, I decline" → output decline message, stop
+4. Consent file format: `{"version":1,"accepted":true,"acceptedAt":"<ISO>","disclaimerVersion":"1.0"}`

 ---

-## Quick start
+## Preferences (EXTEND.md)
+
+Use Bash to check EXTEND.md existence (priority order):

 ```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts "Hello, Gemini"
-npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Explain quantum computing"
+# Check project-level first
+test -f .baoyu-skills/baoyu-danger-gemini-web/EXTEND.md && echo "project"
+
+# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
+test -f "$HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md" && echo "user"
+```
+
+┌──────────────────────────────────────────────────────────┬───────────────────┐
+│                           Path                           │     Location      │
+├──────────────────────────────────────────────────────────┼───────────────────┤
+│ .baoyu-skills/baoyu-danger-gemini-web/EXTEND.md          │ Project directory │
+├──────────────────────────────────────────────────────────┼───────────────────┤
+│ $HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md    │ User home         │
+└──────────────────────────────────────────────────────────┴───────────────────┘
+
+┌───────────┬───────────────────────────────────────────────────────────────────────────┐
+│  Result   │                                  Action                                   │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Found     │ Read, parse, apply settings                                               │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Not found │ Use defaults                                                              │
+└───────────┴───────────────────────────────────────────────────────────────────────────┘
+
+**EXTEND.md Supports**: Default model | Proxy settings | Custom data directory
+
+## Usage
+
+```bash
+# Text generation
+npx -y bun ${SKILL_DIR}/scripts/main.ts "Your prompt"
+npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Your prompt" --model gemini-2.5-pro
+
+# Image generation
 npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cute cat" --image cat.png
 npx -y bun ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png

-# Multi-turn conversation (agent generates unique sessionId)
-npx -y bun ${SKILL_DIR}/scripts/main.ts "Remember this: 42" --sessionId my-unique-id-123
-npx -y bun ${SKILL_DIR}/scripts/main.ts "What number?" --sessionId my-unique-id-123
-```
+# Vision input (reference images)
+npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Describe this" --reference image.png
+npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Create variation" --reference a.png --image out.png

-## Commands
-
-### Text generation
-
-```bash
-# Simple prompt (positional)
-npx -y bun ${SKILL_DIR}/scripts/main.ts "Your prompt here"
-
-# Explicit prompt flag
-npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Your prompt here"
-npx -y bun ${SKILL_DIR}/scripts/main.ts -p "Your prompt here"
-
-# With model selection
-npx -y bun ${SKILL_DIR}/scripts/main.ts -p "Hello" -m gemini-2.5-pro
-
-# Pipe from stdin
-echo "Summarize this" | npx -y bun ${SKILL_DIR}/scripts/main.ts
-```
-
-### Image generation
-
-```bash
-# Generate image with default path (./generated.png)
-npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A sunset over mountains" --image
-
-# Generate image with custom path
-npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cute robot" --image robot.png
-
-# Shorthand
-npx -y bun ${SKILL_DIR}/scripts/main.ts "A dragon" --image=dragon.png
-```
-
-### Vision input (reference images)
-
-```bash
-# Text + image -> text
-npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Describe this image" --reference a.png
-
-# Text + image -> image
-npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Generate a variation" --reference a.png --image out.png
-```
-
-### Output formats
-
-```bash
-# Plain text (default)
-npx -y bun ${SKILL_DIR}/scripts/main.ts "Hello"
+# Multi-turn conversation
+npx -y bun ${SKILL_DIR}/scripts/main.ts "Remember: 42" --sessionId session-abc
+npx -y bun ${SKILL_DIR}/scripts/main.ts "What number?" --sessionId session-abc

 # JSON output
 npx -y bun ${SKILL_DIR}/scripts/main.ts "Hello" --json
@@ -175,45 +98,35 @@ npx -y bun ${SKILL_DIR}/scripts/main.ts "Hello" --json

 | Option | Description |
 |--------|-------------|
-| `--prompt <text>`, `-p` | Prompt text |
-| `--promptfiles <files...>` | Read prompt from files (concatenated in order) |
-| `--model <id>`, `-m` | Model: gemini-3-pro (default), gemini-2.5-pro, gemini-2.5-flash |
-| `--image [path]` | Generate image, save to path (default: generated.png) |
-| `--reference <files...>`, `--ref <files...>` | Reference images for vision input |
-| `--sessionId <id>` | Session ID for multi-turn conversation (agent generates unique ID) |
-| `--list-sessions` | List saved sessions (max 100, sorted by update time) |
+| `--prompt`, `-p` | Prompt text |
+| `--promptfiles` | Read prompt from files (concatenated) |
+| `--model`, `-m` | Model: gemini-3-pro (default), gemini-2.5-pro, gemini-2.5-flash |
+| `--image [path]` | Generate image (default: generated.png) |
+| `--reference`, `--ref` | Reference images for vision input |
+| `--sessionId` | Session ID for multi-turn conversation |
+| `--list-sessions` | List saved sessions |
 | `--json` | Output as JSON |
-| `--login` | Refresh cookies only, then exit |
-| `--cookie-path <path>` | Custom cookie file path |
-| `--profile-dir <path>` | Chrome profile directory |
-| `--help`, `-h` | Show help |
-
-CLI note: `scripts/main.ts` supports text generation, image generation, reference images (`--reference/--ref`), and multi-turn conversations via `--sessionId`.
+| `--login` | Refresh cookies, then exit |
+| `--cookie-path` | Custom cookie file path |
+| `--profile-dir` | Chrome profile directory |

 ## Models

- `gemini-3-pro` - Default, latest model
- `gemini-2.5-pro` - Previous generation pro
- `gemini-2.5-flash` - Fast, lightweight
+| Model | Description |
+|-------|-------------|
+| `gemini-3-pro` | Default, latest |
+| `gemini-2.5-pro` | Previous pro |
+| `gemini-2.5-flash` | Fast, lightweight |

 ## Authentication

-First run opens a browser to authenticate with Google. Cookies are cached for subsequent runs.
+First run opens browser for Google auth. Cookies cached automatically.

-**Supported browsers** (auto-detected in order):
- Google Chrome
- Google Chrome Canary / Beta
- Chromium
- Microsoft Edge
+Supported browsers (auto-detected): Chrome, Chrome Canary/Beta, Chromium, Edge.

-Override with `GEMINI_WEB_CHROME_PATH` environment variable if needed.
+Force refresh: `--login` flag. Override browser: `GEMINI_WEB_CHROME_PATH` env var.

-```bash
-# Force cookie refresh
-npx -y bun ${SKILL_DIR}/scripts/main.ts --login
-```
-
-## Environment variables
+## Environment Variables

 | Variable | Description |
 |----------|-------------|
@@ -221,72 +134,14 @@ npx -y bun ${SKILL_DIR}/scripts/main.ts --login
 | `GEMINI_WEB_COOKIE_PATH` | Cookie file path |
 | `GEMINI_WEB_CHROME_PROFILE_DIR` | Chrome profile directory |
 | `GEMINI_WEB_CHROME_PATH` | Chrome executable path |
+| `HTTP_PROXY`, `HTTPS_PROXY` | Proxy for Google access (set inline with command) |

-## Proxy Configuration
+## Sessions

-If you need a proxy to access Google services (e.g., in China), set `HTTP_PROXY` and `HTTPS_PROXY` environment variables before running:
+Session files stored in data directory under `sessions/<id>.json`.

-```bash
-# Example with local proxy
-HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 npx -y bun ${SKILL_DIR}/scripts/main.ts "Hello"
-
-# Image generation with proxy
-HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image cat.png
-
-# Cookie refresh with proxy
-HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 npx -y bun ${SKILL_DIR}/scripts/main.ts --login
-```
-
-**Note**: Environment variables must be set inline with the command. Shell profile settings (e.g., `.bashrc`) may not be inherited by subprocesses.
-
-## Examples
-
-### Generate text response
-```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts "What is the capital of France?"
-```
-
-### Generate image
-```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts "A photorealistic image of a golden retriever puppy" --image puppy.png
-```
-
-### Get JSON output for parsing
-```bash
-npx -y bun ${SKILL_DIR}/scripts/main.ts "Hello" --json | jq '.text'
-```
-
-### Generate image from prompt files
-```bash
-# Concatenate system.md + content.md as prompt
-npx -y bun ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image output.png
-```
-
-### Multi-turn conversation
-```bash
-# Start a session with unique ID (agent generates this)
-npx -y bun ${SKILL_DIR}/scripts/main.ts "You are a helpful math tutor." --sessionId task-abc123
-
-# Continue the conversation (remembers context)
-npx -y bun ${SKILL_DIR}/scripts/main.ts "What is 2+2?" --sessionId task-abc123
-npx -y bun ${SKILL_DIR}/scripts/main.ts "Now multiply that by 10" --sessionId task-abc123
-
-# List recent sessions (max 100, sorted by update time)
-npx -y bun ${SKILL_DIR}/scripts/main.ts --list-sessions
-```
-
-Session files are stored in `~/Library/Application Support/baoyu-skills/gemini-web/sessions/<id>.json` and contain:
- `id`: Session ID
- `metadata`: Gemini chat metadata for continuation
- `messages`: Array of `{role, content, timestamp, error?}`
- `createdAt`, `updatedAt`: Timestamps
+Contains: `id`, `metadata` (Gemini chat state), `messages` array, timestamps.

 ## Extension Support

-Custom configurations via EXTEND.md.
-
-**Check paths** (priority order):
-1. `.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md` (project)
-2. `~/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md` (user)
-
-If found, load before workflow. Extension content overrides defaults.
+Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.
@@ -1,119 +1,107 @@
 ---
 name: baoyu-danger-x-to-markdown
-description: Convert X (Twitter) tweet or article URL to markdown. Uses reverse-engineered X API (private). Requires user consent before use.
+description: Converts X (Twitter) tweets and articles to markdown with YAML front matter. Uses reverse-engineered API requiring user consent. Use when user mentions "X to markdown", "tweet to markdown", "save tweet", or provides x.com/twitter.com URLs for conversion.
 ---

 # X to Markdown

-Converts X (Twitter) content to markdown format:
- Tweet threads → Markdown with YAML front matter
- X Articles → Full article content extraction
+Converts X content to markdown:
+- Tweets/threads → Markdown with YAML front matter
+- X Articles → Full content extraction

 ## Script Directory

-**Important**: All scripts are located in the `scripts/` subdirectory of this skill.
+Scripts located in `scripts/` subdirectory.

-**Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
-3. Replace all `${SKILL_DIR}` in this document with the actual path
+**Path Resolution**:
+1. `SKILL_DIR` = this SKILL.md's directory
+2. Script path = `${SKILL_DIR}/scripts/main.ts`

-**Script Reference**:
-| Script | Purpose |
-|--------|---------|
-| `scripts/main.ts` | CLI entry point for URL conversion |
+## Consent Requirement

-## ⚠️ Disclaimer (REQUIRED)
+**Before any conversion**, check and obtain consent.

-**Before using this skill**, the consent check MUST be performed.
-
-### Consent Check Flow
+### Consent Flow

 **Step 1**: Check consent file

 ```bash
 # macOS
-cat ~/Library/Application\ Support/baoyu-skills/x-to-markdown/consent.json 2>/dev/null
+cat ~/Library/Application\ Support/baoyu-skills/x-to-markdown/consent.json

 # Linux
-cat ~/.local/share/baoyu-skills/x-to-markdown/consent.json 2>/dev/null
-
-# Windows (PowerShell)
-Get-Content "$env:APPDATA\baoyu-skills\x-to-markdown\consent.json" 2>$null
+cat ~/.local/share/baoyu-skills/x-to-markdown/consent.json
 ```

-**Step 2**: If consent exists and `accepted: true` with matching `disclaimerVersion: "1.0"`:
-
-Print warning and proceed:
+**Step 2**: If `accepted: true` and `disclaimerVersion: "1.0"` → print warning and proceed:
 ```
-⚠️  Warning: Using reverse-engineered X API (not official). Accepted on: <acceptedAt date>
+Warning: Using reverse-engineered X API. Accepted on: <acceptedAt>
 ```

-**Step 3**: If consent file doesn't exist or `disclaimerVersion` mismatch:
-
-Display disclaimer and ask user:
-
+**Step 3**: If missing or version mismatch → display disclaimer:
 ```
-⚠️  DISCLAIMER
+DISCLAIMER

-This tool uses a reverse-engineered X (Twitter) API, NOT an official API.
+This tool uses a reverse-engineered X API, NOT official.

 Risks:
- May break without notice if X changes their API
- No official support or guarantees
- Account restrictions possible if API usage detected
+- May break if X changes API
+- No guarantees or support
+- Possible account restrictions
 - Use at your own risk

-Do you accept these terms and wish to continue?
+Accept terms and continue?
 ```

-Use `AskUserQuestion` tool with options:
- **Yes, I accept** - Continue and save consent
- **No, I decline** - Exit immediately
+Use `AskUserQuestion` with options: "Yes, I accept" | "No, I decline"

-**Step 4**: On acceptance, create consent file:
+**Step 4**: On accept → create consent file:
+```json
+{
+  "version": 1,
+  "accepted": true,
+  "acceptedAt": "<ISO timestamp>",
+  "disclaimerVersion": "1.0"
+}
+```
+
+**Step 5**: On decline → output "User declined. Exiting." and stop.
+
+## Preferences (EXTEND.md)
+
+Use Bash to check EXTEND.md existence (priority order):

 ```bash
-# macOS
-mkdir -p ~/Library/Application\ Support/baoyu-skills/x-to-markdown
-cat > ~/Library/Application\ Support/baoyu-skills/x-to-markdown/consent.json << 'EOF'
-{
-  "version": 1,
-  "accepted": true,
-  "acceptedAt": "<ISO timestamp>",
-  "disclaimerVersion": "1.0"
-}
-EOF
+# Check project-level first
+test -f .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md && echo "project"

-# Linux
-mkdir -p ~/.local/share/baoyu-skills/x-to-markdown
-cat > ~/.local/share/baoyu-skills/x-to-markdown/consent.json << 'EOF'
-{
-  "version": 1,
-  "accepted": true,
-  "acceptedAt": "<ISO timestamp>",
-  "disclaimerVersion": "1.0"
-}
-EOF
+# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
+test -f "$HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md" && echo "user"
 ```

-**Step 5**: On decline, output message and stop:
-```
-User declined the disclaimer. Exiting.
-```
+┌────────────────────────────────────────────────────────────┬───────────────────┐
+│                            Path                            │     Location      │
+├────────────────────────────────────────────────────────────┼───────────────────┤
+│ .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md         │ Project directory │
+├────────────────────────────────────────────────────────────┼───────────────────┤
+│ $HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md   │ User home         │
+└────────────────────────────────────────────────────────────┴───────────────────┘

---
+┌───────────┬───────────────────────────────────────────────────────────────────────────┐
+│  Result   │                                  Action                                   │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Found     │ Read, parse, apply settings                                               │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Not found │ Use defaults                                                              │
+└───────────┴───────────────────────────────────────────────────────────────────────────┘
+
+**EXTEND.md Supports**: Default output directory | Output format preferences

 ## Usage

 ```bash
-# Convert tweet (outputs markdown path)
 npx -y bun ${SKILL_DIR}/scripts/main.ts <url>
-
-# Save to specific file
 npx -y bun ${SKILL_DIR}/scripts/main.ts <url> -o output.md
-
-# JSON output
 npx -y bun ${SKILL_DIR}/scripts/main.ts <url> --json
 ```

@@ -122,56 +110,35 @@ npx -y bun ${SKILL_DIR}/scripts/main.ts <url> --json
 | Option | Description |
 |--------|-------------|
 | `<url>` | Tweet or article URL |
-| `-o <path>` | Output path (file or dir) |
-| `--json` | Output as JSON |
+| `-o <path>` | Output path |
+| `--json` | JSON output |
 | `--login` | Refresh cookies only |

-## File Structure
-
-```
-x-to-markdown/
-└── {username}/
-    └── {tweet-id}.md
-```
-
 ## Supported URLs

 - `https://x.com/<user>/status/<id>`
 - `https://twitter.com/<user>/status/<id>`
 - `https://x.com/i/article/<id>`

-## Output Format
+## Output

 ```markdown
 ---
-url: https://x.com/username/status/123
-author: "Display Name (@username)"
+url: https://x.com/user/status/123
+author: "Name (@user)"
 tweet_count: 3
 ---

-Tweet content...
-
---
-
-Thread continuation...
+Content...
 ```

+**File structure**: `x-to-markdown/{username}/{tweet-id}.md`
+
 ## Authentication

-**Option 1**: Environment variables (recommended)
- `X_AUTH_TOKEN` - auth_token cookie
- `X_CT0` - ct0 cookie
-
-**Option 2**: Chrome login (auto if env vars not set)
- First run opens Chrome for login
- Cookies cached locally
+1. **Environment variables** (preferred): `X_AUTH_TOKEN`, `X_CT0`
+2. **Chrome login** (fallback): Auto-opens Chrome, caches cookies locally

 ## Extension Support

-Custom configurations via EXTEND.md.
-
-**Check paths** (priority order):
-1. `.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md` (project)
-2. `~/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md` (user)
-
-If found, load before workflow. Extension content overrides defaults.
+Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Jim Liu 宝玉	7c36b2a6a5	chore: release v1.28.0	2026-02-01 19:49:49 -06:00
Jim Liu 宝玉	7979cb9dde	chore: ignore baoyu-skill-evolution directory	2026-02-01 19:49:22 -06:00
Jim Liu 宝玉	e563bbae7b	feat(baoyu-post-to-wechat): add newspic article type support - Add ArticleOptions interface with news/newspic types - Track all image media IDs for newspic format - Restructure publishToDraft for dual article type handling	2026-02-01 19:49:14 -06:00
Jim Liu 宝玉	c63d1eec69	refactor(baoyu-xhs-images): enforce blocking first-time setup - Mark preferences loading as BLOCKING operation - Update workflow flow diagram and checklist	2026-02-01 19:49:05 -06:00
Jim Liu 宝玉	78d6d23359	refactor(baoyu-comic): enforce blocking first-time setup - Mark preferences loading as BLOCKING operation - Update workflow flow diagram	2026-02-01 19:48:56 -06:00
Jim Liu 宝玉	ec6781a231	feat(baoyu-article-illustrator): add reference image support - Add reference image handling with direct/style/palette usage types - Enhance first-time setup as blocking operation - Update prompt construction with reference frontmatter format	2026-02-01 19:48:46 -06:00
Jim Liu 宝玉	edf9030675	feat(baoyu-cover-image): add reference image support and visual elements library - Add --ref parameter for reference images (style/palette/direct usage) - Add visual-elements.md with icon vocabulary by topic - Enhance first-time setup as blocking operation - Remove character limits from titles, use original source titles - Update prompt template with reference handling	2026-02-01 19:48:37 -06:00
Jim Liu 宝玉	10e1c426a0	chore: release v1.27.0	2026-02-01 02:15:08 -06:00
Jim Liu 宝玉	dbab83ff82	feat(baoyu-markdown-to-html): add remark-cjk-friendly for CJK emphasis Preprocess markdown with remark-cjk-friendly to properly handle CJK emphasis markers before HTML conversion.	2026-02-01 02:14:12 -06:00
Jim Liu 宝玉	478e66a93a	docs(baoyu-infographic): clarify AskUserQuestion usage Emphasize combining multiple questions into single call.	2026-02-01 02:14:06 -06:00
Jim Liu 宝玉	3a5866eb4b	refactor(baoyu-format-markdown): use remark-cjk-friendly for CJK emphasis Replace custom CJK emphasis handling with remark-cjk-friendly library, significantly simplifying the codebase.	2026-02-01 02:13:58 -06:00
Jim Liu 宝玉	c0162bb3af	chore: release v1.26.1	2026-01-29 22:02:42 -06:00
Jim Liu 宝玉	e9342a16f8	fix(baoyu-xhs-images): remove notebook style, add backup rules for prompts and images	2026-01-29 22:01:47 -06:00
Jim Liu 宝玉	5cb86d8e51	feat(baoyu-slide-deck): add backup rules for source, prompt, and slide image files	2026-01-29 22:01:42 -06:00
Jim Liu 宝玉	66ed08f010	feat(baoyu-infographic): add backup rules for source, analysis, prompt, and image files	2026-01-29 22:01:22 -06:00
Jim Liu 宝玉	b179166d28	feat(baoyu-cover-image): add backup rules for source and prompt files	2026-01-29 22:01:17 -06:00
Jim Liu 宝玉	4805526649	feat(baoyu-comic): add backup rules for source, character sheet, prompts, and page images	2026-01-29 22:00:59 -06:00
Jim Liu 宝玉	89159bf86e	feat(baoyu-article-illustrator): add backup rules for source, prompt, and image files	2026-01-29 22:00:37 -06:00
Jim Liu 宝玉	b45b5d2c6e	chore: release v1.26.0	2026-01-29 20:59:45 -06:00
Jim Liu 宝玉	62866426c5	feat(baoyu-xhs-images): add notebook and study-notes styles with mindmap and quadrant layouts - notebook: hand-drawn infographic style with watercolor rendering and Morandi palette - study-notes: realistic handwritten photo style with blue pen, red annotations, yellow highlighter - mindmap: center radial layout (4-8 branches) - quadrant: four-quadrant / circular section layout	2026-01-29 20:59:24 -06:00
Jim Liu 宝玉	28a7db6129	chore: release v1.25.4	2026-01-29 17:17:58 -06:00
Jim Liu 宝玉	7c5e81fd15	chore: release v1.25.3	2026-01-28 22:31:47 -06:00
Jim Liu 宝玉	058d25d02c	feat(baoyu-format-markdown): add content type detection and CJK punctuation handling	2026-01-28 22:31:25 -06:00
Jim Liu 宝玉	fe09ec546f	chore: release v1.25.2	2026-01-28 22:10:32 -06:00
Jim Liu 宝玉	cf611a4514	docs(baoyu-post-to-wechat): add WeChat API credentials configuration guide	2026-01-28 22:10:27 -06:00
Jim Liu 宝玉	7cf30e969f	chore: release v1.25.1	2026-01-28 21:49:51 -06:00
Jim Liu 宝玉	18b71157db	feat(baoyu-markdown-to-html): add CJK content pre-check step Suggest formatting with baoyu-format-markdown before conversion to fix bold markers with punctuation issues.	2026-01-28 21:49:47 -06:00
Jim Liu 宝玉	9904c490e4	chore: release v1.25.0	2026-01-28 21:38:06 -06:00
Jim Liu 宝玉	32ed09128c	docs: add baoyu-format-markdown and baoyu-markdown-to-html to plugin registry	2026-01-28 21:37:49 -06:00
Jim Liu 宝玉	81e96ee43c	feat(baoyu-post-to-wechat): add API publishing and external theme support - Add wechat-api.ts for direct API-based article publishing - Support plain text, HTML, and markdown inputs with auto-conversion - Add external theme discovery from MD_THEME_DIR environment variable - Improve CSS inlining with juice library integration - Support WeChat API credentials via .baoyu-skills/.env	2026-01-28 21:37:40 -06:00
Jim Liu 宝玉	5f994589b3	feat(baoyu-markdown-to-html): add markdown to HTML converter skill Converts markdown to styled HTML with inline CSS, code highlighting, math, PlantUML, footnotes, alerts, and WeChat-compatible themes.	2026-01-28 21:37:30 -06:00
Jim Liu 宝玉	40363194be	feat(baoyu-format-markdown): add markdown formatter skill Formats plain text or markdown with frontmatter, titles, summaries, headings, bold, lists, code blocks, and CJK typography fixes.	2026-01-28 21:37:23 -06:00
Jim Liu 宝玉	21a5167b61	chore: release v1.24.4	2026-01-28 14:54:44 -06:00
Jim Liu 宝玉	4d3957ca06	fix(baoyu-post-to-x): ensure Apply button click closes modal before continuing	2026-01-28 14:54:39 -06:00
Jim Liu 宝玉	013c72fce7	chore: release v1.24.3	2026-01-28 13:56:48 -06:00
Jim Liu 宝玉	40fadcb1f6	docs: emphasize updating prompt files before regenerating	2026-01-28 13:56:35 -06:00
Jim Liu 宝玉	499a1ee478	chore: release v1.24.2	2026-01-28 13:14:44 -06:00
Jim Liu 宝玉	fa89eaf2f7	refactor(baoyu-image-gen): default to sequential generation	2026-01-28 13:14:39 -06:00
Jim Liu 宝玉	7964e20bc3	chore: release v1.24.1	2026-01-28 12:29:43 -06:00
Jim Liu 宝玉	45c109ce88	Merge pull request #27 from JianJang2017/my-baoyu-skills Adapting baoyu-image-gen to the Tongyi Text-to-Image Model	2026-01-28 12:23:34 -06:00
jianzhang50	74c08def06	docs: add Aliyun text-to-image model config to README.md	2026-01-28 22:04:53 +08:00
jianzhang50	907c8ab852	Adapting baoyu-image-gen to the Tongyi Text-to-Image Model	2026-01-28 09:04:57 +08:00
Jim Liu 宝玉	64945f3341	chore: release v1.24.0	2026-01-27 10:10:44 -06:00
Jim Liu 宝玉	050d37c344	docs: backfill third-party contributor attributions in changelogs	2026-01-27 10:06:22 -06:00
Jim Liu 宝玉	f9f168fc1f	docs(release-skills): add third-party contributor attribution to release workflow	2026-01-27 10:06:15 -06:00
Jim Liu 宝玉	b1af3a3e45	fix(baoyu-post-to-wechat): improve title extraction, summary auto-fill, and content verification	2026-01-27 10:06:11 -06:00
Jim Liu 宝玉	0727296592	Merge pull request #23 from AliceLJY/feat/reuse-existing-chrome feat(baoyu-post-to-wechat): reuse existing Chrome instead of requiring all windows closed	2026-01-27 08:03:46 -06:00
Jim Liu 宝玉	0e571b72fb	chore: release v1.23.1	2026-01-27 00:59:34 -06:00
Jim Liu 宝玉	366630f8c3	fix(baoyu-compress-image): rename original as backup instead of deleting	2026-01-27 00:59:30 -06:00
安闲静雅	6bfafe0ec5	feat(baoyu-post-to-wechat): reuse existing Chrome instead of requiring all windows closed Previously, the script always launched a new Chrome instance, which failed when Chrome was already running due to profile lock conflicts on macOS. Users had to close all Chrome windows before publishing. This change adds auto-detection of existing Chrome debug ports and reuses an already-logged-in WeChat tab when available, falling back to launching a new instance only when no existing Chrome is found. Changes: - cdp.ts: add tryConnectExisting() and findExistingChromeDebugPort() - wechat-article.ts: try existing Chrome before launching new one, reuse logged-in WeChat tab (identified by token= in URL), add waitForElement() for reliable menu detection, add --cdp-port option for manual override, fix process not exiting after completion Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 13:16:33 +08:00
Jim Liu 宝玉	5e597f0a8b	chore: release v1.23.0	2026-01-26 11:36:06 -06:00
Jim Liu 宝玉	40f4d2f730	refactor(baoyu-cover-image): replace 20 styles with 5D palette×rendering system Migrate from 4-dimension (Type×Style×Text×Mood) to 5-dimension (Type×Palette×Rendering×Text×Mood) system. 9 palettes × 6 renderings = 54 combinations replacing 20 fixed styles. Add style presets for backward compatibility, v2→v3 schema migration, and new reference structure (palettes/, renderings/, workflow/).	2026-01-26 11:32:30 -06:00
Jim Liu 宝玉	b12ae7374d	chore: release v1.22.0	2026-01-25 21:05:37 -06:00
Jim Liu 宝玉	1afa6f5a58	refactor(baoyu-post-to-x): simplify image placeholders from bracket format to XIMGPH	2026-01-25 21:05:08 -06:00
Jim Liu 宝玉	977598d5ae	feat(baoyu-post-to-wechat): add theme selection, HTML preview, and simplify image placeholders	2026-01-25 21:05:04 -06:00
Jim Liu 宝玉	eb738aa61a	feat(baoyu-cover-image): add default_output_dir preference with output directory selection	2026-01-25 21:04:59 -06:00
Jim Liu 宝玉	e9a030f917	feat(baoyu-article-illustrator): add imgs-subdir output option and improve style selection	2026-01-25 21:04:56 -06:00
Jim Liu 宝玉	e6a9b217e6	chore: release v1.21.4	2026-01-25 16:10:08 -06:00
Jim Liu 宝玉	ec1743592c	fix(baoyu-post-to-wechat): fix regressions from Windows compatibility PR - Fix broken md-to-wechat-fixed.ts/wechat-article-fixed.ts filename references that cause runtime crash (files were never renamed) - Restore frontmatter quote stripping for title/summary values - Restore --title CLI parameter functionality (was silently ignored) - Fix summary extraction to properly skip headings, quotes, lists - Fix argument parsing to reject single-dash args as file paths - Remove debug console.error logs left from development	2026-01-25 16:09:24 -06:00
Jim Liu 宝玉	fe647a11bb	Merge pull request #20 from JadeLiang003/fix/windows-copy-paste-support Fix: Windows compatibility for baoyu-post-to-wechat	2026-01-25 16:04:01 -06:00
JadeLiang	5a11b49b00	Fix: Windows compatibility for baoyu-post-to-wechat ## Problem The baoyu-post-to-wechat skill failed on Windows due to: 1. `new URL(import.meta.url).pathname` returns incorrect path format on Windows 2. Copy/paste operations used `xdotool` (Linux tool) which doesn't exist on Windows ## Solution 1. md-to-wechat.ts: Use `fileURLToPath()` to correctly resolve file paths on Windows 2. wechat-article.ts: Use CDP `Input.dispatchKeyEvent` for copy/paste operations - Replaces system-dependent tools (xdotool/osascript) - Works consistently across Windows/macOS/Linux - More reliable as it operates within Chrome session ## Changes - Import `fileURLToPath` from 'node:url' - Replace `new URL(import.meta.url).pathname` with `fileURLToPath(import.meta.url)` - Replace system tool calls with CDP keyboard events for Ctrl+C and Ctrl+V - Add platform-specific modifier handling (Cmd for macOS, Ctrl for Windows/Linux) ## Testing - Tested successfully on Windows 11 - Markdown conversion works correctly - HTML copy/paste to WeChat editor works correctly Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-01-25 15:24:04 +08:00
Jim Liu 宝玉	04692515bb	fix: remove opacity of watermark	2026-01-24 17:23:04 -06:00
Jim Liu 宝玉	eb54c2a2e7	chore: release v1.21.3	2026-01-24 17:20:02 -06:00
Jim Liu 宝玉	a39c8eb0bd	refactor(baoyu-article-illustrator): extract content to reference files - Simplify SKILL.md by extracting usage and prompt templates - Add references/usage.md for command syntax - Add references/prompt-construction.md for prompt templates - Add default_output_dir preference option - Reorganize workflow from 5 to 6 steps with Pre-check phase	2026-01-24 17:19:42 -06:00
Jim Liu 宝玉	715555c2ab	chore: release v1.21.2	2026-01-24 13:37:58 -06:00
Jim Liu 宝玉	02b039f2ff	feat(baoyu-image-gen): add parallel generation documentation	2026-01-24 13:37:42 -06:00
Jim Liu 宝玉	00306414fe	docs(release-skills): add skill grouping and user confirmation workflow	2026-01-24 13:37:38 -06:00
Jim Liu 宝玉	db1179e057	chore: release v1.21.1	2026-01-24 13:25:15 -06:00
Jim Liu 宝玉	7b0c9ca372	chore: release v1.21.0	2026-01-24 03:33:10 -06:00
Jim Liu 宝玉	e7255efdd6	chore: release v1.20.0	2026-01-24 02:30:28 -06:00
Jim Liu 宝玉	b15a95e73d	chore: release v1.19.0	2026-01-24 01:24:41 -06:00
Jim Liu 宝玉	07af3c4c21	chore: release v1.18.3	2026-01-23 21:08:11 -06:00
Jim Liu 宝玉	7842e4d188	chore: release v1.18.2	2026-01-23 16:10:04 -06:00
Jim Liu 宝玉	fcd49cd5ea	chore: release v1.18.1	2026-01-23 14:59:23 -06:00
Jim Liu 宝玉	f454257b5c	chore: release v1.18.0	2026-01-23 14:32:21 -06:00
Jim Liu 宝玉	b1cbd1d527	chore: release v1.17.1	2026-01-23 12:23:13 -06:00
Jim Liu 宝玉	7500a3b106	chore: release v1.17.0	2026-01-23 12:19:26 -06:00
Jim Liu 宝玉	658c5dee71	chore: release v1.16.0	2026-01-23 12:15:56 -06:00
Jim Liu 宝玉	8d04b71700	chore: release v1.15.3	2026-01-23 12:08:37 -06:00