chore: release v1.57.0

refactor(baoyu-xhs-images): use skill interface instead of direct script invocation for image generation
refactor(baoyu-comic): use skill interface instead of direct script invocation for image generation
2026-07-12 05:51:44 +08:00 · 2026-03-08 19:24:45 -05:00 · 2026-03-08 19:24:03 -05:00 · 2026-03-08 19:24:02 -05:00 · 2026-03-08 19:22:24 -05:00 · 2026-03-08 19:22:19 -05:00
61 changed files with 2724 additions and 486 deletions
@@ -6,7 +6,7 @@
  },
  "metadata": {
    "description": "Skills shared by Baoyu for improving daily work efficiency",
-    "version": "1.52.0"
+    "version": "1.57.0"
  },
  "plugins": [
    {
@@ -161,3 +161,6 @@ posts/
 *.ipr

 .claude/skills/baoyu-skill-evolution
+# ClawHub local state (current and legacy directory names from the official CLI)
+.clawhub/
+.clawdhub/
@@ -2,6 +2,65 @@

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

+## 1.57.0 - 2026-03-08
+
+### Features
+- Add ClawHub/OpenClaw publishing support with sync script and README documentation
+
+### Refactor
+- Add openclaw metadata to all skill frontmatter for ClawHub registry compatibility
+- Rename `SKILL_DIR` to `baseDir` across all skills for consistency
+- `baoyu-danger-gemini-web`, `baoyu-danger-x-to-markdown`: dynamic script path in usage display
+- `baoyu-comic`, `baoyu-xhs-images`: use skill interface instead of direct script invocation for image generation
+
+## 1.56.1 - 2026-03-08
+
+### Fixes
+- `baoyu-post-to-weibo`: simplify article image insertion with Backspace-based placeholder deletion for ProseMirror compatibility
+
+## 1.56.0 - 2026-03-08
+
+### Features
+- `baoyu-article-illustrator`: preset-first selection flow with categorized style presets by content type
+- `baoyu-xhs-images`: streamline workflow from 6 to 4 steps with Smart Confirm (Quick/Customize/Detailed paths)
+
+### Fixes
+- `baoyu-post-to-wechat`: improve image upload reliability with file chooser interception and fallback
+
+## 1.55.0 - 2026-03-08
+
+### Features
+- `baoyu-article-illustrator`: add screen-print style and `--preset` flag for quick type + style selection
+- `baoyu-cover-image`: add screen-print rendering and duotone palette with 5 new style presets
+- `baoyu-xhs-images`: add screen-print style and `--preset` flag with 23 built-in presets
+
+### Documentation
+- Add credits section to both READMEs acknowledging open source inspirations
+
+## 1.54.1 - 2026-03-07
+
+### Fixes
+- `baoyu-post-to-x`: keep composed posts open in Chrome so users can review and publish manually
+
+### Documentation
+- `baoyu-post-to-x`: document default post type selection and manual publishing flow
+- `README`: add Star History charts to the English and Chinese READMEs
+
+## 1.54.0 - 2026-03-06
+
+### Features
+- `baoyu-format-markdown`: improve title and summary generation with style-differentiated candidates, prohibited patterns, and hook-first principles
+- `baoyu-markdown-to-html`: add `--cite` option to convert ordinary external links to numbered bottom citations
+- `baoyu-post-to-wechat`: enable bottom citations by default for markdown input, add `--no-cite` flag to disable
+- `baoyu-translate`: support external glossary files via `glossary_files` in EXTEND.md (markdown table or YAML)
+- `baoyu-translate`: add frontmatter transformation rules to rename source metadata fields with `source` prefix
+
+## 1.53.0 - 2026-03-06
+
+### Features
+- `baoyu-url-to-markdown`: save rendered HTML snapshot as `-captured.html` alongside markdown output
+- `baoyu-url-to-markdown`: Defuddle-first markdown conversion with automatic fallback to legacy Readability/selector extractor
+
 ## 1.52.0 - 2026-03-06

 ### Features
@@ -2,6 +2,65 @@

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

+## 1.57.0 - 2026-03-08
+
+### 新功能
+- 新增 ClawHub/OpenClaw 发布支持，包含同步脚本和 README 文档
+
+### 重构
+- 为所有 skill 前言添加 openclaw 元数据，兼容 ClawHub 注册表
+- 全部 skill 中将 `SKILL_DIR` 统一重命名为 `baseDir`
+- `baoyu-danger-gemini-web`、`baoyu-danger-x-to-markdown`：使用动态脚本路径显示用法
+- `baoyu-comic`、`baoyu-xhs-images`：通过 skill 接口调用图片生成，不再直接调用脚本
+
+## 1.56.1 - 2026-03-08
+
+### 修复
+- `baoyu-post-to-weibo`：简化头条文章图片插入逻辑，使用 Backspace 按键替代复杂的 deleteContents 方案，兼容 ProseMirror 编辑器
+
+## 1.56.0 - 2026-03-08
+
+### 新功能
+- `baoyu-article-illustrator`：预设优先选择流程，按内容类型分类的风格预设
+- `baoyu-xhs-images`：精简工作流从 6 步到 4 步，新增智能确认（快速/自定义/详细三种路径）
+
+### 修复
+- `baoyu-post-to-wechat`：通过文件选择器拦截改进图片上传可靠性
+
+## 1.55.0 - 2026-03-08
+
+### 新功能
+- `baoyu-article-illustrator`：新增 screen-print 风格和 `--preset` 快捷预设（如 tech-explainer、opinion-piece）
+- `baoyu-cover-image`：新增 screen-print 渲染风格和 duotone 调色板，包含 5 个新预设（poster-art、mondo 等）
+- `baoyu-xhs-images`：新增 screen-print 风格和 `--preset` 快捷预设，内置 23 个场景预设
+
+### 文档
+- 为中英文 README 新增致谢章节，致敬相关开源项目
+
+## 1.54.1 - 2026-03-07
+
+### 修复
+- `baoyu-post-to-x`：保持已填充的发帖窗口处于打开状态，方便用户手动检查并发布
+
+### 文档
+- `baoyu-post-to-x`：补充默认帖子类型选择规则和手动发布流程说明
+- `README`：为中英文 README 新增 Star History 图表
+
+## 1.54.0 - 2026-03-06
+
+### 新功能
+- `baoyu-format-markdown`：优化标题和摘要生成，支持多风格候选（颠覆型、方案型、悬念型、数字型），新增禁用模式和钩子优先原则
+- `baoyu-markdown-to-html`：新增 `--cite` 选项，将普通外链转换为底部编号引用
+- `baoyu-post-to-wechat`：Markdown 输入默认启用底部引用，新增 `--no-cite` 标志可关闭
+- `baoyu-translate`：EXTEND.md 支持 `glossary_files` 加载外部术语表文件（Markdown 表格或 YAML 格式）
+- `baoyu-translate`：新增 frontmatter 转换规则，翻译时将源文章元数据字段添加 `source` 前缀
+
+## 1.53.0 - 2026-03-06
+
+### 新功能
+- `baoyu-url-to-markdown`：将渲染后的 HTML 快照保存为 `-captured.html`，与 Markdown 文件并列输出
+- `baoyu-url-to-markdown`：优先使用 Defuddle 转换，失败时自动回退到旧版 Readability/选择器提取器
+
 ## 1.52.0 - 2026-03-06

 ### 新功能
@@ -17,6 +17,27 @@ Skills shared by Baoyu for improving daily work efficiency with Claude Code.
 npx skills add jimliu/baoyu-skills
 ```

+### Publish to ClawHub / OpenClaw
+
+This repository now supports publishing each `skills/baoyu-*` directory as an individual ClawHub skill.
+
+```bash
+# Preview what would be published
+./scripts/sync-clawhub.sh --dry-run
+
+# Publish all changed skills from ./skills
+./scripts/sync-clawhub.sh --all
+```
+
+ClawHub installs skills individually, not as one marketplace bundle. After publishing, users can install specific skills such as:
+
+```bash
+clawhub install baoyu-image-gen
+clawhub install baoyu-markdown-to-html
+```
+
+Publishing to ClawHub releases the published skill under `MIT-0`, per ClawHub's registry rules.
+
 ### Register as Plugin Marketplace

 Run the following command in Claude Code:
@@ -504,6 +525,8 @@ Smart article illustration skill with Type × Style two-dimension approach. Anal

 Post content and articles to X (Twitter). Supports regular posts with images and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation.

+Plain text input is treated as a regular post. Markdown files are treated as X Articles. Scripts fill content into the browser, and the user reviews and publishes manually.
+
 ```bash
 # Post with text
 /baoyu-post-to-x "Hello from Claude Code!"
@@ -677,7 +700,7 @@ Utility tools for content processing.

 #### baoyu-url-to-markdown

-Fetch any URL via Chrome CDP and convert to clean markdown. Supports two capture modes for different scenarios.
+Fetch any URL via Chrome CDP and convert to clean markdown. Saves rendered HTML snapshot alongside the markdown, and automatically falls back to a legacy extractor when Defuddle fails.

 ```bash
 # Auto mode (default) - capture when page loads
@@ -958,6 +981,19 @@ This skill uses a reverse-engineered X (Twitter) API.
 - First use requires consent acknowledgment
 - Authentication via environment variables or Chrome login

+## Credits
+
+This project was inspired by and builds upon the following open source projects:
+
+- [x-article-publisher-skill](https://github.com/wshuyi/x-article-publisher-skill) by [@wshuyi](https://github.com/wshuyi) — Inspiration for the X article publishing skill
+- [doocs/md](https://github.com/doocs/md) by [@doocs](https://github.com/doocs) — Core implementation logic for Markdown to HTML conversion
+- [High-density Infographic Prompt](https://waytoagi.feishu.cn/wiki/YG0zwalijihRREkgmPzcWRInnUg) by AJ@WaytoAGI — Inspiration for the infographic skill
+- [qiaomu-mondo-poster-design](https://github.com/joeseesun/qiaomu-mondo-poster-design) by [@joeseesun](https://github.com/joeseesun)（乔木） — Inspiration for the Mondo style
+
 ## License

 MIT
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=JimLiu/baoyu-skills&type=Date)](https://www.star-history.com/#JimLiu/baoyu-skills&Date)
@@ -17,6 +17,27 @@
 npx skills add jimliu/baoyu-skills
 ```

+### 发布到 ClawHub / OpenClaw
+
+现在这个仓库支持把每个 `skills/baoyu-*` 目录作为独立 ClawHub skill 发布。
+
+```bash
+# 预览将要发布的变更
+./scripts/sync-clawhub.sh --dry-run
+
+# 发布 ./skills 下所有已变更的 skill
+./scripts/sync-clawhub.sh --all
+```
+
+ClawHub 按“单个 skill”安装，不是把整个 marketplace 一次性装进去。发布后，用户可以按需安装：
+
+```bash
+clawhub install baoyu-image-gen
+clawhub install baoyu-markdown-to-html
+```
+
+根据 ClawHub 的 registry 规则，发布到 ClawHub 的 skill 会以 `MIT-0` 许可分发。
+
 ### 注册插件市场

 在 Claude Code 中运行：
@@ -504,6 +525,8 @@ npx skills add jimliu/baoyu-skills

 发布内容和文章到 X (Twitter)。支持带图片的普通帖子和 X 文章（长篇 Markdown）。使用真实 Chrome + CDP 绕过反自动化检测。

+纯文本输入默认按普通帖子处理，Markdown 文件默认按 X 文章处理。脚本会将内容填入浏览器，用户需手动检查并发布。
+
 ```bash
 # 发布文字
 /baoyu-post-to-x "Hello from Claude Code!"
@@ -677,7 +700,7 @@ AI 驱动的生成后端。

 #### baoyu-url-to-markdown

-通过 Chrome CDP 抓取任意 URL 并转换为干净的 Markdown。支持两种抓取模式，适应不同场景。
+通过 Chrome CDP 抓取任意 URL 并转换为 Markdown。同时保存渲染后的 HTML 快照，Defuddle 失败时自动回退到旧版提取器。

 ```bash
 # 自动模式（默认）- 页面加载后立即抓取
@@ -958,6 +981,19 @@ HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 /baoyu-danger
 - 首次使用需确认免责声明
 - 通过环境变量或 Chrome 登录进行身份验证

+## 致谢
+
+本项目受到以下开源项目的启发，感谢它们的作者：
+
+- [x-article-publisher-skill](https://github.com/wshuyi/x-article-publisher-skill) by [@wshuyi](https://github.com/wshuyi) — 发布 X 文章技能的灵感来源
+- [doocs/md](https://github.com/doocs/md) by [@doocs](https://github.com/doocs) — Markdown 转 HTML 的核心实现逻辑
+- [高密度信息图 Prompt](https://waytoagi.feishu.cn/wiki/YG0zwalijihRREkgmPzcWRInnUg) by AJ@WaytoAGI — 信息图技能的灵感来源
+- [qiaomu-mondo-poster-design](https://github.com/joeseesun/qiaomu-mondo-poster-design) by [@joeseesun](https://github.com/joeseesun)（乔木） — Mondo 风格的灵感来源
+
 ## 许可证

 MIT
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=JimLiu/baoyu-skills&type=Date)](https://www.star-history.com/#JimLiu/baoyu-skills&Date)
@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SKILLS_DIR="${ROOT_DIR}/skills"
+
+if command -v clawhub >/dev/null 2>&1; then
+  CLAWHUB_CMD=(clawhub)
+elif command -v npx >/dev/null 2>&1; then
+  CLAWHUB_CMD=(npx -y clawhub)
+else
+  echo "Error: neither clawhub nor npx is available."
+  echo "See https://docs.openclaw.ai/zh-CN/tools/clawhub"
+  exit 1
+fi
+
+if [ "$#" -eq 0 ]; then
+  set -- --all
+fi
+
+exec "${CLAWHUB_CMD[@]}" sync --root "${SKILLS_DIR}" "$@"
@@ -1,6 +1,10 @@
 ---
 name: baoyu-article-illustrator
 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 "为文章配图".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-article-illustrator
 ---

 # Article Illustrator
@@ -16,6 +20,8 @@ Analyze articles, identify illustration positions, generate images with Type ×

 Combine freely: `--type infographic --style blueprint`

+Or use presets: `--preset tech-explainer` → type + style in one flag. See [Style Presets](references/style-presets.md).
+
 ## Types

 | Type | Best For |
@@ -80,13 +86,13 @@ Full procedures: [references/workflow.md](references/workflow.md#step-2-setup--a

 ### Step 3: Confirm Settings ⚠️

-**ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED.**
+**ONE AskUserQuestion, max 4 Qs. Q1-Q2 REQUIRED. Q3 required unless preset chosen.**

 | Q | Options |
 |---|---------|
-| **Q1: Type** | [Recommended], infographic, scene, flowchart, comparison, framework, timeline, mixed |
+| **Q1: Preset or Type** | [Recommended preset], [alt preset], or manual: infographic, scene, flowchart, comparison, framework, timeline, mixed |
 | **Q2: Density** | minimal (1-2), balanced (3-5), per-section (Recommended), rich (6+) |
-| **Q3: Style** | [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, Other |
+| **Q3: Style** | [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, poster, Other — **skip if preset chosen** |
 | Q4: Language | When article language ≠ EXTEND.md setting |

 Full procedures: [references/workflow.md](references/workflow.md#step-3-confirm-settings-)
@@ -158,5 +164,6 @@ illustrations/{topic-slug}/
 | [references/workflow.md](references/workflow.md) | Detailed procedures |
 | [references/usage.md](references/usage.md) | Command syntax |
 | [references/styles.md](references/styles.md) | Style gallery |
+| [references/style-presets.md](references/style-presets.md) | Preset shortcuts (type + style) |
 | [references/prompt-construction.md](references/prompt-construction.md) | Prompt templates |
 | [references/config/first-time-setup.md](references/config/first-time-setup.md) | First-time setup |
@@ -236,6 +236,38 @@ STYLE: [style characteristics]
 ASPECT: 16:9
 ```

+### Screen-Print Style Override
+
+When `style: screen-print`, replace standard style instructions with:
+
+```
+Screen print / silkscreen poster art. Flat color blocks, NO gradients.
+COLORS: 2-5 colors maximum. [Choose from style palette or duotone pair]
+TEXTURE: Halftone dot patterns, slight color layer misregistration, paper grain
+COMPOSITION: Bold silhouettes, geometric framing, negative space as storytelling element
+FIGURES: Silhouettes only, no detailed faces, stencil-cut edges
+TYPOGRAPHY: Bold condensed sans-serif integrated into composition (not overlaid)
+```
+
+**Scene + screen-print**:
+```
+Conceptual poster scene. Single symbolic focal point, NOT literal illustration.
+COLORS: Duotone pair (e.g., Burnt Orange #E8751A + Deep Teal #0A6E6E) on Off-Black #121212
+COMPOSITION: Centered silhouette or geometric frame, 60%+ negative space
+TEXTURE: Halftone dots, paper grain, slight print misregistration
+```
+
+**Comparison + screen-print**:
+```
+Split poster composition. Each side dominated by one color from duotone pair.
+LEFT: [Color A] side with silhouette/icon for [Option A]
+RIGHT: [Color B] side with silhouette/icon for [Option B]
+DIVIDER: Geometric shape or negative space boundary
+TEXTURE: Halftone transitions between sides
+```
+
+---
+
 ## What to Avoid

 - Vague descriptions ("a nice image")
@@ -0,0 +1,72 @@
+# Style Presets
+
+`--preset X` expands to a type + style combination. Users can override either dimension.
+
+## By Category
+
+### Technical & Engineering
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `tech-explainer` | `infographic` | `blueprint` | API docs, system metrics, technical deep-dives |
+| `system-design` | `framework` | `blueprint` | Architecture diagrams, system design |
+| `architecture` | `framework` | `vector-illustration` | Component relationships, module structure |
+| `science-paper` | `infographic` | `scientific` | Research findings, lab results, academic |
+
+### Knowledge & Education
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `knowledge-base` | `infographic` | `vector-illustration` | Concept explainers, tutorials, how-to |
+| `saas-guide` | `infographic` | `notion` | Product guides, SaaS docs, tool walkthroughs |
+| `tutorial` | `flowchart` | `vector-illustration` | Step-by-step tutorials, setup guides |
+| `process-flow` | `flowchart` | `notion` | Workflow documentation, onboarding flows |
+
+### Data & Analysis
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `data-report` | `infographic` | `editorial` | Data journalism, metrics reports, dashboards |
+| `versus` | `comparison` | `vector-illustration` | Tech comparisons, framework shootouts |
+| `business-compare` | `comparison` | `elegant` | Product evaluations, strategy options |
+
+### Narrative & Creative
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `storytelling` | `scene` | `warm` | Personal essays, reflections, growth stories |
+| `lifestyle` | `scene` | `watercolor` | Travel, wellness, lifestyle, creative |
+| `history` | `timeline` | `elegant` | Historical overviews, milestones |
+| `evolution` | `timeline` | `warm` | Progress narratives, growth journeys |
+
+### Editorial & Opinion
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `opinion-piece` | `scene` | `screen-print` | Op-eds, commentary, critical essays |
+| `editorial-poster` | `comparison` | `screen-print` | Debate, contrasting viewpoints |
+| `cinematic` | `scene` | `screen-print` | Dramatic narratives, cultural essays |
+
+## Content Type → Preset Recommendations
+
+Use this table during Step 3 to recommend presets based on Step 2 content analysis:
+
+| Content Type (Step 2) | Primary Preset | Alternatives |
+|------------------------|----------------|--------------|
+| Technical | `tech-explainer` | `system-design`, `architecture` |
+| Tutorial | `tutorial` | `process-flow`, `knowledge-base` |
+| Methodology / Framework | `system-design` | `architecture`, `process-flow` |
+| Data / Metrics | `data-report` | `versus`, `tech-explainer` |
+| Comparison / Review | `versus` | `business-compare`, `editorial-poster` |
+| Narrative / Personal | `storytelling` | `lifestyle`, `evolution` |
+| Opinion / Editorial | `opinion-piece` | `cinematic`, `editorial-poster` |
+| Historical / Timeline | `history` | `evolution` |
+| Academic / Research | `science-paper` | `tech-explainer`, `data-report` |
+| SaaS / Product | `saas-guide` | `knowledge-base`, `process-flow` |
+
+## Override Examples
+
+- `--preset tech-explainer --style notion` = infographic type with notion style
+- `--preset storytelling --type timeline` = timeline type with warm style
+
+Explicit `--type`/`--style` flags always override preset values.
@@ -12,6 +12,7 @@ Simplified style tier for quick selection:
 | `hand-drawn` | sketch/warm | Relaxed, reflective, casual content |
 | `editorial` | editorial | Processes, data, journalism |
 | `scene` | warm/watercolor | Narratives, emotional, lifestyle |
+| `poster` | screen-print | Opinion, editorial, cultural, cinematic |

 Use Core Styles for most cases. See full Style Gallery below for granular control.

@@ -40,6 +41,7 @@ Use Core Styles for most cases. See full Style Gallery below for granular contro
 | `playful` | Whimsical pastel doodles | Fun, casual, educational |
 | `retro` | 80s/90s neon geometric | 80s/90s nostalgic, bold |
 | `sketch` | Raw pencil notebook style | Brainstorming, creative exploration |
+| `screen-print` | Bold poster art, halftone textures, limited colors | Opinion, editorial, cultural, cinematic |
 | `sketch-notes` | Soft hand-drawn warm notes | Educational, warm notes |
 | `vintage` | Aged parchment historical | Historical, heritage |

@@ -47,14 +49,14 @@ Full specifications: `references/styles/<style>.md`

 ## Type × Style Compatibility Matrix

-| | vector-illustration | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
-| infographic | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
-| scene | ✓ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ |
-| flowchart | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ |
-| comparison | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
-| framework | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓✓ |
-| timeline | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
+| | vector-illustration | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific | screen-print |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| infographic | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
+| scene | ✓ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ | ✓✓ |
+| flowchart | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✗ |
+| comparison | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ |
+| framework | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓✓ | ✓ |
+| timeline | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ |

 ✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended

@@ -83,6 +85,7 @@ Full specifications: `references/styles/<style>.md`
 | History, timeline, progress, evolution | timeline | elegant, warm |
 | Productivity, SaaS, tool, app, software | infographic | notion, vector-illustration |
 | Business, professional, strategy, corporate | framework | elegant |
+| Opinion, editorial, culture, philosophy, cinematic, dramatic, poster | scene | screen-print |
 | Biology, chemistry, medical, scientific | infographic | scientific |
 | Explainer, journalism, magazine, investigation | infographic | editorial |

@@ -172,3 +175,22 @@ Full specifications: `references/styles/<style>.md`
 - Organic flow
 - Personal journey feel
 - Growth narratives
+
+### scene + screen-print
+- Bold silhouettes, symbolic compositions
+- 2-5 flat colors with halftone textures
+- Figure-ground inversion (negative space tells secondary story)
+- Vintage poster aesthetic, conceptual not literal
+- Great for opinion pieces and cultural commentary
+
+### comparison + screen-print
+- Split duotone composition (one color per side)
+- Bold geometric dividers
+- Symbolic icons over detailed rendering
+- High contrast, immediate visual impact
+
+### framework + screen-print
+- Geometric node representations with stencil-cut edges
+- Limited color coding (one color per concept level)
+- Clean silhouette-based iconography
+- Poster-style hierarchy with bold typography
@@ -0,0 +1,70 @@
+# screen-print
+
+Bold poster art with limited colors, halftone textures, and symbolic storytelling
+
+## Design Aesthetic
+
+Screen print / silkscreen aesthetic inspired by Mondo limited-edition posters and vintage concert prints. Flat color blocks, halftone dot patterns, bold silhouettes, and deliberate print imperfections. Conceptual and symbolic rather than literal — one iconic image tells the whole story. Perfect for opinion pieces, cultural commentary, and editorial content.
+
+## Background
+
+- Color: Off-Black (#121212) or Warm Cream (#F5E6D0)
+- Texture: Paper grain with subtle halftone dot overlay
+
+## Color Palette
+
+| Role | Color | Hex | Usage |
+|------|-------|-----|-------|
+| Background | Off-Black | #121212 | Dark compositions |
+| Background Alt | Warm Cream | #F5E6D0 | Light compositions |
+| Primary | Burnt Orange | #E8751A | Main accent |
+| Secondary | Deep Teal | #0A6E6E | Contrast accent |
+| Tertiary | Crimson | #C0392B | Bold emphasis |
+| Highlight | Amber | #F4A623 | Small accents |
+| Text | Cream White | #FAF3E0 | On dark backgrounds |
+
+**Duotone Pairs** (choose ONE pair for high-impact compositions):
+
+| Pair | Color A | Color B | Feel |
+|------|---------|---------|------|
+| Orange + Teal | #E8751A | #0A6E6E | Cinematic, action |
+| Red + Cream | #C0392B | #F5E6D0 | Bold, classic |
+| Blue + Gold | #1A3A5C | #D4A843 | Prestigious, premium |
+| Crimson + Navy | #DC143C | #0D1B2A | Dramatic, noir |
+
+**Rule**: Use 2-5 colors maximum. Fewer colors = stronger impact.
+
+## Visual Elements
+
+- Bold silhouettes and symbolic shapes
+- Halftone dot patterns within color fills
+- Slight color layer misregistration (print offset effect)
+- Geometric framing (circles, arches, triangles)
+- Figure-ground inversion (negative space forms secondary image)
+- Stencil-cut edges, no outlines — shapes defined by color boundaries
+- Typography integrated as design element, not overlay
+- Vintage poster border treatments
+
+## Style Rules
+
+### Do
+
+- Limit to 2-5 flat colors
+- Use bold silhouettes over detailed rendering
+- Let negative space tell part of the story
+- Add halftone texture for authenticity
+- Use geometric composition (centered, symmetrical)
+- Reference vintage decades (60s/70s/80s) for era feel
+
+### Don't
+
+- Use photorealistic rendering or gradients
+- Add complex facial details (silhouettes preferred)
+- Mix too many visual elements (one focal point)
+- Use modern digital aesthetic
+- Create busy or cluttered compositions
+- Use more than 5 colors
+
+## Best For
+
+Opinion/editorial articles, cultural commentary, philosophy and strategy, dramatic narratives, cinematic storytelling, music and entertainment, event announcements, bold branding content
@@ -29,6 +29,7 @@
 |--------|-------------|
 | `--type <name>` | Illustration type (see Type Gallery in SKILL.md) |
 | `--style <name>` | Visual style (see references/styles.md) |
+| `--preset <name>` | Shorthand for type + style combo (see [references/style-presets.md](references/style-presets.md)) |
 | `--density <level>` | Image count: minimal / balanced / rich |

 ## Input Modes
@@ -55,12 +56,27 @@ Configure in EXTEND.md: `default_output_dir: illustrations-subdir`
 /baoyu-article-illustrator api-design.md --type infographic --style blueprint
 ```

+**Same thing with preset**:
+```bash
+/baoyu-article-illustrator api-design.md --preset tech-explainer
+```
+
 **Personal story**:
 ```bash
-/baoyu-article-illustrator journey.md --type scene --style warm
+/baoyu-article-illustrator journey.md --preset storytelling
 ```

 **Tutorial with steps**:
 ```bash
-/baoyu-article-illustrator how-to-deploy.md --type flowchart --density rich
+/baoyu-article-illustrator how-to-deploy.md --preset tutorial --density rich
+```
+
+**Opinion article with poster style**:
+```bash
+/baoyu-article-illustrator opinion.md --preset opinion-piece
+```
+
+**Preset with override**:
+```bash
+/baoyu-article-illustrator article.md --preset tech-explainer --style notion
 ```
@@ -165,9 +165,16 @@ For each reference image:

 **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
+### Q1: Preset or Type ⚠️ REQUIRED
+
+Based on Step 2 content analysis, recommend a preset first (sets both type & style). Look up [style-presets.md](style-presets.md) "Content Type → Preset Recommendations" table.
+
+- [Recommended preset] — [brief: type + style + why] (Recommended)
+- [Alternative preset] — [brief]
+- Or choose type manually: infographic / scene / flowchart / comparison / framework / timeline / mixed
+
+**If user picks a preset → skip Q3** (type & style both resolved).
+**If user picks a type → Q3 is REQUIRED.**

 ### Q2: Density ⚠️ REQUIRED - DO NOT SKIP
 - minimal (1-2) - Core concepts only
@@ -175,7 +182,7 @@ For each reference image:
 - 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)
+### Q3: Style ⚠️ REQUIRED (skip if preset chosen in Q1)

 If EXTEND.md has `preferred_style`:
 - [Custom style name + brief description] (Recommended)
@@ -191,13 +198,14 @@ If no `preferred_style` (present Core Styles first):

 **Core Styles** (simplified selection):

-| Core Style | Best For |
-|------------|----------|
-| `minimal-flat` | General, knowledge sharing, SaaS |
-| `sci-fi` | AI, frontier tech, system design |
-| `hand-drawn` | Relaxed, reflective, casual |
-| `editorial` | Processes, data, journalism |
-| `scene` | Narratives, emotional, lifestyle |
+| Core Style | Maps To | Best For |
+|------------|---------|----------|
+| `minimal-flat` | notion | General, knowledge sharing, SaaS |
+| `sci-fi` | blueprint | AI, frontier tech, system design |
+| `hand-drawn` | sketch/warm | Relaxed, reflective, casual |
+| `editorial` | editorial | Processes, data, journalism |
+| `scene` | warm/watercolor | Narratives, emotional, lifestyle |
+| `poster` | screen-print | Opinion, editorial, cultural, cinematic |

 Style selection based on Type × Style compatibility matrix (styles.md).
 Full specs: `styles/<style>.md`
@@ -1,6 +1,14 @@
 ---
 name: baoyu-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".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-comic
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Knowledge Comic Creator
@@ -104,9 +112,9 @@ Details: [references/auto-selection.md](references/auto-selection.md)
 **Important**: All scripts are located in the `scripts/` subdirectory of this skill.

 **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
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
+3. Replace all `{baseDir}` in this document with the actual path
 4. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 **Script Reference**:
@@ -208,12 +216,11 @@ Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard →

 **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
-${BUN_X} ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
-  --promptfiles characters/characters.md \
-  --image characters/characters.png --ar 4:3
-```
+- Invoke an installed image generation skill such as `baoyu-image-gen`
+- Read that skill's `SKILL.md` and follow its documented interface rather than calling its scripts directly
+- Use `characters/characters.md` as the prompt-file input
+- Save output to `characters/characters.png`
+- Use aspect ratio `4:3`

 **Compress character sheet** (recommended):
 Compress to reduce token usage when used as reference image:
@@ -231,14 +238,11 @@ Compress to reduce token usage when used as reference image:
 **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
-# Example: ALWAYS include --ref for consistency
-${BUN_X} ${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
-```
+- Invoke the installed image generation skill for each page
+- Use `prompts/01-page-xxx.md` as the prompt-file input
+- Save output to `01-page-xxx.png`
+- Use aspect ratio `3:4`
+- If the chosen skill supports reference images, pass `characters/characters.png` as `--ref`

 **Full workflow details**: [references/workflow.md](references/workflow.md)

@@ -433,14 +433,12 @@ With confirmed prompts from Step 5/6:

 **Strategy A: Using `--ref` parameter** (e.g., baoyu-image-gen)

-```bash
-# Each page generation MUST include --ref
-${BUN_X} ${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
-```
+- Read the chosen image generation skill's `SKILL.md`
+- Invoke that installed skill via its documented interface, not by calling its scripts directly
+- For every page, use `prompts/01-page-xxx.md` as the prompt-file input
+- Save output to `01-page-xxx.png`
+- Use aspect ratio `3:4`
+- Pass `characters/characters.png` as `--ref` on every page generation

 **Strategy B: Embedding character descriptions in prompt**

@@ -478,7 +476,7 @@ If image generation skill supports `--sessionId`:
 After all images generated:

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/merge-to-pdf.ts <comic-dir>
+${BUN_X} {baseDir}/scripts/merge-to-pdf.ts <comic-dir>
 ```

 Creates `{topic-slug}.pdf` with all pages as full-page images.
@@ -1,6 +1,14 @@
 ---
 name: baoyu-compress-image
 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.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-compress-image
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Image Compressor
@@ -9,7 +17,7 @@ Compresses images using best available tool (sips → cwebp → ImageMagick →

 ## Script Directory

-Scripts in `scripts/` subdirectory. `${SKILL_DIR}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `${SKILL_DIR}` and `${BUN_X}` with actual values.
+Scripts in `scripts/` subdirectory. `{baseDir}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `{baseDir}` and `${BUN_X}` with actual values.

 | Script | Purpose |
 |--------|---------|
@@ -52,7 +60,7 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md") { "user" }
 ## Usage

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <input> [options]
+${BUN_X} {baseDir}/scripts/main.ts <input> [options]
 ```

 ## Options
@@ -71,16 +79,16 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts <input> [options]

 ```bash
 # Single file → WebP (replaces original)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts image.png
+${BUN_X} {baseDir}/scripts/main.ts image.png

 # Keep PNG format
-${BUN_X} ${SKILL_DIR}/scripts/main.ts image.png -f png --keep
+${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep

 # Directory recursive
-${BUN_X} ${SKILL_DIR}/scripts/main.ts ./images/ -r -q 75
+${BUN_X} {baseDir}/scripts/main.ts ./images/ -r -q 75

 # JSON output
-${BUN_X} ${SKILL_DIR}/scripts/main.ts image.png --json
+${BUN_X} {baseDir}/scripts/main.ts image.png --json
 ```

 **Output**:
@@ -1,6 +1,10 @@
 ---
 name: baoyu-cover-image
-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".
+description: Generates article cover images with 5 dimensions (type, palette, rendering, text, mood) combining 10 color palettes and 7 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".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-cover-image
 ---

 # Cover Image Generator
@@ -35,8 +39,8 @@ Generate elegant cover images for articles with 5-dimensional customization.
 | Option | Description |
 |--------|-------------|
 | `--type <name>` | hero, conceptual, typography, metaphor, scene, minimal |
-| `--palette <name>` | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro |
-| `--rendering <name>` | flat-vector, hand-drawn, painterly, digital, pixel, chalk |
+| `--palette <name>` | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro, duotone |
+| `--rendering <name>` | flat-vector, hand-drawn, painterly, digital, pixel, chalk, screen-print |
 | `--style <name>` | Preset shorthand (see [Style Presets](references/style-presets.md)) |
 | `--text <level>` | none, title-only, title-subtitle, text-rich |
 | `--mood <level>` | subtle, balanced, bold |
@@ -52,8 +56,8 @@ Generate elegant cover images for articles with 5-dimensional customization.
 | Dimension | Values | Default |
 |-----------|--------|---------|
 | **Type** | hero, conceptual, typography, metaphor, scene, minimal | auto |
-| **Palette** | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro | auto |
-| **Rendering** | flat-vector, hand-drawn, painterly, digital, pixel, chalk | auto |
+| **Palette** | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro, duotone | auto |
+| **Rendering** | flat-vector, hand-drawn, painterly, digital, pixel, chalk, screen-print | auto |
 | **Text** | none, title-only, title-subtitle, text-rich | title-only |
 | **Mood** | subtle, balanced, bold | balanced |
 | **Font** | clean, handwritten, serif, display | clean |
@@ -65,10 +69,10 @@ Auto-selection rules: [references/auto-selection.md](references/auto-selection.m
 **Types**: hero, conceptual, typography, metaphor, scene, minimal
 → Details: [references/types.md](references/types.md)

-**Palettes**: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro
+**Palettes**: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro, duotone
 → Details: [references/palettes/](references/palettes/)

-**Renderings**: flat-vector, hand-drawn, painterly, digital, pixel, chalk
+**Renderings**: flat-vector, hand-drawn, painterly, digital, pixel, chalk, screen-print
 → Details: [references/renderings/](references/renderings/)

 **Text Levels**: none (pure visual) | title-only (default) | title-subtitle | text-rich (with tags)
@@ -26,6 +26,7 @@ When a dimension is omitted, select based on content signals.
 | Fantasy, children, gentle, creative, whimsical | `pastel` |
 | Zen, focus, essential, pure, simple | `mono` |
 | History, vintage, retro, classic, exploration | `retro` |
+| Movie poster, album cover, concert, cinematic, dramatic, two-color | `duotone` |

 ## Auto Rendering Selection

@@ -37,6 +38,7 @@ When a dimension is omitted, select based on content signals.
 | Data, dashboard, SaaS, corporate, polished | `digital` |
 | Gaming, retro, 8-bit, nostalgic | `pixel` |
 | Education, tutorial, classroom, teaching | `chalk` |
+| Poster, movie, album, concert, silhouette, mondo, limited-edition | `screen-print` |

 ## Auto Text Selection

@@ -4,28 +4,29 @@

 ## Palette × Rendering

-| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|
-| warm | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
-| elegant | ✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✗ |
-| cool | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
-| dark | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ |
-| earth | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ |
-| vivid | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ |
-| pastel | ✓✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ |
-| mono | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
-| retro | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✗ |
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk | screen-print |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| warm | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| elegant | ✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✗ | ✓ |
+| cool | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✓ |
+| dark | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓✓ |
+| earth | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ | ✓ |
+| vivid | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ |
+| pastel | ✓✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ | ✗ |
+| mono | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✓✓ |
+| retro | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ |
+| duotone | ✓ | ✗ | ✗ | ✓ | ✗ | ✗ | ✓✓ |

 ## Type × Rendering

-| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|
-| hero | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ |
-| conceptual | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
-| typography | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ |
-| metaphor | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓ |
-| scene | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✗ |
-| minimal | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✗ |
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk | screen-print |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| hero | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ |
+| conceptual | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✓ |
+| typography | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ |
+| metaphor | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓ | ✓✓ |
+| scene | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✗ | ✓ |
+| minimal | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✗ | ✓✓ |

 ## Type × Text

@@ -51,9 +52,9 @@

 ## Font × Rendering

-| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|
-| clean | ✓✓ | ✗ | ✗ | ✓✓ | ✓ | ✗ |
-| handwritten | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ |
-| serif | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✗ |
-| display | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk | screen-print |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| clean | ✓✓ | ✗ | ✗ | ✓✓ | ✓ | ✗ | ✓ |
+| handwritten | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✗ |
+| serif | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✗ | ✓ |
+| display | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ |
@@ -120,12 +120,12 @@ Bold, decorative typography for maximum impact.

 ## Rendering Compatibility

-| Font × Rendering | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
-|------------------|:-----------:|:----------:|:---------:|:-------:|:-----:|:-----:|
-| clean | ✓✓ | ✗ | ✗ | ✓✓ | ✓ | ✗ |
-| handwritten | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ |
-| serif | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✗ |
-| display | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
+| Font × Rendering | flat-vector | hand-drawn | painterly | digital | pixel | chalk | screen-print |
+|------------------|:-----------:|:----------:|:---------:|:-------:|:-----:|:-----:|:------------:|
+| clean | ✓✓ | ✗ | ✗ | ✓✓ | ✓ | ✗ | ✓ |
+| handwritten | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✗ |
+| serif | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✗ | ✓ |
+| display | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ |

 ✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended

@@ -148,6 +148,7 @@ Font style adapts to palette characteristics:
 | Cool (cool, mono, elegant) | Perfect match | Contrast | Classic pairing | Bold statement |
 | Dark (dark, vivid) | High contrast | Glow effects | Dramatic | Maximum impact |
 | Vintage (retro) | Modern contrast | Nostalgic fit | Period-appropriate | Retro headlines |
+| Duotone (duotone) | Sharp contrast | Not recommended | Dramatic pairing | Cinematic impact |

 ## Auto Selection

@@ -112,6 +112,7 @@ Mood modifies the base palette characteristics:
 | 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 |
+| Duotone palettes (duotone) | Softer contrast between pair | Standard two-color split | Maximum contrast, stark separation |

 ## Rendering Interaction

@@ -125,6 +126,7 @@ Mood adjusts rendering characteristics:
 | 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 |
+| screen-print | Fewer colors (2), lighter halftone | Standard 3-4 colors, medium halftone | More colors (4-5), dense halftone, stronger misregistration |

 ## Auto Selection

@@ -0,0 +1,39 @@
+# duotone
+
+Dramatic, cinematic, two-color high contrast
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Burnt Orange | #E8751A |
+| Primary 2 | Deep Teal | #0A6E6E |
+| Background | Off-Black | #121212 |
+| Background Alt | Dark Charcoal | #1E1E1E |
+| Accent 1 | Warm Cream | #F5E6D0 |
+| Accent 2 | Amber Highlight | #F4A623 |
+
+## Duotone Pair Options
+
+Choose ONE pair based on content mood. The two colors dominate the entire image:
+
+| Pair | Color A | Color B | Feel |
+|------|---------|---------|------|
+| Orange + Teal | #E8751A | #0A6E6E | Cinematic, action |
+| Red + Cream | #C0392B | #F5E6D0 | Bold, classic |
+| Blue + Gold | #1A3A5C | #D4A843 | Prestigious, premium |
+| Purple + Green | #6B3FA0 | #2ECC71 | Futuristic, contrast |
+| Magenta + Cyan | #C2185B | #00BCD4 | Vibrant, pop |
+| Crimson + Navy | #DC143C | #0D1B2A | Dramatic, noir |
+
+## Decorative Hints
+
+- Stark two-color separation across entire composition
+- Halftone transitions between the two colors
+- Silhouettes in one color against the other
+- Minimal use of third color (only for small highlights)
+- High contrast figure-ground relationships
+
+## Best For
+
+Movie posters, album covers, concert prints, dramatic announcements, cinematic content, bold branding, editorial covers, artistic campaigns
@@ -0,0 +1,44 @@
+# screen-print
+
+Bold, limited-color poster art with print texture
+
+## Core Characteristics
+
+Screen print / silkscreen aesthetic with flat color blocks, halftone textures, and deliberate print imperfections. Think Mondo limited-edition posters, vintage concert prints, and alternative movie poster art.
+
+## Lines
+
+- Clean, sharp edges between color blocks
+- No outlines — shapes defined by color boundaries
+- Stencil-cut quality, bold silhouettes
+- Geometric shapes with precise registration
+
+## Texture
+
+- Halftone dot patterns within color fills
+- Slight color layer misregistration (offset between print layers)
+- Paper grain texture beneath colors
+- Risograph / screen print imperfections (ink spread, dot gain)
+
+## Depth
+
+- Flat color planes layered front to back
+- Depth through silhouette overlap and color layering
+- No gradients — tonal variation via halftone density
+- Negative space as active compositional element
+
+## Element Vocabulary
+
+- Bold silhouettes and symbolic shapes
+- Geometric framing (circles, arches, triangles)
+- Figure-ground inversion (negative space forms secondary image)
+- Limited icon vocabulary: key props, symbolic objects
+- Typography integrated as design element, not overlay
+- Vintage poster border treatments
+
+## Typography Approach
+
+- Bold condensed sans-serif or hand-drawn lettering
+- Art Deco influences, vintage poster typography
+- Typography as integral part of composition (not separate layer)
+- Strong readability through high contrast with background
@@ -24,6 +24,11 @@
 | `warm` | `warm` | `hand-drawn` |
 | `warm-flat` | `warm` | `flat-vector` |
 | `watercolor` | `earth` | `painterly` |
+| `poster-art` | `retro` | `screen-print` |
+| `mondo` | `mono` | `screen-print` |
+| `art-deco` | `elegant` | `screen-print` |
+| `propaganda` | `vivid` | `screen-print` |
+| `cinematic` | `duotone` | `screen-print` |

 ## Override Examples

@@ -1,6 +1,14 @@
 ---
 name: baoyu-danger-gemini-web
 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.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-danger-gemini-web
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Gemini Web Client
@@ -12,10 +20,10 @@ Text/image generation via Gemini Web API. Supports reference images and multi-tu
 **Important**: All scripts are located in the `scripts/` subdirectory of this skill.

 **Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
 3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun
-4. Replace all `${SKILL_DIR}` and `${BUN_X}` in this document with actual values
+4. Replace all `{baseDir}` and `${BUN_X}` in this document with actual values

 **Script Reference**:
 | Script | Purpose |
@@ -80,23 +88,23 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md") { "user"

 ```bash
 # Text generation
-${BUN_X} ${SKILL_DIR}/scripts/main.ts "Your prompt"
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Your prompt" --model gemini-3-flash
+${BUN_X} {baseDir}/scripts/main.ts "Your prompt"
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Your prompt" --model gemini-3-flash

 # Image generation
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cute cat" --image cat.png
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cute cat" --image cat.png
+${BUN_X} {baseDir}/scripts/main.ts --promptfiles system.md content.md --image out.png

 # Vision input (reference images)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Describe this" --reference image.png
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Create variation" --reference a.png --image out.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Describe this" --reference image.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Create variation" --reference a.png --image out.png

 # Multi-turn conversation
-${BUN_X} ${SKILL_DIR}/scripts/main.ts "Remember: 42" --sessionId session-abc
-${BUN_X} ${SKILL_DIR}/scripts/main.ts "What number?" --sessionId session-abc
+${BUN_X} {baseDir}/scripts/main.ts "Remember: 42" --sessionId session-abc
+${BUN_X} {baseDir}/scripts/main.ts "What number?" --sessionId session-abc

 # JSON output
-${BUN_X} ${SKILL_DIR}/scripts/main.ts "Hello" --json
+${BUN_X} {baseDir}/scripts/main.ts "Hello" --json
 ```

 ## Options
@@ -59,16 +59,31 @@ function normalizeSessionMetadata(input: unknown): Array<string | null> {
  return [null, null, null];
 }

+function formatScriptCommand(fallback: string): string {
+  const raw = process.argv[1];
+  const displayPath = raw
+    ? (() => {
+        const relative = path.relative(process.cwd(), raw);
+        return relative && !relative.startsWith("..") ? relative : raw;
+      })()
+    : fallback;
+  const quotedPath = displayPath.includes(" ")
+    ? `"${displayPath.replace(/"/g, '\\"')}"`
+    : displayPath;
+  return `npx -y bun ${quotedPath}`;
+}
+
 function printUsage(cookiePath: string, profileDir: string): void {
+  const cmd = formatScriptCommand("scripts/main.ts");
  console.log(`Usage:
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --prompt "Hello"
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts "Hello"
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --prompt "A cute cat" --image generated.png
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --promptfiles system.md content.md --image out.png
+  ${cmd} --prompt "Hello"
+  ${cmd} "Hello"
+  ${cmd} --prompt "A cute cat" --image generated.png
+  ${cmd} --promptfiles system.md content.md --image out.png

 Multi-turn conversation (agent generates unique sessionId):
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts "Remember 42" --sessionId abc123
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts "What number?" --sessionId abc123
+  ${cmd} "Remember 42" --sessionId abc123
+  ${cmd} "What number?" --sessionId abc123

 Options:
  -p, --prompt <text>       Prompt text
@@ -1,6 +1,14 @@
 ---
 name: baoyu-danger-x-to-markdown
 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.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-danger-x-to-markdown
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # X to Markdown
@@ -14,8 +22,8 @@ Converts X content to markdown:
 Scripts located in `scripts/` subdirectory.

 **Path Resolution**:
-1. `SKILL_DIR` = this SKILL.md's directory
-2. Script path = `${SKILL_DIR}/scripts/main.ts`
+1. `{baseDir}` = this SKILL.md's directory
+2. Script path = `{baseDir}/scripts/main.ts`
 3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 ## Consent Requirement
@@ -140,10 +148,10 @@ Full reference: [references/config/first-time-setup.md](references/config/first-
 ## Usage

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url>
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> -o output.md
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> --download-media
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> --json
+${BUN_X} {baseDir}/scripts/main.ts <url>
+${BUN_X} {baseDir}/scripts/main.ts <url> -o output.md
+${BUN_X} {baseDir}/scripts/main.ts <url> --download-media
+${BUN_X} {baseDir}/scripts/main.ts <url> --json
 ```

 ## Options
@@ -30,8 +30,22 @@ type ConsentRecord = {

 const DISCLAIMER_VERSION = "1.0";

+function formatScriptCommand(fallback: string): string {
+  const raw = process.argv[1];
+  const displayPath = raw
+    ? (() => {
+        const relative = path.relative(process.cwd(), raw);
+        return relative && !relative.startsWith("..") ? relative : raw;
+      })()
+    : fallback;
+  const quotedPath = displayPath.includes(" ")
+    ? `"${displayPath.replace(/"/g, '\\"')}"`
+    : displayPath;
+  return `npx -y bun ${quotedPath}`;
+}
+
 function printUsage(exitCode: number): never {
-  const cmd = "npx -y bun skills/baoyu-danger-x-to-markdown/scripts/main.ts";
+  const cmd = formatScriptCommand("scripts/main.ts");
  console.log(`X (Twitter) to Markdown

 Usage:
@@ -36,6 +36,20 @@ function normalizeInputUrl(input: string): string {
  }
 }

+function formatScriptCommand(fallback: string): string {
+  const raw = process.argv[1];
+  const displayPath = raw
+    ? (() => {
+        const relative = path.relative(process.cwd(), raw);
+        return relative && !relative.startsWith("..") ? relative : raw;
+      })()
+    : fallback;
+  const quotedPath = displayPath.includes(" ")
+    ? `"${displayPath.replace(/"/g, '\\"')}"`
+    : displayPath;
+  return `npx -y bun ${quotedPath}`;
+}
+
 function parseTweetId(input: string): string | null {
  const trimmed = input.trim();
  if (!trimmed) return null;
@@ -179,7 +193,7 @@ async function main() {
  const { url } = parseArgs();
  if (!url) {
    console.error("Usage:");
-    console.error("  npx -y bun skills/baoyu-danger-x-to-markdown/scripts/tweet-to-markdown.ts <tweet url>");
+    console.error(`  ${formatScriptCommand("scripts/tweet-to-markdown.ts")} <tweet url>`);
    process.exit(1);
  }

@@ -1,6 +1,14 @@
 ---
 name: baoyu-format-markdown
 description: Formats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or improve article layout. Outputs to {filename}-formatted.md.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-format-markdown
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Markdown Formatter
@@ -11,7 +19,7 @@ Transforms plain text or markdown into well-structured, reader-friendly markdown

 ## Script Directory

-Scripts in `scripts/` subdirectory. `${SKILL_DIR}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `${SKILL_DIR}` and `${BUN_X}` with actual values.
+Scripts in `scripts/` subdirectory. `{baseDir}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `{baseDir}` and `${BUN_X}` with actual values.

 | Script | Purpose |
 |--------|---------|
@@ -168,29 +176,55 @@ Check for YAML frontmatter (`---` block). Create if missing.

 **Title Generation:**

-Generate 3 candidate titles with different angles/styles. Present to user for selection:
+Whether or not a title already exists, always run the title optimization flow (unless `auto_select_title` is set).
+
+**Preparation** — read the full text and extract:
+- Core argument (one sentence: "what is this article about?")
+- Most impactful opinion or conclusion
+- Reader pain point or curiosity trigger
+- Most memorable metaphor or golden quote
+
+**Generate 3-4 style-differentiated candidates:**
+
+| Style | Characteristics | Example |
+|-------|----------------|---------|
+| Subversive | Deny common practice, create conflict | "All de-AI-flavor prompts are wrong" |
+| Solution | Give the answer directly, promise value | "One recipe to make AI write in your voice" |
+| Suspense | Reveal half, spark curiosity | "It took me six months to find how to remove AI flavor" |
+| Concrete number | Use numbers for credibility | "150 lines of docs taught AI my writing style" |
+
+Present to user:

 ```
 Pick a title:

-1. [Title A] — [angle/style note]
-2. [Title B] — [angle/style note]
-3. [Title C] — [angle/style note]
+1. [Title A] — (recommended)
+2. [Title B] — [style note]
+3. [Title C] — [style note]

 Enter number, or type a custom title:
 ```

-Title principles:
- Engaging, sparks reading interest
- Captures core message or most compelling angle
- Accurate, avoids clickbait
- Vary angles: e.g. story-driven, conclusion-driven, question-driven
+Put the strongest hook first and mark it (recommended).

-If frontmatter already has `title`, skip selection and use it. If first line is H1, extract to frontmatter as default title but still offer alternatives.
+**Title principles:**
+- **Hook in first 5 chars**: create information gap or cognitive conflict
+- **Specific > abstract**: "150 lines" beats "a document"
+- **Negation > affirmation**: "you're doing it wrong" beats "the right way"
+- **Conversational**: like chatting with a friend, not a paper title
+- **Max ~25 chars**: longer titles get truncated in feeds
+- **Accurate, not clickbait**: the article must deliver what the title promises
+
+**Prohibited patterns:**
+- "浅谈 XX"、"关于 XX 的思考"、"XX 的探索与实践"
+- "震惊！"、"万字长文"、"建议收藏"
+- Pure questions without direction: "AI 写作的未来在哪里？"
+
+If first line is H1, extract to frontmatter and remove from body. If frontmatter already has `title`, include it as context but still generate fresh candidates.

 **Summary Generation:**

-Generate 3 candidate summaries with different focuses. Present to user for selection:
+Generate 3 candidate summaries with different angles. Present to user:

 ```
 Pick a summary:
@@ -202,11 +236,17 @@ Pick a summary:
 Enter number, or type a custom summary:
 ```

-Summary principles:
+**Summary principles:**
 - 80-150 characters, precise and information-rich
- Convey article's core value, not just topic
- Vary focuses: e.g. problem-driven, result-driven, insight-driven
- Avoid generic descriptions like "本文介绍了..."
+- Convey **core value** to the reader, not just the topic
+- Vary angles: problem-driven, result-driven, insight-driven
+- **Hook the reader**: make them want to read the full article
+- Use concrete details (numbers, outcomes, specific methods) over vague descriptions
+
+**Prohibited patterns:**
+- "本文介绍了..."、"本文探讨了..."
+- Pure topic description without value proposition
+- Repeating the title in different words

 If frontmatter already has `summary`, skip selection and use it.

@@ -240,9 +280,11 @@ Apply formatting guided by the Step 2 analysis. The goal is making the content s

 **Formatting principles — what TO do:**
 - Preserve the author's voice, tone, and every word
- Use bold sparingly for genuinely important points
+- **Bold key conclusions and core takeaways** — the sentences a reader would highlight
 - Extract parallel items from prose into lists only when the structure is clearly there
- Add headings where the topic genuinely shifts
+- Add headings where the topic genuinely shifts — prefer vivid, specific headings over generic ones (e.g., "3 天搞定 vs 传统方案" over "方案对比")
+- Use tables for comparisons or structured data buried in prose
+- Use blockquotes for golden quotes, memorable statements, or important warnings
 - Fix obvious typos (based on Step 2 findings)

 ### Step 5: Save Formatted File
@@ -262,7 +304,7 @@ fi
 Run the formatting script on the output file:

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]
+${BUN_X} {baseDir}/scripts/main.ts {output-file-path} [options]
 ```

 **Script Options:**
@@ -280,13 +322,13 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]

 ```bash
 # Default: spacing + emphasis enabled, quotes disabled
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md
+${BUN_X} {baseDir}/scripts/main.ts article.md

 # Enable all features including quote replacement
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --quotes
+${BUN_X} {baseDir}/scripts/main.ts article.md --quotes

 # Only fix emphasis issues, skip spacing
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --no-spacing
+${BUN_X} {baseDir}/scripts/main.ts article.md --no-spacing
 ```

 **Script performs (based on options):**
@@ -319,7 +361,7 @@ Display a report summarizing all changes made:
 - Tables created: X
 - Code markers added: X
 - Blockquotes added: X
- Typos fixed: X [list each: "原文" → "修正"]
+- Typos fixed: X [list each: "original" → "corrected"]

 **Typography Script:**
 - CJK spacing: [applied/skipped]
@@ -1,6 +1,14 @@
 ---
 name: baoyu-image-gen
 description: AI image generation with OpenAI, Google, DashScope and Replicate APIs. Supports text-to-image, reference images, aspect ratios. Sequential by default; parallel generation available on request. Use when user asks to generate, create, or draw images.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-image-gen
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Image Generation (AI SDK)
@@ -10,8 +18,8 @@ Official API-based image generation. Supports OpenAI, Google, DashScope (阿里
 ## Script Directory

 **Agent Execution**:
-1. `SKILL_DIR` = this SKILL.md file's directory
-2. Script path = `${SKILL_DIR}/scripts/main.ts`
+1. `{baseDir}` = this SKILL.md file's directory
+2. Script path = `{baseDir}/scripts/main.ts`
 3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 ## Step 0: Load Preferences ⛔ BLOCKING
@@ -52,34 +60,34 @@ Schema: `references/config/preferences-schema.md`

 ```bash
 # Basic
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image cat.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image cat.png

 # With aspect ratio
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9

 # High quality
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k

 # From prompt files
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png
+${BUN_X} {baseDir}/scripts/main.ts --promptfiles system.md content.md --image out.png

 # With reference images (Google multimodal or OpenAI edits)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png

 # With reference images (explicit provider/model)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png

 # Specific provider
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider openai
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider openai

 # DashScope (阿里通义万象)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope
+${BUN_X} {baseDir}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope

 # Replicate (google/nano-banana-pro)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate

 # Replicate with specific model
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
 ```

 ## Options
@@ -144,10 +152,10 @@ Examples:

 ```bash
 # Use Replicate default model
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate

 # Override model explicitly
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
 ```

 ## Provider Selection
@@ -1,6 +1,10 @@
 ---
 name: baoyu-infographic
 description: Generates professional infographics with 21 layout types and 20 visual styles. Analyzes content, recommends layout×style combinations, and generates publication-ready infographics. Use when user asks to create "infographic", "信息图", "visual summary", "可视化", or "高密度信息大图".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-infographic
 ---

 # Infographic Generator
@@ -1,6 +1,14 @@
 ---
 name: baoyu-markdown-to-html
-description: Converts Markdown to styled HTML with WeChat-compatible themes. Supports code highlighting, math, PlantUML, footnotes, alerts, and infographics. Use when user asks for "markdown to html", "convert md to html", "md转html", or needs styled HTML output from markdown.
+description: Converts Markdown to styled HTML with WeChat-compatible themes. Supports code highlighting, math, PlantUML, footnotes, alerts, infographics, and optional bottom citations for external links. Use when user asks for "markdown to html", "convert md to html", "md转html", "微信外链转底部引用", or needs styled HTML output from markdown.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-markdown-to-html
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Markdown to HTML Converter
@@ -9,7 +17,7 @@ Converts Markdown files to beautifully styled HTML with inline CSS, optimized fo

 ## Script Directory

-**Agent Execution**: Determine this SKILL.md directory as `SKILL_DIR`. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `${SKILL_DIR}` and `${BUN_X}` with actual values.
+**Agent Execution**: Determine this SKILL.md directory as `{baseDir}`. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `{baseDir}` and `${BUN_X}` with actual values.

 | Script | Purpose |
 |--------|---------|
@@ -98,15 +106,26 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md") { Select-Str

 | Theme | Description |
 |-------|-------------|
-| `default` (Recommended) | 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 |
-| `grace` | 优雅主题 - 文字阴影，圆角卡片，精致引用块 |
-| `simple` | 简洁主题 - 现代极简风，不对称圆角，清爽留白 |
-| `modern` | 现代主题 - 大圆角、药丸形标题、宽松行距（搭配 `--color red` 还原传统红金风格） |
+| `default` (Recommended) | Classic - traditional layout, centered title with bottom border, H2 with white text on colored background |
+| `grace` | Elegant - text shadow, rounded cards, refined blockquotes |
+| `simple` | Minimal - modern minimalist, asymmetric rounded corners, clean whitespace |
+| `modern` | Modern - large radius, pill-shaped titles, relaxed line height (pair with `--color red` for traditional red-gold style) |
+
+### Step 1.5: Determine Citation Mode
+
+**Default**: Off. Do not ask by default.
+
+**Enable only if the user explicitly asks** for "微信外链转底部引用", "底部引用", "文末引用", or passes `--cite`.
+
+**Behavior when enabled**:
+- Ordinary external links are rendered with numbered superscripts and collected under a final `引用链接` section.
+- `https://mp.weixin.qq.com/...` links stay as direct links and are not moved to the bottom.
+- Bare links where link text equals URL stay inline.

 ### Step 2: Convert

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>
+${BUN_X} {baseDir}/scripts/main.ts <markdown_file> --theme <theme> [--cite]
 ```

 ### Step 3: Report Result
@@ -116,7 +135,7 @@ Display the output path from JSON result. If backup was created, mention it.
 ## Usage

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <markdown_file> [options]
+${BUN_X} {baseDir}/scripts/main.ts <markdown_file> [options]
 ```

 **Options:**
@@ -128,6 +147,7 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts <markdown_file> [options]
 | `--font-family <name>` | Font: sans, serif, serif-cjk, mono, or CSS value | theme default |
 | `--font-size <N>` | Font size: 14px, 15px, 16px, 17px, 18px | 16px |
 | `--title <title>` | Override title from frontmatter | |
+| `--cite` | Convert external links to bottom citations, append `引用链接` section | false (off) |
 | `--keep-title` | Keep the first heading in content | false (removed) |
 | `--help` | Show help | |

@@ -135,37 +155,40 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts <markdown_file> [options]

 | Name | Hex | Label |
 |------|-----|-------|
-| blue | #0F4C81 | 经典蓝 |
-| green | #009874 | 翡翠绿 |
-| vermilion | #FA5151 | 活力橘 |
-| yellow | #FECE00 | 柠檬黄 |
-| purple | #92617E | 薰衣紫 |
-| sky | #55C9EA | 天空蓝 |
-| rose | #B76E79 | 玫瑰金 |
-| olive | #556B2F | 橄榄绿 |
-| black | #333333 | 石墨黑 |
-| gray | #A9A9A9 | 雾烟灰 |
-| pink | #FFB7C5 | 樱花粉 |
-| red | #A93226 | 中国红 |
-| orange | #D97757 | 暖橘 (modern default) |
+| blue | #0F4C81 | Classic Blue |
+| green | #009874 | Emerald Green |
+| vermilion | #FA5151 | Vibrant Vermilion |
+| yellow | #FECE00 | Lemon Yellow |
+| purple | #92617E | Lavender Purple |
+| sky | #55C9EA | Sky Blue |
+| rose | #B76E79 | Rose Gold |
+| olive | #556B2F | Olive Green |
+| black | #333333 | Graphite Black |
+| gray | #A9A9A9 | Smoke Gray |
+| pink | #FFB7C5 | Sakura Pink |
+| red | #A93226 | China Red |
+| orange | #D97757 | Warm Orange (modern default) |

 **Examples:**

 ```bash
 # Basic conversion (uses default theme, removes first heading)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md
+${BUN_X} {baseDir}/scripts/main.ts article.md

 # With specific theme
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --theme grace
+${BUN_X} {baseDir}/scripts/main.ts article.md --theme grace

 # Theme with custom color
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --theme modern --color red
+${BUN_X} {baseDir}/scripts/main.ts article.md --theme modern --color red
+
+# Enable bottom citations for ordinary external links
+${BUN_X} {baseDir}/scripts/main.ts article.md --cite

 # Keep the first heading in content
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --keep-title
+${BUN_X} {baseDir}/scripts/main.ts article.md --keep-title

 # Override title
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --title "My Article"
+${BUN_X} {baseDir}/scripts/main.ts article.md --title "My Article"
 ```

 ## Output
@@ -200,10 +223,10 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --title "My Article"

 | Theme | Description |
 |-------|-------------|
-| `default` | 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 |
-| `grace` | 优雅主题 - 文字阴影，圆角卡片，精致引用块 (by @brzhang) |
-| `simple` | 简洁主题 - 现代极简风，不对称圆角，清爽留白 (by @okooo5km) |
-| `modern` | 现代主题 - 大圆角、药丸形标题、宽松行距（搭配 `--color red` 还原传统红金风格） |
+| `default` | Classic - traditional layout, centered title with bottom border, H2 with white text on colored background |
+| `grace` | Elegant - text shadow, rounded cards, refined blockquotes (by @brzhang) |
+| `simple` | Minimal - modern minimalist, asymmetric rounded corners, clean whitespace (by @okooo5km) |
+| `modern` | Modern - large radius, pill-shaped titles, relaxed line height (pair with `--color red` for traditional red-gold style) |

 ## Supported Markdown Features

@@ -215,7 +238,7 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --title "My Article"
 | Inline code | `` `code` `` |
 | Tables | GitHub-flavored markdown tables |
 | Images | `![alt](src)` |
-| Links | `[text](url)` with footnote references |
+| Links | `[text](url)`; add `--cite` to move ordinary external links into bottom references |
 | Blockquotes | `> quote` |
 | Lists | `-` unordered, `1.` ordered |
 | Alerts | `> [!NOTE]`, `> [!WARNING]`, etc. |
@@ -122,11 +122,15 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
  return { frontmatter, body: match[2]! };
 }

-export async function convertMarkdown(markdownPath: string, options?: { title?: string; theme?: string; keepTitle?: boolean }): Promise<ParsedResult> {
+export async function convertMarkdown(
+  markdownPath: string,
+  options?: { title?: string; theme?: string; keepTitle?: boolean; citeStatus?: boolean }
+): Promise<ParsedResult> {
  const baseDir = path.dirname(markdownPath);
  const content = fs.readFileSync(markdownPath, 'utf-8');
  const theme = options?.theme ?? 'default';
  const keepTitle = options?.keepTitle ?? false;
+  const citeStatus = options?.citeStatus ?? false;

  const { frontmatter, body } = parseFrontmatter(content);

@@ -191,7 +195,7 @@ export async function convertMarkdown(markdownPath: string, options?: { title?:

  const modifiedMarkdown = `---\n${Object.entries(frontmatter).map(([k, v]) => `${k}: ${v}`).join('\n')}\n---\n${modifiedBody}`;

-  console.error(`[markdown-to-html] Rendering with theme: ${theme}, keepTitle: ${keepTitle}`);
+  console.error(`[markdown-to-html] Rendering with theme: ${theme}, keepTitle: ${keepTitle}, citeStatus: ${citeStatus}`);

  const themeDefaults = THEME_STYLE_DEFAULTS[theme] ?? {};
  const style: StyleConfig = { ...DEFAULT_STYLE, ...themeDefaults };
@@ -199,7 +203,7 @@ export async function convertMarkdown(markdownPath: string, options?: { title?:
  const css = normalizeThemeCss(buildCss(baseCss, themeCss, style));
  const codeThemeCss = loadCodeThemeCss('github');

-  const renderer = initRenderer({});
+  const renderer = initRenderer({ citeStatus });
  const { html: baseHtml, readingTime } = renderMarkdown(modifiedMarkdown, renderer);
  let htmlContent = postProcessHtml(baseHtml, readingTime, renderer);
  if (!keepTitle) htmlContent = removeFirstHeading(htmlContent);
@@ -263,6 +267,7 @@ Usage:
 Options:
  --title <title>     Override title
  --theme <name>      Theme name (default, grace, simple). Default: default
+  --cite              Convert ordinary external links to bottom citations. Default: off
  --keep-title        Keep the first heading in content. Default: false (removed)
  --help              Show this help

@@ -284,6 +289,7 @@ Output JSON format:
 Example:
  npx -y bun main.ts article.md
  npx -y bun main.ts article.md --theme grace
+  npx -y bun main.ts article.md --cite
 `);
  process.exit(0);
 }
@@ -297,6 +303,7 @@ async function main(): Promise<void> {
  let markdownPath: string | undefined;
  let title: string | undefined;
  let theme: string | undefined;
+  let citeStatus = false;
  let keepTitle = false;

  for (let i = 0; i < args.length; i++) {
@@ -305,6 +312,8 @@ async function main(): Promise<void> {
      title = args[++i];
    } else if (arg === '--theme' && args[i + 1]) {
      theme = args[++i];
+    } else if (arg === '--cite') {
+      citeStatus = true;
    } else if (arg === '--keep-title') {
      keepTitle = true;
    } else if (!arg.startsWith('-')) {
@@ -322,7 +331,7 @@ async function main(): Promise<void> {
    process.exit(1);
  }

-  const result = await convertMarkdown(markdownPath, { title, theme, keepTitle });
+  const result = await convertMarkdown(markdownPath, { title, theme, keepTitle, citeStatus });
  console.log(JSON.stringify(result, null, 2));
 }

@@ -1,6 +1,14 @@
 ---
 name: baoyu-post-to-wechat
-description: Posts content to WeChat Official Account (微信公众号) via API or Chrome CDP. Supports article posting (文章) with HTML, markdown, or plain text input, and image-text posting (贴图, formerly 图文) with multiple images. Use when user mentions "发布公众号", "post to wechat", "微信公众号", or "贴图/图文/文章".
+description: Posts content to WeChat Official Account (微信公众号) via API or Chrome CDP. Supports article posting (文章) with HTML, markdown, or plain text input, and image-text posting (贴图, formerly 图文) with multiple images. Markdown article workflows default to converting ordinary external links into bottom citations for WeChat-friendly output. Use when user mentions "发布公众号", "post to wechat", "微信公众号", or "贴图/图文/文章".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-wechat
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Post to WeChat Official Account
@@ -11,7 +19,7 @@ description: Posts content to WeChat Official Account (微信公众号) via API

 ## Script Directory

-**Agent Execution**: Determine this SKILL.md directory as `SKILL_DIR`, then use `${SKILL_DIR}/scripts/<name>.ts`. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun.
+**Agent Execution**: Determine this SKILL.md directory as `{baseDir}`, then use `{baseDir}/scripts/<name>.ts`. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun.

 | Script | Purpose |
 |--------|---------|
@@ -92,7 +100,7 @@ chrome_profile_path: /path/to/chrome/profile
 Before first use, suggest running the environment check. User can skip if they prefer.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/check-permissions.ts
+${BUN_X} {baseDir}/scripts/check-permissions.ts
 ```

 Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystroke, API credentials, Chrome conflicts.
@@ -115,8 +123,8 @@ Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystrok
 For short posts with multiple images (up to 9):

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/wechat-browser.ts --markdown article.md --images ./images/
-${BUN_X} ${SKILL_DIR}/scripts/wechat-browser.ts --title "标题" --content "内容" --image img.png --submit
+${BUN_X} {baseDir}/scripts/wechat-browser.ts --markdown article.md --images ./images/
+${BUN_X} {baseDir}/scripts/wechat-browser.ts --title "标题" --content "内容" --image img.png --submit
 ```

 See [references/image-text-posting.md](references/image-text-posting.md) for details.
@@ -252,10 +260,15 @@ WECHAT_APP_SECRET=<user_input>

 **CRITICAL**: Publishing scripts handle markdown conversion internally. Do NOT pre-convert markdown to HTML — pass the original markdown file directly. This ensures the API method renders images as `<img>` tags (for API upload) while the browser method uses placeholders (for paste-and-replace workflow).

+**Markdown citation default**:
+- For markdown input, ordinary external links are converted to bottom citations by default.
+- Use `--no-cite` only if the user explicitly wants to keep ordinary external links inline.
+- Existing HTML input is left as-is; no extra citation conversion is applied.
+
 **API method** (accepts `.md` or `.html`):

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/wechat-api.ts <file> --theme <theme> [--color <color>] [--title <title>] [--summary <summary>] [--author <author>] [--cover <cover_path>]
+${BUN_X} {baseDir}/scripts/wechat-api.ts <file> --theme <theme> [--color <color>] [--title <title>] [--summary <summary>] [--author <author>] [--cover <cover_path>] [--no-cite]
 ```

 **CRITICAL**: Always include `--theme` parameter. Never omit it, even if using `default`. Only include `--color` if explicitly set by user or EXTEND.md.
@@ -274,8 +287,8 @@ If script parameters do not expose the two comment fields, still ensure final AP
 **Browser method** (accepts `--markdown` or `--html`):

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/wechat-article.ts --markdown <markdown_file> --theme <theme> [--color <color>]
-${BUN_X} ${SKILL_DIR}/scripts/wechat-article.ts --html <html_file>
+${BUN_X} {baseDir}/scripts/wechat-article.ts --markdown <markdown_file> --theme <theme> [--color <color>] [--no-cite]
+${BUN_X} {baseDir}/scripts/wechat-article.ts --html <html_file>
 ```

 ### Step 5: Completion Report
@@ -11,6 +11,9 @@ ${BUN_X} ./scripts/wechat-article.ts --markdown article.md
 # With theme
 ${BUN_X} ./scripts/wechat-article.ts --markdown article.md --theme grace

+# Disable bottom citations for ordinary external links
+${BUN_X} ./scripts/wechat-article.ts --markdown article.md --no-cite
+
 # With explicit options
 ${BUN_X} ./scripts/wechat-article.ts --markdown article.md --author "作者名" --summary "摘要"
 ```
@@ -21,6 +24,7 @@ ${BUN_X} ./scripts/wechat-article.ts --markdown article.md --author "作者名"
 |-----------|-------------|
 | `--markdown <path>` | Markdown file to convert and post |
 | `--theme <name>` | Theme: default, grace, simple, modern |
+| `--no-cite` | Keep ordinary external links inline instead of converting them to bottom citations |
 | `--title <text>` | Override title (auto-extracted from markdown) |
 | `--author <name>` | Author name |
 | `--summary <text>` | Article summary |
@@ -51,6 +55,8 @@ Regular paragraph with **bold** and *italic*.
 [Link text](https://example.com)
 ```

+Markdown mode converts ordinary external links into bottom citations by default for WeChat-friendly output. Use `--no-cite` to disable that behavior.
+
 ## Image Handling

 1. **Parse**: Images in markdown are replaced with `WECHATIMGPH_N`
@@ -112,10 +112,14 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
  return { frontmatter, body: match[2]! };
 }

-export async function convertMarkdown(markdownPath: string, options?: { title?: string; theme?: string; color?: string }): Promise<ParsedResult> {
+export async function convertMarkdown(
+  markdownPath: string,
+  options?: { title?: string; theme?: string; color?: string; citeStatus?: boolean }
+): Promise<ParsedResult> {
  const baseDir = path.dirname(markdownPath);
  const content = fs.readFileSync(markdownPath, 'utf-8');
  const theme = options?.theme ?? 'default';
+  const citeStatus = options?.citeStatus ?? true;

  const { frontmatter, body } = parseFrontmatter(content);

@@ -185,8 +189,9 @@ export async function convertMarkdown(markdownPath: string, options?: { title?:

  const renderArgs = ['-y', 'bun', renderScript, tempMdPath, '--theme', theme];
  if (options?.color) renderArgs.push('--color', options.color);
+  if (citeStatus) renderArgs.push('--cite');

-  console.error(`[md-to-wechat] Rendering markdown with theme: ${theme}${options?.color ? `, color: ${options.color}` : ''}`);
+  console.error(`[md-to-wechat] Rendering markdown with theme: ${theme}${options?.color ? `, color: ${options.color}` : ''}, citeStatus: ${citeStatus}`);

  const result = spawnSync('npx', renderArgs, {
    stdio: ['inherit', 'pipe', 'pipe'],
@@ -232,6 +237,7 @@ Options:
  --title <title>     Override title
  --theme <name>      Theme name (default, grace, simple, modern)
  --color <name|hex>  Primary color (blue, green, vermilion, etc. or hex)
+  --no-cite           Disable bottom citations for ordinary external links
  --help              Show this help

 Output JSON format:
@@ -251,6 +257,7 @@ Example:
  npx -y bun md-to-wechat.ts article.md
  npx -y bun md-to-wechat.ts article.md --theme grace
  npx -y bun md-to-wechat.ts article.md --theme modern --color blue
+  npx -y bun md-to-wechat.ts article.md --no-cite
 `);
  process.exit(0);
 }
@@ -265,6 +272,7 @@ async function main(): Promise<void> {
  let title: string | undefined;
  let theme: string | undefined;
  let color: string | undefined;
+  let citeStatus = true;

  for (let i = 0; i < args.length; i++) {
    const arg = args[i]!;
@@ -274,6 +282,10 @@ async function main(): Promise<void> {
      theme = args[++i];
    } else if (arg === '--color' && args[i + 1]) {
      color = args[++i];
+    } else if (arg === '--cite') {
+      citeStatus = true;
+    } else if (arg === '--no-cite') {
+      citeStatus = false;
    } else if (!arg.startsWith('-')) {
      markdownPath = arg;
    }
@@ -289,7 +301,7 @@ async function main(): Promise<void> {
    process.exit(1);
  }

-  const result = await convertMarkdown(markdownPath, { title, theme, color });
+  const result = await convertMarkdown(markdownPath, { title, theme, color, citeStatus });
  console.log(JSON.stringify(result, null, 2));
 }

@@ -307,7 +307,12 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
  return { frontmatter, body: match[2]! };
 }

-function renderMarkdownToHtml(markdownPath: string, theme: string = "default", color?: string): string {
+function renderMarkdownToHtml(
+  markdownPath: string,
+  theme: string = "default",
+  color?: string,
+  citeStatus: boolean = true
+): string {
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = path.dirname(__filename);
  const renderScript = path.join(__dirname, "md", "render.ts");
@@ -315,8 +320,9 @@ function renderMarkdownToHtml(markdownPath: string, theme: string = "default", c

  const renderArgs = ["-y", "bun", renderScript, markdownPath, "--theme", theme];
  if (color) renderArgs.push("--color", color);
+  if (citeStatus) renderArgs.push("--cite");

-  console.error(`[wechat-api] Rendering markdown with theme: ${theme}${color ? `, color: ${color}` : ""}`);
+  console.error(`[wechat-api] Rendering markdown with theme: ${theme}${color ? `, color: ${color}` : ""}, citeStatus: ${citeStatus}`);
  const result = spawnSync("npx", renderArgs, {
    stdio: ["inherit", "pipe", "pipe"],
    cwd: baseDir,
@@ -362,6 +368,7 @@ Options:
  --theme <name>      Theme name for markdown (default, grace, simple, modern). Default: default
  --color <name|hex>  Primary color (blue, green, vermilion, etc. or hex)
  --cover <path>      Cover image path (local or URL)
+  --no-cite           Disable bottom citations for ordinary external links in markdown mode
  --dry-run           Parse and render only, don't publish
  --help              Show this help

@@ -390,6 +397,7 @@ Example:
  npx -y bun wechat-api.ts article.html --title "My Article"
  npx -y bun wechat-api.ts images/ --type newspic --title "Photo Album"
  npx -y bun wechat-api.ts article.md --dry-run
+  npx -y bun wechat-api.ts article.md --no-cite
 `);
  process.exit(0);
 }
@@ -404,6 +412,7 @@ interface CliArgs {
  theme: string;
  color?: string;
  cover?: string;
+  citeStatus: boolean;
  dryRun: boolean;
 }

@@ -417,6 +426,7 @@ function parseArgs(argv: string[]): CliArgs {
    isHtml: false,
    articleType: "news",
    theme: "default",
+    citeStatus: true,
    dryRun: false,
  };

@@ -439,6 +449,10 @@ function parseArgs(argv: string[]): CliArgs {
      args.color = argv[++i];
    } else if (arg === "--cover" && argv[i + 1]) {
      args.cover = argv[++i];
+    } else if (arg === "--cite") {
+      args.citeStatus = true;
+    } else if (arg === "--no-cite") {
+      args.citeStatus = false;
    } else if (arg === "--dry-run") {
      args.dryRun = true;
    } else if (arg.startsWith("--") && argv[i + 1] && !argv[i + 1]!.startsWith("-")) {
@@ -513,8 +527,8 @@ async function main(): Promise<void> {
    if (!author) author = frontmatter.author || "";
    if (!digest) digest = frontmatter.digest || frontmatter.summary || frontmatter.description || "";

-    console.error(`[wechat-api] Theme: ${args.theme}${args.color ? `, color: ${args.color}` : ""}`);
-    htmlPath = renderMarkdownToHtml(filePath, args.theme, args.color);
+    console.error(`[wechat-api] Theme: ${args.theme}${args.color ? `, color: ${args.color}` : ""}, citeStatus: ${args.citeStatus}`);
+    htmlPath = renderMarkdownToHtml(filePath, args.theme, args.color, args.citeStatus);
    console.error(`[wechat-api] HTML generated: ${htmlPath}`);
    htmlContent = extractHtmlContent(htmlPath);
  }
@@ -20,6 +20,7 @@ interface ArticleOptions {
  markdownFile?: string;
  theme?: string;
  color?: string;
+  citeStatus?: boolean;
  author?: string;
  summary?: string;
  images?: string[];
@@ -182,13 +183,19 @@ async function pasteFromClipboardInEditor(session: ChromeSession): Promise<void>
  await sleep(1000);
 }

-async function parseMarkdownWithPlaceholders(markdownPath: string, theme?: string, color?: string): Promise<{ title: string; author: string; summary: string; htmlPath: string; contentImages: ImageInfo[] }> {
+async function parseMarkdownWithPlaceholders(
+  markdownPath: string,
+  theme?: string,
+  color?: string,
+  citeStatus: boolean = true
+): Promise<{ title: string; author: string; summary: string; htmlPath: string; contentImages: ImageInfo[] }> {
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = path.dirname(__filename);
  const mdToWechatScript = path.join(__dirname, 'md-to-wechat.ts');
  const args = ['-y', 'bun', mdToWechatScript, markdownPath];
  if (theme) args.push('--theme', theme);
  if (color) args.push('--color', color);
+  if (!citeStatus) args.push('--no-cite');

  const result = spawnSync('npx', args, { stdio: ['inherit', 'pipe', 'pipe'] });
  if (result.status !== 0) {
@@ -383,7 +390,7 @@ async function removeExtraEmptyLineAfterImage(session: ChromeSession): Promise<b
 }

 export async function postArticle(options: ArticleOptions): Promise<void> {
-  const { title, content, htmlFile, markdownFile, theme, color, author, summary, images = [], submit = false, profileDir, cdpPort } = options;
+  const { title, content, htmlFile, markdownFile, theme, color, citeStatus = true, author, summary, images = [], submit = false, profileDir, cdpPort } = options;
  let { contentImages = [] } = options;
  let effectiveTitle = title || '';
  let effectiveAuthor = author || '';
@@ -392,7 +399,7 @@ export async function postArticle(options: ArticleOptions): Promise<void> {

  if (markdownFile) {
    console.log(`[wechat] Parsing markdown: ${markdownFile}`);
-    const parsed = await parseMarkdownWithPlaceholders(markdownFile, theme, color);
+    const parsed = await parseMarkdownWithPlaceholders(markdownFile, theme, color, citeStatus);
    effectiveTitle = effectiveTitle || parsed.title;
    effectiveAuthor = effectiveAuthor || parsed.author;
    effectiveSummary = effectiveSummary || parsed.summary;
@@ -677,6 +684,7 @@ Options:
  --markdown <path>  Markdown file to convert and post (recommended)
  --theme <name>     Theme for markdown (default, grace, simple, modern)
  --color <name|hex> Primary color (blue, green, vermilion, etc. or hex)
+  --no-cite          Disable bottom citations for ordinary external links in markdown mode
  --author <name>    Author name
  --summary <text>   Article summary
  --image <path>     Content image, can repeat (only with --content)
@@ -687,13 +695,15 @@ Options:
 Examples:
  npx -y bun wechat-article.ts --markdown article.md
  npx -y bun wechat-article.ts --markdown article.md --theme grace --submit
+  npx -y bun wechat-article.ts --markdown article.md --no-cite
  npx -y bun wechat-article.ts --title "标题" --content "内容" --image img.png
  npx -y bun wechat-article.ts --title "标题" --html article.html --submit

 Markdown mode:
  Images in markdown are converted to placeholders. After pasting HTML,
  each placeholder is selected, scrolled into view, deleted, and replaced
-  with the actual image via paste.
+  with the actual image via paste. Ordinary external links are converted to
+  bottom citations by default.
 `);
  process.exit(0);
 }
@@ -709,6 +719,7 @@ async function main(): Promise<void> {
  let markdownFile: string | undefined;
  let theme: string | undefined;
  let color: string | undefined;
+  let citeStatus = true;
  let author: string | undefined;
  let summary: string | undefined;
  let submit = false;
@@ -723,6 +734,8 @@ async function main(): Promise<void> {
    else if (arg === '--markdown' && args[i + 1]) markdownFile = args[++i];
    else if (arg === '--theme' && args[i + 1]) theme = args[++i];
    else if (arg === '--color' && args[i + 1]) color = args[++i];
+    else if (arg === '--cite') citeStatus = true;
+    else if (arg === '--no-cite') citeStatus = false;
    else if (arg === '--author' && args[i + 1]) author = args[++i];
    else if (arg === '--summary' && args[i + 1]) summary = args[++i];
    else if (arg === '--image' && args[i + 1]) images.push(args[++i]!);
@@ -734,7 +747,7 @@ async function main(): Promise<void> {
  if (!markdownFile && !htmlFile && !title) { console.error('Error: --title is required (or use --markdown/--html)'); process.exit(1); }
  if (!markdownFile && !htmlFile && !content) { console.error('Error: --content, --html, or --markdown is required'); process.exit(1); }

-  await postArticle({ title: title || '', content, htmlFile, markdownFile, theme, color, author, summary, images, submit, profileDir, cdpPort });
+  await postArticle({ title: title || '', content, htmlFile, markdownFile, theme, color, citeStatus, author, summary, images, submit, profileDir, cdpPort });
 }

 await main().then(() => {
@@ -551,37 +551,126 @@ export async function postToWeChat(options: WeChatBrowserOptions): Promise<void>
    const absolutePaths = images.map(p => path.isAbsolute(p) ? p : path.resolve(process.cwd(), p));
    console.log(`[wechat-browser] Images: ${absolutePaths.join(', ')}`);

-    const { root } = await cdp.send<{ root: { nodeId: number } }>('DOM.getDocument', {}, { sessionId });
+    // --- PRIMARY approach: intercept file chooser dialog ---
+    let uploadSuccess = false;
+    try {
+      console.log('[wechat-browser] [primary] Enabling file chooser interception...');
+      await cdp.send('Page.setInterceptFileChooserDialog', { enabled: true }, { sessionId });

-    // Try primary selector, then fallback to any multi-file image input
-    let { nodeId } = await cdp.send<{ nodeId: number }>('DOM.querySelector', {
-      nodeId: root.nodeId,
-      selector: '.js_upload_btn_container input[type=file]',
-    }, { sessionId });
+      // Set up listener for file chooser opened event BEFORE clicking
+      const fileChooserPromise = new Promise<{ backendNodeId: number; mode: string }>((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error('File chooser dialog not opened within 10s')), 10_000);
+        cdp!.on('Page.fileChooserOpened', (params: unknown) => {
+          clearTimeout(timeout);
+          const p = params as { backendNodeId: number; mode: string };
+          console.log(`[wechat-browser] [primary] File chooser opened: backendNodeId=${p.backendNodeId}, mode=${p.mode}`);
+          resolve(p);
+        });
+      });

-    if (!nodeId) {
-      console.log('[wechat-browser] Primary file input not found, trying fallback selector...');
-      const fallback = await cdp.send<{ nodeId: number }>('DOM.querySelector', {
-        nodeId: root.nodeId,
-        selector: 'input[type=file][multiple][accept*="image"]',
+      // Trigger file chooser by calling .click() on the file input with userGesture
+      const fileInputSelectors = [
+        '.js_upload_btn_container input[type=file]',
+        'input[type=file][multiple][accept*="image"]',
+        'input[type=file][accept*="image"]',
+        'input[type=file][multiple]',
+        'input[type=file]',
+      ];
+
+      console.log('[wechat-browser] [primary] Clicking file input via JS .click() with userGesture...');
+      const clickResult = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {
+        expression: `
+          (function() {
+            const selectors = ${JSON.stringify(fileInputSelectors)};
+            for (const sel of selectors) {
+              const el = document.querySelector(sel);
+              if (el) {
+                el.click();
+                return JSON.stringify({ clicked: sel });
+              }
+            }
+            const debug = [];
+            document.querySelectorAll('input[type=file]').forEach((inp, i) => {
+              debug.push({ i, accept: inp.accept, multiple: inp.multiple, parentClass: inp.parentElement?.className?.slice(0, 60) });
+            });
+            return JSON.stringify({ error: 'no file input found', fileInputs: debug });
+          })()
+        `,
+        returnByValue: true,
+        userGesture: true,
      }, { sessionId });
-      nodeId = fallback.nodeId;
+      console.log(`[wechat-browser] [primary] Click result: ${clickResult.result.value}`);
+
+      const clickStatus = JSON.parse(clickResult.result.value);
+      if (clickStatus.error) {
+        throw new Error(`File input not found: ${clickStatus.error}`);
+      }
+
+      // Wait for the file chooser event
+      console.log('[wechat-browser] [primary] Waiting for file chooser dialog...');
+      const chooser = await fileChooserPromise;
+
+      console.log(`[wechat-browser] [primary] Setting files via backendNodeId=${chooser.backendNodeId}...`);
+      await cdp.send('DOM.setFileInputFiles', {
+        files: absolutePaths,
+        backendNodeId: chooser.backendNodeId,
+      }, { sessionId });
+      console.log('[wechat-browser] [primary] Files set successfully via file chooser interception');
+      uploadSuccess = true;
+    } catch (primaryErr) {
+      console.log(`[wechat-browser] [primary] File chooser approach failed: ${primaryErr instanceof Error ? primaryErr.message : String(primaryErr)}`);
+      // Disable interception before falling back
+      try { await cdp.send('Page.setInterceptFileChooserDialog', { enabled: false }, { sessionId }); } catch {}
    }

-    if (!nodeId) throw new Error('File input not found');
+    // --- FALLBACK approach: direct DOM.setFileInputFiles on nodeId ---
+    if (!uploadSuccess) {
+      console.log('[wechat-browser] [fallback] Trying direct DOM.setFileInputFiles...');
+      const { root } = await cdp.send<{ root: { nodeId: number } }>('DOM.getDocument', {}, { sessionId });

-    await cdp.send('DOM.setFileInputFiles', {
-      nodeId,
-      files: absolutePaths,
-    }, { sessionId });
+      const fileInputSelectors = [
+        '.js_upload_btn_container input[type=file]',
+        'input[type=file][multiple][accept*="image"]',
+        'input[type=file][accept*="image"]',
+        'input[type=file][multiple]',
+        'input[type=file]',
+      ];

-    // Dispatch change event to trigger the upload
-    await cdp.send('Runtime.evaluate', {
-      expression: `
-        const fileInput = document.querySelector('.js_upload_btn_container input[type=file]') || document.querySelector('input[type=file][multiple][accept*="image"]');
-        if (fileInput) fileInput.dispatchEvent(new Event('change', { bubbles: true }));
-      `,
-    }, { sessionId });
+      let nodeId = 0;
+      for (const sel of fileInputSelectors) {
+        const result = await cdp.send<{ nodeId: number }>('DOM.querySelector', { nodeId: root.nodeId, selector: sel }, { sessionId });
+        if (result.nodeId) {
+          console.log(`[wechat-browser] [fallback] Found file input with selector: ${sel}`);
+          nodeId = result.nodeId;
+          break;
+        }
+      }
+
+      if (!nodeId) throw new Error('File input not found with any selector');
+
+      await cdp.send('DOM.setFileInputFiles', { nodeId, files: absolutePaths }, { sessionId });
+      console.log('[wechat-browser] [fallback] Files set via nodeId');
+
+      // Dispatch change event
+      await cdp.send('Runtime.evaluate', {
+        expression: `
+          (function() {
+            const selectors = ${JSON.stringify(fileInputSelectors)};
+            for (const sel of selectors) {
+              const el = document.querySelector(sel);
+              if (el) {
+                el.dispatchEvent(new Event('change', { bubbles: true }));
+                el.dispatchEvent(new Event('input', { bubbles: true }));
+                return 'dispatched on ' + sel;
+              }
+            }
+            return 'no input found for event dispatch';
+          })()
+        `,
+        returnByValue: true,
+      }, { sessionId });
+      console.log('[wechat-browser] [fallback] Change event dispatched');
+    }

    // Wait for images to upload
    console.log('[wechat-browser] Waiting for images to upload...');
@@ -589,11 +678,16 @@ export async function postToWeChat(options: WeChatBrowserOptions): Promise<void>
    for (let i = 0; i < 30; i++) {
      await sleep(2000);
      const uploadCheck = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {
-        expression: `JSON.stringify({ uploaded: document.querySelectorAll('.weui-desktop-upload__thumb, .pic_item, [class*=upload_thumb]').length })`,
+        expression: `
+          JSON.stringify({
+            uploaded: document.querySelectorAll('.weui-desktop-upload__thumb, .pic_item, [class*=upload_thumb], [class*="pic_item"], [class*="upload__thumb"]').length,
+            loading: document.querySelectorAll('[class*="upload_loading"], [class*="uploading"], .weui-desktop-upload__loading').length
+          })
+        `,
        returnByValue: true,
      }, { sessionId });
      const status = JSON.parse(uploadCheck.result.value);
-      console.log(`[wechat-browser] Upload progress: ${status.uploaded}/${targetCount}`);
+      console.log(`[wechat-browser] Upload progress: ${status.uploaded}/${targetCount} (loading: ${status.loading})`);
      if (status.uploaded >= targetCount) break;
    }

@@ -1,6 +1,14 @@
 ---
 name: baoyu-post-to-weibo
 description: Posts content to Weibo (微博). Supports regular posts with text, images, and videos, and headline articles (头条文章) with Markdown input via Chrome CDP. Use when user asks to "post to Weibo", "发微博", "发布微博", "publish to Weibo", "share on Weibo", "写微博", or "微博头条文章".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-weibo
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Post to Weibo
@@ -12,9 +20,9 @@ Posts text, images, videos, and long-form articles to Weibo via real Chrome brow
 **Important**: All scripts are located in the `scripts/` subdirectory of this skill.

 **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
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
+3. Replace all `{baseDir}` in this document with the actual path
 4. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 **Script Reference**:
@@ -72,8 +80,8 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-weibo/EXTEND.md") { "user" }
 Text + images/videos (max 18 files total). Posted on Weibo homepage.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/weibo-post.ts "Hello Weibo!" --image ./photo.png
-${BUN_X} ${SKILL_DIR}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4
+${BUN_X} {baseDir}/scripts/weibo-post.ts "Hello Weibo!" --image ./photo.png
+${BUN_X} {baseDir}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4
 ```

 **Parameters**:
@@ -93,8 +101,8 @@ ${BUN_X} ${SKILL_DIR}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4
 Long-form Markdown articles published at `https://card.weibo.com/article/v3/editor`.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/weibo-article.ts article.md
-${BUN_X} ${SKILL_DIR}/scripts/weibo-article.ts article.md --cover ./cover.jpg
+${BUN_X} {baseDir}/scripts/weibo-article.ts article.md
+${BUN_X} {baseDir}/scripts/weibo-article.ts article.md --cover ./cover.jpg
 ```

 **Parameters**:
@@ -459,7 +459,7 @@ export async function publishArticle(options: ArticleOptions): Promise<void> {
                    if (charAfter === undefined || !/\\d/.test(charAfter)) {
                      const parentElement = node.parentElement;
                      if (parentElement) {
-                        parentElement.scrollIntoView({ behavior: 'smooth', block: 'center' });
+                        parentElement.scrollIntoView({ behavior: 'instant', block: 'center' });
                      }

                      const range = document.createRange();
@@ -500,112 +500,56 @@ export async function publishArticle(options: ArticleOptions): Promise<void> {
          return false;
        };

+        // Step A: Copy image to clipboard first (slow due to Swift compilation)
+        console.log(`[weibo-article] Copying image to clipboard: ${path.basename(img.localPath)}`);
+        if (!copyImageToClipboard(img.localPath)) {
+          console.warn(`[weibo-article] Failed to copy image to clipboard`);
+          continue;
+        }
+        await sleep(500);
+
+        // Step B: Select placeholder text (paste will replace the selection)
        const selected = await selectPlaceholder(3);
        if (!selected) {
          console.warn(`[weibo-article] Skipping image - could not select placeholder: ${img.placeholder}`);
          continue;
        }

-        console.log(`[weibo-article] Copying image: ${path.basename(img.localPath)}`);
-
-        if (!copyImageToClipboard(img.localPath)) {
-          console.warn(`[weibo-article] Failed to copy image to clipboard`);
-          continue;
-        }
-
-        await sleep(1000);
-
-        // Delete placeholder by replacing selection with empty text
-        console.log(`[weibo-article] Deleting placeholder...`);
-        await cdp.send('Runtime.evaluate', {
-          expression: `(() => {
-            const sel = window.getSelection();
-            if (!sel || sel.isCollapsed) return false;
-            const range = sel.getRangeAt(0);
-            range.deleteContents();
-            sel.collapseToStart();
-            return true;
-          })()`,
-          returnByValue: true,
-        }, { sessionId });
-
-        await sleep(300);
-
-        // Fallback: send Backspace key if placeholder still exists
-        const stillExists = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {
-          expression: `(() => {
-            const editor = document.querySelector('div[contenteditable="true"]');
-            if (!editor) return false;
-            const placeholder = ${JSON.stringify(img.placeholder)};
-            const regex = new RegExp(placeholder + '(?!\\\\d)');
-            return regex.test(editor.innerText);
-          })()`,
-          returnByValue: true,
-        }, { sessionId });
-
-        if (stillExists.result.value) {
-          console.log('[weibo-article] Placeholder survived deleteContents, trying Input.insertText replacement...');
-          // Re-select and replace with empty via Input.insertText
-          await cdp!.send('Runtime.evaluate', {
-            expression: `(() => {
-              const editor = document.querySelector('div[contenteditable="true"]');
-              if (!editor) return false;
-              const placeholder = ${JSON.stringify(img.placeholder)};
-              const walker = document.createTreeWalker(editor, NodeFilter.SHOW_TEXT, null, false);
-              let node;
-              while ((node = walker.nextNode())) {
-                const text = node.textContent || '';
-                let searchStart = 0;
-                let idx;
-                while ((idx = text.indexOf(placeholder, searchStart)) !== -1) {
-                  const afterIdx = idx + placeholder.length;
-                  const charAfter = text[afterIdx];
-                  if (charAfter === undefined || !/\\d/.test(charAfter)) {
-                    const range = document.createRange();
-                    range.setStart(node, idx);
-                    range.setEnd(node, idx + placeholder.length);
-                    const sel = window.getSelection();
-                    sel.removeAllRanges();
-                    sel.addRange(range);
-                    return true;
-                  }
-                  searchStart = afterIdx;
-                }
-              }
-              return false;
-            })()`,
-          }, { sessionId });
-          await sleep(200);
-          await cdp!.send('Input.insertText', { text: '' }, { sessionId });
-          await sleep(300);
-        }
-
-        await sleep(200);
+        // Step C: Delete selected placeholder via Backspace (ProseMirror-compatible)
+        console.log(`[weibo-article] Deleting placeholder via Backspace...`);
+        await cdp.send('Input.dispatchKeyEvent', { type: 'keyDown', key: 'Backspace', code: 'Backspace', windowsVirtualKeyCode: 8 }, { sessionId });
+        await cdp.send('Input.dispatchKeyEvent', { type: 'keyUp', key: 'Backspace', code: 'Backspace', windowsVirtualKeyCode: 8 }, { sessionId });
+        await sleep(500);

        // Verify placeholder was deleted
-        const afterDelete = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {
+        const placeholderGone = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {
          expression: `(() => {
            const editor = document.querySelector('div[contenteditable="true"]');
            if (!editor) return true;
-            const text = editor.innerText;
            const placeholder = ${JSON.stringify(img.placeholder)};
            const regex = new RegExp(placeholder + '(?!\\\\d)');
-            return !regex.test(text);
+            return !regex.test(editor.innerText);
          })()`,
          returnByValue: true,
        }, { sessionId });

-        if (afterDelete.result.value) {
+        if (placeholderGone.result.value) {
          console.log(`[weibo-article] Placeholder deleted`);
        } else {
-          console.warn(`[weibo-article] Placeholder may still exist after delete`);
+          console.warn(`[weibo-article] Placeholder may still exist, trying execCommand delete...`);
+          // Re-select and delete via execCommand
+          await selectPlaceholder(1);
+          await cdp.send('Runtime.evaluate', {
+            expression: `document.execCommand('delete')`,
+          }, { sessionId });
+          await sleep(300);
        }

-        // Focus editor for paste
+        // Step D: Focus editor and paste image
        await cdp.send('Runtime.evaluate', {
          expression: `document.querySelector('div[contenteditable="true"]')?.focus()`,
        }, { sessionId });
-        await sleep(300);
+        await sleep(200);

        // Count images before paste
        const imgCountBefore = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {
@@ -613,7 +557,7 @@ export async function publishArticle(options: ArticleOptions): Promise<void> {
          returnByValue: true,
        }, { sessionId });

-        // Paste image
+        // Paste image at cursor position (where placeholder was)
        console.log(`[weibo-article] Pasting image...`);
        if (pasteFromClipboard('Google Chrome', 5, 1000)) {
          console.log(`[weibo-article] Paste keystroke sent for: ${path.basename(img.localPath)}`);
@@ -1,6 +1,14 @@
 ---
 name: baoyu-post-to-x
 description: Posts content and articles to X (Twitter). Supports regular posts with images/videos and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation. Use when user asks to "post to X", "tweet", "publish to Twitter", or "share on X".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-x
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Post to X (Twitter)
@@ -12,9 +20,9 @@ Posts text, images, videos, and long-form articles to X via real Chrome browser
 **Important**: All scripts are located in the `scripts/` subdirectory of this skill.

 **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
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
+3. Replace all `{baseDir}` in this document with the actual path
 4. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 **Script Reference**:
@@ -74,7 +82,7 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md") { "user" }
 Before first use, suggest running the environment check. User can skip if they prefer.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/check-paste-permissions.ts
+${BUN_X} {baseDir}/scripts/check-paste-permissions.ts
 ```

 Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystroke, Chrome conflicts.
@@ -98,12 +106,16 @@ Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystrok

 ---

+## Post Type Selection
+
+Unless the user explicitly specifies the post type:
+- **Plain text** + within 10,000 characters → **Regular Post** (Premium members support up to 10,000 characters, non-Premium: 280)
+- **Markdown file** (.md) → **X Article**
+
 ## Regular Posts

-Text + up to 4 images.
-
 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/x-browser.ts "Hello!" --image ./photo.png
+${BUN_X} {baseDir}/scripts/x-browser.ts "Hello!" --image ./photo.png
 ```

 **Parameters**:
@@ -122,7 +134,7 @@ ${BUN_X} ${SKILL_DIR}/scripts/x-browser.ts "Hello!" --image ./photo.png
 Text + video file.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/x-video.ts "Check this out!" --video ./clip.mp4
+${BUN_X} {baseDir}/scripts/x-video.ts "Check this out!" --video ./clip.mp4
 ```

 **Parameters**:
@@ -143,7 +155,7 @@ ${BUN_X} ${SKILL_DIR}/scripts/x-video.ts "Check this out!" --video ./clip.mp4
 Quote an existing tweet with comment.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!"
+${BUN_X} {baseDir}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!"
 ```

 **Parameters**:
@@ -162,8 +174,8 @@ ${BUN_X} ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "Great in
 Long-form Markdown articles (requires X Premium).

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md --cover ./cover.jpg
+${BUN_X} {baseDir}/scripts/x-article.ts article.md
+${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg
 ```

 **Parameters**:
@@ -12,13 +12,13 @@ Publish Markdown articles to X Articles editor with rich text formatting and ima

 ```bash
 # Publish markdown article (preview mode)
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md
+${BUN_X} {baseDir}/scripts/x-article.ts article.md

 # With custom cover image
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md --cover ./cover.jpg
+${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg

 # Actually publish
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md --submit
+${BUN_X} {baseDir}/scripts/x-article.ts article.md --submit
 ```

 ## Markdown Format
@@ -76,13 +76,13 @@ Convert markdown and inspect structure:

 ```bash
 # Get JSON with all metadata
-${BUN_X} ${SKILL_DIR}/scripts/md-to-html.ts article.md
+${BUN_X} {baseDir}/scripts/md-to-html.ts article.md

 # Output HTML only
-${BUN_X} ${SKILL_DIR}/scripts/md-to-html.ts article.md --html-only
+${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --html-only

 # Save HTML to file
-${BUN_X} ${SKILL_DIR}/scripts/md-to-html.ts article.md --save-html /tmp/article.html
+${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/article.html
 ```

 JSON output:
@@ -161,7 +161,7 @@ Claude:
 - **No create button**: Ensure X Premium subscription is active
 - **Cover upload fails**: Check file path and format (PNG, JPEG)
 - **Images not inserting**: Verify placeholders exist in pasted content
- **Content not pasting**: Check HTML clipboard: `${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts html --file /tmp/test.html`
+- **Content not pasting**: Check HTML clipboard: `${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts html --file /tmp/test.html`

 ## How It Works

@@ -9,20 +9,20 @@ If you prefer step-by-step control:
 ### Step 1: Copy Image to Clipboard

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts image /path/to/image.png
+${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts image /path/to/image.png
 ```

 ### Step 2: Paste from Clipboard

 ```bash
 # Simple paste to frontmost app
-${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts
+${BUN_X} {baseDir}/scripts/paste-from-clipboard.ts

 # Paste to Chrome with retries
-${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts --app "Google Chrome" --retries 5
+${BUN_X} {baseDir}/scripts/paste-from-clipboard.ts --app "Google Chrome" --retries 5

 # Quick paste with shorter delay
-${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts --delay 200
+${BUN_X} {baseDir}/scripts/paste-from-clipboard.ts --delay 200
 ```

 ### Step 3: Use Playwright MCP (if Chrome session available)
@@ -59,7 +59,7 @@ mcp__playwright__browser_take_screenshot filename="preview.png"
 User: /post-to-x "Hello from Claude!" --image ./screenshot.png

 Claude:
-1. Runs: ${BUN_X} ${SKILL_DIR}/scripts/x-browser.ts "Hello from Claude!" --image ./screenshot.png
+1. Runs: ${BUN_X} {baseDir}/scripts/x-browser.ts "Hello from Claude!" --image ./screenshot.png
 2. Chrome opens with X compose page
 3. Text is typed into editor
 4. Image is copied to clipboard and pasted
@@ -72,7 +72,7 @@ Claude:
 - **Chrome not found**: Set `X_BROWSER_CHROME_PATH` environment variable
 - **Not logged in**: First run opens Chrome - log in manually, cookies are saved
 - **Image paste fails**:
-  - Verify clipboard script: `${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts image <path>`
+  - Verify clipboard script: `${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts image <path>`
  - On macOS, grant "Accessibility" permission to Terminal/iTerm in System Settings > Privacy & Security > Accessibility
  - Keep Chrome window visible and in front during paste operations
 - **osascript permission denied**: Grant Terminal accessibility permissions in System Preferences
@@ -187,20 +187,13 @@ export async function postToX(options: XBrowserOptions): Promise<void> {
      await sleep(2000);
      console.log('[x-browser] Post submitted!');
    } else {
-      console.log('[x-browser] Post composed (preview mode). Add --submit to post.');
-      console.log('[x-browser] Browser will stay open for 30 seconds for preview...');
-      await sleep(30_000);
+      console.log('[x-browser] Post composed. Please review and click the publish button in the browser.');
    }
  } finally {
    if (cdp) {
-      try { await cdp.send('Browser.close', {}, { timeoutMs: 5_000 }); } catch {}
      cdp.close();
    }
-
-    setTimeout(() => {
-      if (!chrome.killed) try { chrome.kill('SIGKILL'); } catch {}
-    }, 2_000).unref?.();
-    try { chrome.kill('SIGTERM'); } catch {}
+    chrome.unref();
  }
 }

@@ -1,6 +1,14 @@
 ---
 name: baoyu-slide-deck
 description: Generates professional slide deck images from content. Creates outlines with style instructions, then generates individual slide images. Use when user asks to "create slides", "make a presentation", "generate deck", "slide deck", or "PPT".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-slide-deck
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Slide Deck Generator
@@ -22,8 +30,8 @@ Transform content into professional slide deck images.
 ## Script Directory

 **Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
 3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 | Script | Purpose |
@@ -555,8 +563,8 @@ options:
 ### Step 8: Merge to PPTX and PDF

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>
-${BUN_X} ${SKILL_DIR}/scripts/merge-to-pdf.ts <slide-deck-dir>
+${BUN_X} {baseDir}/scripts/merge-to-pptx.ts <slide-deck-dir>
+${BUN_X} {baseDir}/scripts/merge-to-pdf.ts <slide-deck-dir>
 ```

 ### Step 9: Output Summary
@@ -1,6 +1,14 @@
 ---
 name: baoyu-translate
 description: Translates articles and documents between languages with three modes - quick (direct), normal (analyze then translate), and refined (analyze, translate, review, polish). Supports custom glossaries and terminology consistency via EXTEND.md. Use when user asks to "translate", "翻译", "精翻", "translate article", "translate to Chinese/English", "改成中文", "改成英文", "convert to Chinese", "localize", "本地化", or needs any document translation. Also triggers for "refined translation", "精细翻译", "proofread translation", "快速翻译", "快翻", "这篇文章翻译一下", or when a URL or file is provided with translation intent.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-translate
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Translator
@@ -9,7 +17,7 @@ Three-mode translation skill: **quick** for direct translation, **normal** for a

 ## Script Directory

-Scripts in `scripts/` subdirectory. `${SKILL_DIR}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `${SKILL_DIR}` and `${BUN_X}` with actual values.
+Scripts in `scripts/` subdirectory. `{baseDir}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `{baseDir}` and `${BUN_X}` with actual values.

 | Script | Purpose |
 |--------|---------|
@@ -41,7 +49,7 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-translate/EXTEND.md") { "user" }
 | Found | Read, parse, apply settings. On first use in session, briefly remind: "Using preferences from [path]. You can edit EXTEND.md to customize glossary, audience, etc." |
 | Not found | **MUST** run first-time setup (see below) — do NOT silently use defaults |

-**EXTEND.md Supports**: Default target language | Default mode | Target audience | Custom glossaries | Translation style | Chunk settings
+**EXTEND.md Supports**: Default target language | Default mode | Target audience | Custom glossaries (inline or file path) | Translation style | Chunk settings

 Schema: [references/config/extend-schema.md](references/config/extend-schema.md)

@@ -135,7 +143,7 @@ Custom audience descriptions are also accepted, e.g., `--audience "AI感兴趣
 1.2 Load built-in glossary for the language pair if available:
 - EN→ZH: [references/glossary-en-zh.md](references/glossary-en-zh.md)

-1.3 Merge glossaries: EXTEND.md glossary + built-in glossary + `--glossary` file (CLI overrides all)
+1.3 Merge glossaries: EXTEND.md `glossary` (inline) + EXTEND.md `glossary_files` (external files, paths relative to EXTEND.md location) + built-in glossary + `--glossary` file (CLI overrides all)

 ### Step 2: Materialize Source & Create Output Directory

@@ -172,7 +180,7 @@ Before translating chunks:

 1. **Extract terminology**: Scan entire document for proper nouns, technical terms, recurring phrases
 2. **Build session glossary**: Merge extracted terms with loaded glossaries, establish consistent translations
-3. **Split into chunks**: Use `${BUN_X} ${SKILL_DIR}/scripts/chunk.ts <file> [--max-words <chunk_max_words>] [--output-dir <output-dir>]`
+3. **Split into chunks**: Use `${BUN_X} {baseDir}/scripts/chunk.ts <file> [--max-words <chunk_max_words>] [--output-dir <output-dir>]`
   - Parses markdown AST (headings, paragraphs, lists, code blocks, tables, etc.)
   - Splits at markdown block boundaries to preserve structure
   - If a single block exceeds the threshold, falls back to line splitting, then word splitting
@@ -201,6 +209,7 @@ Before translating chunks:
 - **Natural flow**: Use idiomatic target language word order and sentence patterns; break or restructure sentences freely when the source structure doesn't work naturally in the target language
 - **Terminology**: Use standard translations; annotate with original term in parentheses on first occurrence
 - **Preserve format**: Keep all markdown formatting (headings, bold, italic, images, links, code blocks)
+- **Frontmatter transformation**: If the source has YAML frontmatter, preserve it in the translation with these changes: (1) Rename metadata fields that describe the *source* article — `url`→`sourceUrl`, `title`→`sourceTitle`, `description`→`sourceDescription`, `author`→`sourceAuthor`, `date`→`sourceDate`, and any similar origin-metadata fields — by adding a `source` prefix (camelCase). (2) Translate the values of text fields (title, description, etc.) and add them as new top-level fields. (3) Keep other fields (tags, categories, custom fields) as-is, translating their values where appropriate
 - **Respect original**: Maintain original meaning and intent; do not add, remove, or editorialize — but sentence structure and imagery may be adapted freely to serve the meaning
 - **Translator's notes**: For terms, concepts, or cultural references that target readers may not understand — due to jargon, cultural gaps, or domain-specific knowledge — add a concise explanatory note in parentheses immediately after the term. The note should explain *what it means* in plain language, not just provide the English original. Format: `译文（English original，通俗解释）`. Calibrate annotation depth to the target audience: general readers need more notes than technical readers. Only add notes where genuinely needed; do not over-annotate obvious terms.

@@ -25,6 +25,7 @@ chunk_max_words: 5000

 # Custom glossary (merged with built-in glossary)
 # CLI --glossary flag overrides these
+# Supports inline entries and/or file paths
 glossary:
  - from: "Reinforcement Learning"
    to: "强化学习"
@@ -32,6 +33,14 @@ glossary:
    to: "Transformer"
    note: "Keep English"

+# Load glossary from external file(s)
+# Supports absolute path or relative to EXTEND.md location
+# File format: markdown table with | from | to | note | columns,
+# or YAML list of {from, to, note} entries
+glossary_files:
+  - ./my-glossary.md
+  - /path/to/shared-glossary.yaml
+
 # Language-pair specific glossaries
 glossaries:
  en-zh:
@@ -52,7 +61,8 @@ glossaries:
 | `style` | string | `storytelling` | Translation style (`storytelling` / `formal` / `technical` / `literal` / `academic` / `business` / `humorous` / `conversational` / `elegant` / custom) |
 | `chunk_threshold` | number | `4000` | Word count threshold to trigger chunked translation |
 | `chunk_max_words` | number | `5000` | Max words per chunk |
-| `glossary` | array | `[]` | Universal glossary entries |
+| `glossary` | array | `[]` | Universal glossary entries (inline) |
+| `glossary_files` | array | `[]` | External glossary file paths (absolute or relative to EXTEND.md) |
 | `glossaries` | object | `{}` | Language-pair specific glossary entries |

 ## Glossary Entry
@@ -63,11 +73,35 @@ glossaries:
 | `to` | yes | Target translation |
 | `note` | no | Usage note (e.g., "Keep English", "Only in tech context") |

+## Glossary File Format
+
+External glossary files (`glossary_files`) support two formats:
+
+**Markdown table** (`.md`):
+```markdown
+| from | to | note |
+|------|----|------|
+| Reinforcement Learning | 强化学习 | |
+| Transformer | Transformer | Keep English |
+```
+
+**YAML list** (`.yaml` / `.yml`):
+```yaml
+- from: "Reinforcement Learning"
+  to: "强化学习"
+- from: "Transformer"
+  to: "Transformer"
+  note: "Keep English"
+```
+
+Paths can be absolute or relative to the EXTEND.md file location.
+
 ## Priority

 1. CLI `--glossary` file entries
 2. EXTEND.md `glossaries[pair]` entries
-3. EXTEND.md `glossary` entries
-4. Built-in glossary (e.g., `references/glossary-en-zh.md`)
+3. EXTEND.md `glossary` entries (inline)
+4. EXTEND.md `glossary_files` entries (in listed order, later files override earlier)
+5. Built-in glossary (e.g., `references/glossary-en-zh.md`)

 Later entries override earlier ones for the same source term.
@@ -1,26 +1,35 @@
 ---
 name: baoyu-url-to-markdown
-description: Fetch any URL and convert to markdown using Chrome CDP. Supports two modes - auto-capture on page load, or wait for user signal (for pages requiring login). Use when user wants to save a webpage as markdown.
+description: Fetch any URL and convert to markdown using Chrome CDP. Saves the rendered HTML snapshot alongside the markdown, and automatically falls back to the pre-Defuddle HTML-to-Markdown pipeline when Defuddle fails. Supports two modes - auto-capture on page load, or wait for user signal (for pages requiring login). Use when user wants to save a webpage as markdown.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-url-to-markdown
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # URL to Markdown

-Fetches any URL via Chrome CDP and converts HTML to clean markdown.
+Fetches any URL via Chrome CDP, saves the rendered HTML snapshot, and converts it to clean markdown.

 ## Script Directory

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

 **Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
 3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun
-4. Replace all `${SKILL_DIR}` and `${BUN_X}` in this document with actual values
+4. Replace all `{baseDir}` and `${BUN_X}` in this document with actual values

 **Script Reference**:
 | Script | Purpose |
 |--------|---------|
 | `scripts/main.ts` | CLI entry point for URL fetching |
+| `scripts/html-to-markdown.ts` | Defuddle-first conversion with automatic legacy fallback |

 ## Preferences (EXTEND.md)

@@ -101,7 +110,9 @@ Full reference: [references/config/first-time-setup.md](references/config/first-

 - Chrome CDP for full JavaScript rendering
 - Two capture modes: auto or wait-for-user
+- Save rendered HTML as a sibling `-captured.html` file
 - Clean markdown output with metadata
+- Defuddle-first markdown conversion with automatic fallback to the pre-Defuddle extractor from git history
 - Handles login-required pages via wait mode
 - Download images and videos to local directories

@@ -109,19 +120,19 @@ Full reference: [references/config/first-time-setup.md](references/config/first-

 ```bash
 # Auto mode (default) - capture when page loads
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url>
+${BUN_X} {baseDir}/scripts/main.ts <url>

 # Wait mode - wait for user signal before capture
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> --wait
+${BUN_X} {baseDir}/scripts/main.ts <url> --wait

 # Save to specific file
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> -o output.md
+${BUN_X} {baseDir}/scripts/main.ts <url> -o output.md

 # Save to a custom output directory (auto-generates filename)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> --output-dir ./posts/
+${BUN_X} {baseDir}/scripts/main.ts <url> --output-dir ./posts/

 # Download images and videos to local directories
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> --download-media
+${BUN_X} {baseDir}/scripts/main.ts <url> --download-media
 ```

 ## Options
@@ -149,13 +160,23 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> --download-media

 ## Output Format

-YAML front matter with `url`, `title`, `description`, `author`, `published`, `captured_at` fields, followed by converted markdown content.
+Each run saves two files side by side:
+
+- Markdown: YAML front matter with `url`, `title`, `description`, `author`, `published`, optional `coverImage`, and `captured_at`, followed by converted markdown content
+- HTML snapshot: `*-captured.html`, containing the rendered page HTML captured from Chrome
+
+The HTML snapshot is saved before any markdown media localization, so it stays a faithful capture of the page DOM used for conversion.

 ## Output Directory

 Default: `url-to-markdown/<domain>/<slug>.md`
 With `--output-dir ./posts/`: `./posts/<domain>/<slug>.md`

+HTML snapshot path uses the same basename:
+
+- `url-to-markdown/<domain>/<slug>-captured.html`
+- `./posts/<domain>/<slug>-captured.html`
+
 - `<slug>`: From page title or URL path (kebab-case, 2-6 words)
 - Conflict resolution: Append timestamp `<slug>-YYYYMMDD-HHMMSS.md`

@@ -164,6 +185,19 @@ When `--download-media` is enabled:
 - Videos are saved to `videos/` next to the markdown file
 - Markdown media links are rewritten to local relative paths

+## Conversion Fallback
+
+Conversion order:
+
+1. Try Defuddle first
+2. If Defuddle throws, cannot load, returns obviously incomplete markdown, or captures lower-quality content than the legacy pipeline, automatically fall back to the pre-Defuddle extractor
+3. The fallback path uses the older Readability/selector/Next.js-data based HTML-to-Markdown implementation recovered from git history
+
+CLI output will show:
+
+- `Converter: defuddle` when Defuddle succeeds
+- `Converter: legacy:...` plus `Fallback used: ...` when fallback was needed
+
 ## Media Download Workflow

 Based on `download_media` setting in EXTEND.md:
@@ -193,7 +227,7 @@ Based on `download_media` setting in EXTEND.md:
 | `URL_DATA_DIR` | Custom data directory |
 | `URL_CHROME_PROFILE_DIR` | Custom Chrome profile directory |

-**Troubleshooting**: Chrome not found → set `URL_CHROME_PATH`. Timeout → increase `--timeout`. Complex pages → try `--wait` mode.
+**Troubleshooting**: Chrome not found → set `URL_CHROME_PATH`. Timeout → increase `--timeout`. Complex pages → try `--wait` mode. If markdown quality is poor, inspect the saved `-captured.html` and check whether the run logged a legacy fallback.

 ## Extension Support

@@ -0,0 +1,191 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "baoyu-url-to-markdown-scripts",
+      "dependencies": {
+        "@mozilla/readability": "^0.6.0",
+        "defuddle": "^0.10.0",
+        "jsdom": "^24.1.3",
+        "linkedom": "^0.18.12",
+        "turndown": "^7.2.2",
+        "turndown-plugin-gfm": "^1.0.2",
+      },
+    },
+  },
+  "packages": {
+    "@asamuzakjp/css-color": ["@asamuzakjp/css-color@3.2.0", "", { "dependencies": { "@csstools/css-calc": "^2.1.3", "@csstools/css-color-parser": "^3.0.9", "@csstools/css-parser-algorithms": "^3.0.4", "@csstools/css-tokenizer": "^3.0.3", "lru-cache": "^10.4.3" } }, "sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw=="],
+
+    "@csstools/color-helpers": ["@csstools/color-helpers@5.1.0", "", {}, "sha512-S11EXWJyy0Mz5SYvRmY8nJYTFFd1LCNV+7cXyAgQtOOuzb4EsgfqDufL+9esx72/eLhsRdGZwaldu/h+E4t4BA=="],
+
+    "@csstools/css-calc": ["@csstools/css-calc@2.1.4", "", { "peerDependencies": { "@csstools/css-parser-algorithms": "^3.0.5", "@csstools/css-tokenizer": "^3.0.4" } }, "sha512-3N8oaj+0juUw/1H3YwmDDJXCgTB1gKU6Hc/bB502u9zR0q2vd786XJH9QfrKIEgFlZmhZiq6epXl4rHqhzsIgQ=="],
+
+    "@csstools/css-color-parser": ["@csstools/css-color-parser@3.1.0", "", { "dependencies": { "@csstools/color-helpers": "^5.1.0", "@csstools/css-calc": "^2.1.4" }, "peerDependencies": { "@csstools/css-parser-algorithms": "^3.0.5", "@csstools/css-tokenizer": "^3.0.4" } }, "sha512-nbtKwh3a6xNVIp/VRuXV64yTKnb1IjTAEEh3irzS+HkKjAOYLTGNb9pmVNntZ8iVBHcWDA2Dof0QtPgFI1BaTA=="],
+
+    "@csstools/css-parser-algorithms": ["@csstools/css-parser-algorithms@3.0.5", "", { "peerDependencies": { "@csstools/css-tokenizer": "^3.0.4" } }, "sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ=="],
+
+    "@csstools/css-tokenizer": ["@csstools/css-tokenizer@3.0.4", "", {}, "sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw=="],
+
+    "@mixmark-io/domino": ["@mixmark-io/domino@2.2.0", "", {}, "sha512-Y28PR25bHXUg88kCV7nivXrP2Nj2RueZ3/l/jdx6J9f8J4nsEGcgX0Qe6lt7Pa+J79+kPiJU3LguR6O/6zrLOw=="],
+
+    "@mozilla/readability": ["@mozilla/readability@0.6.0", "", {}, "sha512-juG5VWh4qAivzTAeMzvY9xs9HY5rAcr2E4I7tiSSCokRFi7XIZCAu92ZkSTsIj1OPceCifL3cpfteP3pDT9/QQ=="],
+
+    "@xmldom/xmldom": ["@xmldom/xmldom@0.8.11", "", {}, "sha512-cQzWCtO6C8TQiYl1ruKNn2U6Ao4o4WBBcbL61yJl84x+j5sOWWFU9X7DpND8XZG3daDppSsigMdfAIl2upQBRw=="],
+
+    "agent-base": ["agent-base@7.1.4", "", {}, "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ=="],
+
+    "asynckit": ["asynckit@0.4.0", "", {}, "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q=="],
+
+    "boolbase": ["boolbase@1.0.0", "", {}, "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww=="],
+
+    "call-bind-apply-helpers": ["call-bind-apply-helpers@1.0.2", "", { "dependencies": { "es-errors": "^1.3.0", "function-bind": "^1.1.2" } }, "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ=="],
+
+    "combined-stream": ["combined-stream@1.0.8", "", { "dependencies": { "delayed-stream": "~1.0.0" } }, "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg=="],
+
+    "commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
+
+    "css-select": ["css-select@5.2.2", "", { "dependencies": { "boolbase": "^1.0.0", "css-what": "^6.1.0", "domhandler": "^5.0.2", "domutils": "^3.0.1", "nth-check": "^2.0.1" } }, "sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw=="],
+
+    "css-what": ["css-what@6.2.2", "", {}, "sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA=="],
+
+    "cssom": ["cssom@0.5.0", "", {}, "sha512-iKuQcq+NdHqlAcwUY0o/HL69XQrUaQdMjmStJ8JFmUaiiQErlhrmuigkg/CU4E2J0IyUKUrMAgl36TvN67MqTw=="],
+
+    "cssstyle": ["cssstyle@4.6.0", "", { "dependencies": { "@asamuzakjp/css-color": "^3.2.0", "rrweb-cssom": "^0.8.0" } }, "sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg=="],
+
+    "data-urls": ["data-urls@5.0.0", "", { "dependencies": { "whatwg-mimetype": "^4.0.0", "whatwg-url": "^14.0.0" } }, "sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg=="],
+
+    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
+
+    "decimal.js": ["decimal.js@10.6.0", "", {}, "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg=="],
+
+    "defuddle": ["defuddle@0.10.0", "", { "dependencies": { "commander": "^12.1.0" }, "optionalDependencies": { "mathml-to-latex": "^1.5.0", "temml": "^0.13.1", "turndown": "^7.2.0" }, "peerDependencies": { "jsdom": "^24.0.0" }, "bin": { "defuddle": "dist/cli.js" } }, "sha512-a43juTtHv6Vs4+sxvahVLM5NxoyDsarO1Ag3UxLORI4Fo/nsNFwzDxuQBvosKVGTIRxCwN/mfnWAzNXmQfieqw=="],
+
+    "delayed-stream": ["delayed-stream@1.0.0", "", {}, "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ=="],
+
+    "dom-serializer": ["dom-serializer@2.0.0", "", { "dependencies": { "domelementtype": "^2.3.0", "domhandler": "^5.0.2", "entities": "^4.2.0" } }, "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg=="],
+
+    "domelementtype": ["domelementtype@2.3.0", "", {}, "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw=="],
+
+    "domhandler": ["domhandler@5.0.3", "", { "dependencies": { "domelementtype": "^2.3.0" } }, "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w=="],
+
+    "domutils": ["domutils@3.2.2", "", { "dependencies": { "dom-serializer": "^2.0.0", "domelementtype": "^2.3.0", "domhandler": "^5.0.3" } }, "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw=="],
+
+    "dunder-proto": ["dunder-proto@1.0.1", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.1", "es-errors": "^1.3.0", "gopd": "^1.2.0" } }, "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A=="],
+
+    "entities": ["entities@6.0.1", "", {}, "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g=="],
+
+    "es-define-property": ["es-define-property@1.0.1", "", {}, "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g=="],
+
+    "es-errors": ["es-errors@1.3.0", "", {}, "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw=="],
+
+    "es-object-atoms": ["es-object-atoms@1.1.1", "", { "dependencies": { "es-errors": "^1.3.0" } }, "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA=="],
+
+    "es-set-tostringtag": ["es-set-tostringtag@2.1.0", "", { "dependencies": { "es-errors": "^1.3.0", "get-intrinsic": "^1.2.6", "has-tostringtag": "^1.0.2", "hasown": "^2.0.2" } }, "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA=="],
+
+    "form-data": ["form-data@4.0.5", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w=="],
+
+    "function-bind": ["function-bind@1.1.2", "", {}, "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA=="],
+
+    "get-intrinsic": ["get-intrinsic@1.3.0", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.1.1", "function-bind": "^1.1.2", "get-proto": "^1.0.1", "gopd": "^1.2.0", "has-symbols": "^1.1.0", "hasown": "^2.0.2", "math-intrinsics": "^1.1.0" } }, "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ=="],
+
+    "get-proto": ["get-proto@1.0.1", "", { "dependencies": { "dunder-proto": "^1.0.1", "es-object-atoms": "^1.0.0" } }, "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g=="],
+
+    "gopd": ["gopd@1.2.0", "", {}, "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg=="],
+
+    "has-symbols": ["has-symbols@1.1.0", "", {}, "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ=="],
+
+    "has-tostringtag": ["has-tostringtag@1.0.2", "", { "dependencies": { "has-symbols": "^1.0.3" } }, "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw=="],
+
+    "hasown": ["hasown@2.0.2", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ=="],
+
+    "html-encoding-sniffer": ["html-encoding-sniffer@4.0.0", "", { "dependencies": { "whatwg-encoding": "^3.1.1" } }, "sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ=="],
+
+    "html-escaper": ["html-escaper@3.0.3", "", {}, "sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ=="],
+
+    "htmlparser2": ["htmlparser2@10.1.0", "", { "dependencies": { "domelementtype": "^2.3.0", "domhandler": "^5.0.3", "domutils": "^3.2.2", "entities": "^7.0.1" } }, "sha512-VTZkM9GWRAtEpveh7MSF6SjjrpNVNNVJfFup7xTY3UpFtm67foy9HDVXneLtFVt4pMz5kZtgNcvCniNFb1hlEQ=="],
+
+    "http-proxy-agent": ["http-proxy-agent@7.0.2", "", { "dependencies": { "agent-base": "^7.1.0", "debug": "^4.3.4" } }, "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig=="],
+
+    "https-proxy-agent": ["https-proxy-agent@7.0.6", "", { "dependencies": { "agent-base": "^7.1.2", "debug": "4" } }, "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw=="],
+
+    "iconv-lite": ["iconv-lite@0.6.3", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw=="],
+
+    "is-potential-custom-element-name": ["is-potential-custom-element-name@1.0.1", "", {}, "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ=="],
+
+    "jsdom": ["jsdom@24.1.3", "", { "dependencies": { "cssstyle": "^4.0.1", "data-urls": "^5.0.0", "decimal.js": "^10.4.3", "form-data": "^4.0.0", "html-encoding-sniffer": "^4.0.0", "http-proxy-agent": "^7.0.2", "https-proxy-agent": "^7.0.5", "is-potential-custom-element-name": "^1.0.1", "nwsapi": "^2.2.12", "parse5": "^7.1.2", "rrweb-cssom": "^0.7.1", "saxes": "^6.0.0", "symbol-tree": "^3.2.4", "tough-cookie": "^4.1.4", "w3c-xmlserializer": "^5.0.0", "webidl-conversions": "^7.0.0", "whatwg-encoding": "^3.1.1", "whatwg-mimetype": "^4.0.0", "whatwg-url": "^14.0.0", "ws": "^8.18.0", "xml-name-validator": "^5.0.0" }, "peerDependencies": { "canvas": "^2.11.2" }, "optionalPeers": ["canvas"] }, "sha512-MyL55p3Ut3cXbeBEG7Hcv0mVM8pp8PBNWxRqchZnSfAiES1v1mRnMeFfaHWIPULpwsYfvO+ZmMZz5tGCnjzDUQ=="],
+
+    "linkedom": ["linkedom@0.18.12", "", { "dependencies": { "css-select": "^5.1.0", "cssom": "^0.5.0", "html-escaper": "^3.0.3", "htmlparser2": "^10.0.0", "uhyphen": "^0.2.0" }, "peerDependencies": { "canvas": ">= 2" }, "optionalPeers": ["canvas"] }, "sha512-jalJsOwIKuQJSeTvsgzPe9iJzyfVaEJiEXl+25EkKevsULHvMJzpNqwvj1jOESWdmgKDiXObyjOYwlUqG7wo1Q=="],
+
+    "lru-cache": ["lru-cache@10.4.3", "", {}, "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ=="],
+
+    "math-intrinsics": ["math-intrinsics@1.1.0", "", {}, "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="],
+
+    "mathml-to-latex": ["mathml-to-latex@1.5.0", "", { "dependencies": { "@xmldom/xmldom": "^0.8.10" } }, "sha512-rrWn0eEvcEcdMM4xfHcSGIy+i01DX9byOdXTLWg+w1iJ6O6ohP5UXY1dVzNUZLhzfl3EGcRekWLhY7JT5Omaew=="],
+
+    "mime-db": ["mime-db@1.52.0", "", {}, "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="],
+
+    "mime-types": ["mime-types@2.1.35", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="],
+
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "nth-check": ["nth-check@2.1.1", "", { "dependencies": { "boolbase": "^1.0.0" } }, "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w=="],
+
+    "nwsapi": ["nwsapi@2.2.23", "", {}, "sha512-7wfH4sLbt4M0gCDzGE6vzQBo0bfTKjU7Sfpqy/7gs1qBfYz2vEJH6vXcBKpO3+6Yu1telwd0t9HpyOoLEQQbIQ=="],
+
+    "parse5": ["parse5@7.3.0", "", { "dependencies": { "entities": "^6.0.0" } }, "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw=="],
+
+    "psl": ["psl@1.15.0", "", { "dependencies": { "punycode": "^2.3.1" } }, "sha512-JZd3gMVBAVQkSs6HdNZo9Sdo0LNcQeMNP3CozBJb3JYC/QUYZTnKxP+f8oWRX4rHP5EurWxqAHTSwUCjlNKa1w=="],
+
+    "punycode": ["punycode@2.3.1", "", {}, "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg=="],
+
+    "querystringify": ["querystringify@2.2.0", "", {}, "sha512-FIqgj2EUvTa7R50u0rGsyTftzjYmv/a3hO345bZNrqabNqjtgiDMgmo4mkUjd+nzU5oF3dClKqFIPUKybUyqoQ=="],
+
+    "requires-port": ["requires-port@1.0.0", "", {}, "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ=="],
+
+    "rrweb-cssom": ["rrweb-cssom@0.7.1", "", {}, "sha512-TrEMa7JGdVm0UThDJSx7ddw5nVm3UJS9o9CCIZ72B1vSyEZoziDqBYP3XIoi/12lKrJR8rE3jeFHMok2F/Mnsg=="],
+
+    "safer-buffer": ["safer-buffer@2.1.2", "", {}, "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="],
+
+    "saxes": ["saxes@6.0.0", "", { "dependencies": { "xmlchars": "^2.2.0" } }, "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA=="],
+
+    "symbol-tree": ["symbol-tree@3.2.4", "", {}, "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw=="],
+
+    "temml": ["temml@0.13.1", "", {}, "sha512-/fL1utq8QUD9YpcLeZHPRnp9Cbzbexq5hZl5uSBhf8mNYiKkcS4eYbLidDB+/nF8C+RHAcBQbKw2bKoS83mz1Q=="],
+
+    "tough-cookie": ["tough-cookie@4.1.4", "", { "dependencies": { "psl": "^1.1.33", "punycode": "^2.1.1", "universalify": "^0.2.0", "url-parse": "^1.5.3" } }, "sha512-Loo5UUvLD9ScZ6jh8beX1T6sO1w2/MpCRpEP7V280GKMVUQ0Jzar2U3UJPsrdbziLEMMhu3Ujnq//rhiFuIeag=="],
+
+    "tr46": ["tr46@5.1.1", "", { "dependencies": { "punycode": "^2.3.1" } }, "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw=="],
+
+    "turndown": ["turndown@7.2.2", "", { "dependencies": { "@mixmark-io/domino": "^2.2.0" } }, "sha512-1F7db8BiExOKxjSMU2b7if62D/XOyQyZbPKq/nUwopfgnHlqXHqQ0lvfUTeUIr1lZJzOPFn43dODyMSIfvWRKQ=="],
+
+    "turndown-plugin-gfm": ["turndown-plugin-gfm@1.0.2", "", {}, "sha512-vwz9tfvF7XN/jE0dGoBei3FXWuvll78ohzCZQuOb+ZjWrs3a0XhQVomJEb2Qh4VHTPNRO4GPZh0V7VRbiWwkRg=="],
+
+    "uhyphen": ["uhyphen@0.2.0", "", {}, "sha512-qz3o9CHXmJJPGBdqzab7qAYuW8kQGKNEuoHFYrBwV6hWIMcpAmxDLXojcHfFr9US1Pe6zUswEIJIbLI610fuqA=="],
+
+    "universalify": ["universalify@0.2.0", "", {}, "sha512-CJ1QgKmNg3CwvAv/kOFmtnEN05f0D/cn9QntgNOQlQF9dgvVTHj3t+8JPdjqawCHk7V/KA+fbUqzZ9XWhcqPUg=="],
+
+    "url-parse": ["url-parse@1.5.10", "", { "dependencies": { "querystringify": "^2.1.1", "requires-port": "^1.0.0" } }, "sha512-WypcfiRhfeUP9vvF0j6rw0J3hrWrw6iZv3+22h6iRMJ/8z1Tj6XfLP4DsUix5MhMPnXpiHDoKyoZ/bdCkwBCiQ=="],
+
+    "w3c-xmlserializer": ["w3c-xmlserializer@5.0.0", "", { "dependencies": { "xml-name-validator": "^5.0.0" } }, "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA=="],
+
+    "webidl-conversions": ["webidl-conversions@7.0.0", "", {}, "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g=="],
+
+    "whatwg-encoding": ["whatwg-encoding@3.1.1", "", { "dependencies": { "iconv-lite": "0.6.3" } }, "sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ=="],
+
+    "whatwg-mimetype": ["whatwg-mimetype@4.0.0", "", {}, "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg=="],
+
+    "whatwg-url": ["whatwg-url@14.2.0", "", { "dependencies": { "tr46": "^5.1.0", "webidl-conversions": "^7.0.0" } }, "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw=="],
+
+    "ws": ["ws@8.19.0", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg=="],
+
+    "xml-name-validator": ["xml-name-validator@5.0.0", "", {}, "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg=="],
+
+    "xmlchars": ["xmlchars@2.2.0", "", {}, "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw=="],
+
+    "cssstyle/rrweb-cssom": ["rrweb-cssom@0.8.0", "", {}, "sha512-guoltQEx+9aMf2gDZ0s62EcV8lsXR+0w8915TC3ITdn2YueuNjdAYh/levpU9nFaoChh9RUS5ZdQMrKfVEN9tw=="],
+
+    "dom-serializer/entities": ["entities@4.5.0", "", {}, "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw=="],
+
+    "htmlparser2/entities": ["entities@7.0.1", "", {}, "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA=="],
+  }
+}
@@ -1,5 +1,7 @@
-import { JSDOM } from "jsdom";
-import { Defuddle } from "defuddle/node";
+import { parseHTML } from "linkedom";
+import { Readability } from "@mozilla/readability";
+import TurndownService from "turndown";
+import { gfm } from "turndown-plugin-gfm";

 export interface PageMetadata {
  url: string;
@@ -14,8 +16,103 @@ export interface PageMetadata {
 export interface ConversionResult {
  metadata: PageMetadata;
  markdown: string;
+  rawHtml: string;
+  conversionMethod: string;
+  fallbackReason?: string;
 }

+interface ExtractionCandidate {
+  title: string | null;
+  byline: string | null;
+  excerpt: string | null;
+  published: string | null;
+  html: string | null;
+  textContent: string;
+  method: string;
+}
+
+type AnyRecord = Record<string, unknown>;
+
+const MIN_CONTENT_LENGTH = 120;
+const GOOD_CONTENT_LENGTH = 900;
+
+const CONTENT_SELECTORS = [
+  "article",
+  "main article",
+  "[role='main'] article",
+  "[itemprop='articleBody']",
+  ".article-content",
+  ".article-body",
+  ".post-content",
+  ".entry-content",
+  ".story-body",
+  "main",
+  "[role='main']",
+  "#content",
+  ".content",
+];
+
+const REMOVE_SELECTORS = [
+  "script",
+  "style",
+  "noscript",
+  "template",
+  "iframe",
+  "svg",
+  "path",
+  "nav",
+  "aside",
+  "footer",
+  "header",
+  "form",
+  ".advertisement",
+  ".ads",
+  ".social-share",
+  ".related-articles",
+  ".comments",
+  ".newsletter",
+  ".cookie-banner",
+  ".cookie-consent",
+  "[role='navigation']",
+  "[aria-label*='cookie' i]",
+];
+
+const PUBLISHED_TIME_SELECTORS = [
+  "meta[property='article:published_time']",
+  "meta[name='pubdate']",
+  "meta[name='publishdate']",
+  "meta[name='date']",
+  "time[datetime]",
+];
+
+const ARTICLE_TYPES = new Set([
+  "Article",
+  "NewsArticle",
+  "BlogPosting",
+  "WebPage",
+  "ReportageNewsArticle",
+]);
+
+const NEXT_DATA_CONTENT_PATHS = [
+  "props.pageProps.content.body",
+  "props.pageProps.article.body",
+  "props.pageProps.article.content",
+  "props.pageProps.post.body",
+  "props.pageProps.post.content",
+  "props.pageProps.data.body",
+  "props.pageProps.story.body.content",
+];
+
+const LOW_QUALITY_MARKERS = [
+  /Join The Conversation/i,
+  /One Community\. Many Voices/i,
+  /Read our community guidelines/i,
+  /Create a free account to share your thoughts/i,
+  /Become a Forbes Member/i,
+  /Subscribe to trusted journalism/i,
+  /\bComments\b/i,
+];
+
 export const absolutizeUrlsScript = String.raw`
 (function() {
  const baseUrl = document.baseURI || location.href;
@@ -53,21 +150,791 @@ export const absolutizeUrlsScript = String.raw`
 })()
 `;

-export async function extractContent(html: string, url: string): Promise<ConversionResult> {
-  const dom = new JSDOM(html, { url });
-  const result = await Defuddle(dom, url, { markdown: true });
+function pickString(...values: unknown[]): string | null {
+  for (const value of values) {
+    if (typeof value === "string") {
+      const trimmed = value.trim();
+      if (trimmed) return trimmed;
+    }
+  }
+  return null;
+}

-  const metadata: PageMetadata = {
+function normalizeMarkdown(markdown: string): string {
+  return markdown
+    .replace(/\r\n/g, "\n")
+    .replace(/[ \t]+\n/g, "\n")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+}
+
+function parseDocument(html: string): Document {
+  const normalized = /<\s*html[\s>]/i.test(html)
+    ? html
+    : `<!doctype html><html><body>${html}</body></html>`;
+  return parseHTML(normalized).document as unknown as Document;
+}
+
+function sanitizeHtml(html: string): string {
+  const { document } = parseHTML(`<div id="__root">${html}</div>`);
+  const root = document.querySelector("#__root");
+  if (!root) return html;
+
+  for (const selector of ["script", "style", "iframe", "noscript", "template", "svg", "path"]) {
+    for (const el of root.querySelectorAll(selector)) {
+      el.remove();
+    }
+  }
+
+  return root.innerHTML;
+}
+
+function extractTextFromHtml(html: string): string {
+  const { document } = parseHTML(`<!doctype html><html><body>${html}</body></html>`);
+  for (const selector of ["script", "style", "noscript", "template", "iframe", "svg", "path"]) {
+    for (const el of document.querySelectorAll(selector)) {
+      el.remove();
+    }
+  }
+  return document.body?.textContent?.replace(/\s+/g, " ").trim() ?? "";
+}
+
+function getMetaContent(document: Document, names: string[]): string | null {
+  for (const name of names) {
+    const element =
+      document.querySelector(`meta[name="${name}"]`) ??
+      document.querySelector(`meta[property="${name}"]`);
+    const content = element?.getAttribute("content");
+    if (content && content.trim()) return content.trim();
+  }
+  return null;
+}
+
+function flattenJsonLdItems(data: unknown): AnyRecord[] {
+  if (!data || typeof data !== "object") return [];
+  if (Array.isArray(data)) return data.flatMap(flattenJsonLdItems);
+
+  const item = data as AnyRecord;
+  if (Array.isArray(item["@graph"])) {
+    return (item["@graph"] as unknown[]).flatMap(flattenJsonLdItems);
+  }
+
+  return [item];
+}
+
+function parseJsonLdScripts(document: Document): AnyRecord[] {
+  const results: AnyRecord[] = [];
+  const scripts = document.querySelectorAll("script[type='application/ld+json']");
+
+  for (const script of scripts) {
+    try {
+      const data = JSON.parse(script.textContent ?? "");
+      results.push(...flattenJsonLdItems(data));
+    } catch {
+      // Ignore malformed blocks.
+    }
+  }
+
+  return results;
+}
+
+function isArticleType(item: AnyRecord): boolean {
+  const value = Array.isArray(item["@type"]) ? item["@type"][0] : item["@type"];
+  return typeof value === "string" && ARTICLE_TYPES.has(value);
+}
+
+function extractAuthorFromJsonLd(authorData: unknown): string | null {
+  if (typeof authorData === "string") return authorData;
+  if (!authorData || typeof authorData !== "object") return null;
+
+  if (Array.isArray(authorData)) {
+    const names = authorData
+      .map((author) => extractAuthorFromJsonLd(author))
+      .filter((name): name is string => Boolean(name));
+    return names.length > 0 ? names.join(", ") : null;
+  }
+
+  const author = authorData as AnyRecord;
+  return typeof author.name === "string" ? author.name : null;
+}
+
+function extractPrimaryJsonLdMeta(document: Document): Partial<PageMetadata> {
+  for (const item of parseJsonLdScripts(document)) {
+    if (!isArticleType(item)) continue;
+
+    return {
+      title: pickString(item.headline, item.name) ?? undefined,
+      description: pickString(item.description) ?? undefined,
+      author: extractAuthorFromJsonLd(item.author) ?? undefined,
+      published: pickString(item.datePublished, item.dateCreated) ?? undefined,
+      coverImage:
+        pickString(
+          item.image,
+          (item.image as AnyRecord | undefined)?.url,
+          (Array.isArray(item.image) ? item.image[0] : undefined) as unknown
+        ) ?? undefined,
+    };
+  }
+
+  return {};
+}
+
+function extractPublishedTime(document: Document): string | null {
+  for (const selector of PUBLISHED_TIME_SELECTORS) {
+    const el = document.querySelector(selector);
+    if (!el) continue;
+    const value = el.getAttribute("content") ?? el.getAttribute("datetime");
+    if (value && value.trim()) return value.trim();
+  }
+  return null;
+}
+
+function extractTitle(document: Document): string | null {
+  const ogTitle = document.querySelector("meta[property='og:title']")?.getAttribute("content");
+  if (ogTitle && ogTitle.trim()) return ogTitle.trim();
+
+  const twitterTitle = document.querySelector("meta[name='twitter:title']")?.getAttribute("content");
+  if (twitterTitle && twitterTitle.trim()) return twitterTitle.trim();
+
+  const title = document.querySelector("title")?.textContent?.trim();
+  if (title) {
+    const cleaned = title.split(/\s*[-|–—]\s*/)[0]?.trim();
+    if (cleaned) return cleaned;
+  }
+
+  const h1 = document.querySelector("h1")?.textContent?.trim();
+  return h1 || null;
+}
+
+function extractMetadataFromHtml(html: string, url: string, capturedAt: string): PageMetadata {
+  const document = parseDocument(html);
+  const jsonLd = extractPrimaryJsonLdMeta(document);
+  const timeEl = document.querySelector("time[datetime]");
+
+  return {
    url,
-    title: result.title || "",
-    description: result.description || undefined,
-    author: result.author || undefined,
-    published: result.published || undefined,
-    coverImage: result.image || undefined,
-    captured_at: new Date().toISOString(),
+    title:
+      pickString(
+        getMetaContent(document, ["og:title", "twitter:title"]),
+        jsonLd.title,
+        document.querySelector("h1")?.textContent,
+        document.title
+      ) ?? "",
+    description:
+      pickString(
+        getMetaContent(document, ["description", "og:description", "twitter:description"]),
+        jsonLd.description
+      ) ?? undefined,
+    author:
+      pickString(
+        getMetaContent(document, ["author", "article:author", "twitter:creator"]),
+        jsonLd.author
+      ) ?? undefined,
+    published:
+      pickString(
+        timeEl?.getAttribute("datetime"),
+        getMetaContent(document, ["article:published_time", "datePublished", "publishdate", "date"]),
+        jsonLd.published,
+        extractPublishedTime(document)
+      ) ?? undefined,
+    coverImage:
+      pickString(
+        getMetaContent(document, ["og:image", "twitter:image", "twitter:image:src"]),
+        jsonLd.coverImage
+      ) ?? undefined,
+    captured_at: capturedAt,
  };
+}

-  return { metadata, markdown: result.content || "" };
+function generateExcerpt(excerpt: string | null, textContent: string | null): string | null {
+  if (excerpt) return excerpt;
+  if (!textContent) return null;
+  const trimmed = textContent.trim();
+  if (!trimmed) return null;
+  return trimmed.length > 200 ? `${trimmed.slice(0, 200)}...` : trimmed;
+}
+
+function parseJsonLdItem(item: AnyRecord): ExtractionCandidate | null {
+  if (!isArticleType(item)) return null;
+
+  const rawContent =
+    (typeof item.articleBody === "string" && item.articleBody) ||
+    (typeof item.text === "string" && item.text) ||
+    (typeof item.description === "string" && item.description) ||
+    null;
+
+  if (!rawContent) return null;
+
+  const content = rawContent.trim();
+  const htmlLike = /<\/?[a-z][\s\S]*>/i.test(content);
+  const textContent = htmlLike ? extractTextFromHtml(content) : content;
+
+  if (textContent.length < MIN_CONTENT_LENGTH) return null;
+
+  return {
+    title: pickString(item.headline, item.name),
+    byline: extractAuthorFromJsonLd(item.author),
+    excerpt: pickString(item.description),
+    published: pickString(item.datePublished, item.dateCreated),
+    html: htmlLike ? content : null,
+    textContent,
+    method: "json-ld",
+  };
+}
+
+function tryJsonLdExtraction(document: Document): ExtractionCandidate | null {
+  for (const item of parseJsonLdScripts(document)) {
+    const extracted = parseJsonLdItem(item);
+    if (extracted) return extracted;
+  }
+  return null;
+}
+
+function getByPath(value: unknown, path: string): unknown {
+  let current = value;
+  for (const part of path.split(".")) {
+    if (!current || typeof current !== "object") return undefined;
+    current = (current as AnyRecord)[part];
+  }
+  return current;
+}
+
+function isContentBlockArray(value: unknown): value is AnyRecord[] {
+  if (!Array.isArray(value) || value.length === 0) return false;
+  return value.slice(0, 5).some((item) => {
+    if (!item || typeof item !== "object") return false;
+    const obj = item as AnyRecord;
+    return "type" in obj || "text" in obj || "textHtml" in obj || "content" in obj;
+  });
+}
+
+function extractTextFromContentBlocks(blocks: AnyRecord[]): string {
+  const parts: string[] = [];
+
+  function pushParagraph(text: string): void {
+    const trimmed = text.trim();
+    if (!trimmed) return;
+    parts.push(trimmed, "\n\n");
+  }
+
+  function walk(node: unknown): void {
+    if (!node || typeof node !== "object") return;
+    const block = node as AnyRecord;
+
+    if (typeof block.text === "string") {
+      pushParagraph(block.text);
+      return;
+    }
+
+    if (typeof block.textHtml === "string") {
+      pushParagraph(extractTextFromHtml(block.textHtml));
+      return;
+    }
+
+    if (Array.isArray(block.items)) {
+      for (const item of block.items) {
+        if (item && typeof item === "object") {
+          const text = pickString((item as AnyRecord).text);
+          if (text) parts.push(`- ${text}\n`);
+        }
+      }
+      parts.push("\n");
+    }
+
+    if (Array.isArray(block.components)) {
+      for (const component of block.components) {
+        walk(component);
+      }
+    }
+
+    if (Array.isArray(block.content)) {
+      for (const child of block.content) {
+        walk(child);
+      }
+    }
+  }
+
+  for (const block of blocks) {
+    walk(block);
+  }
+
+  return parts.join("").replace(/\n{3,}/g, "\n\n").trim();
+}
+
+function tryStringBodyExtraction(
+  content: string,
+  meta: AnyRecord,
+  document: Document,
+  method: string
+): ExtractionCandidate | null {
+  if (!content || content.length < MIN_CONTENT_LENGTH) return null;
+
+  const isHtml = /<\/?[a-z][\s\S]*>/i.test(content);
+  const html = isHtml ? sanitizeHtml(content) : null;
+  const textContent = isHtml ? extractTextFromHtml(html) : content.trim();
+
+  if (textContent.length < MIN_CONTENT_LENGTH) return null;
+
+  return {
+    title: pickString(meta.headline, meta.title, extractTitle(document)),
+    byline: pickString(meta.byline, meta.author),
+    excerpt: pickString(meta.description, meta.excerpt, generateExcerpt(null, textContent)),
+    published: pickString(meta.datePublished, meta.publishedAt, extractPublishedTime(document)),
+    html,
+    textContent,
+    method,
+  };
+}
+
+function tryNextDataExtraction(document: Document): ExtractionCandidate | null {
+  try {
+    const script = document.querySelector("script#__NEXT_DATA__");
+    if (!script?.textContent) return null;
+
+    const data = JSON.parse(script.textContent) as AnyRecord;
+    const pageProps = (getByPath(data, "props.pageProps") ?? {}) as AnyRecord;
+
+    for (const path of NEXT_DATA_CONTENT_PATHS) {
+      const value = getByPath(data, path);
+
+      if (typeof value === "string") {
+        const parentPath = path.split(".").slice(0, -1).join(".");
+        const parent = (getByPath(data, parentPath) ?? {}) as AnyRecord;
+        const meta = {
+          ...pageProps,
+          ...parent,
+          title: parent.title ?? (pageProps.title as string | undefined),
+        };
+
+        const candidate = tryStringBodyExtraction(value, meta, document, "next-data");
+        if (candidate) return candidate;
+      }
+
+      if (isContentBlockArray(value)) {
+        const textContent = extractTextFromContentBlocks(value);
+        if (textContent.length < MIN_CONTENT_LENGTH) continue;
+
+        return {
+          title: pickString(
+            getByPath(data, "props.pageProps.content.headline"),
+            getByPath(data, "props.pageProps.article.headline"),
+            getByPath(data, "props.pageProps.article.title"),
+            getByPath(data, "props.pageProps.post.title"),
+            pageProps.title,
+            extractTitle(document)
+          ),
+          byline: pickString(
+            getByPath(data, "props.pageProps.author.name"),
+            getByPath(data, "props.pageProps.article.author.name")
+          ),
+          excerpt: pickString(
+            getByPath(data, "props.pageProps.content.description"),
+            getByPath(data, "props.pageProps.article.description"),
+            pageProps.description,
+            generateExcerpt(null, textContent)
+          ),
+          published: pickString(
+            getByPath(data, "props.pageProps.content.datePublished"),
+            getByPath(data, "props.pageProps.article.datePublished"),
+            getByPath(data, "props.pageProps.publishedAt"),
+            extractPublishedTime(document)
+          ),
+          html: null,
+          textContent,
+          method: "next-data",
+        };
+      }
+    }
+  } catch {
+    return null;
+  }
+
+  return null;
+}
+
+function buildReadabilityCandidate(
+  article: ReturnType<Readability["parse"]>,
+  document: Document,
+  method: string
+): ExtractionCandidate | null {
+  const textContent = article?.textContent?.trim() ?? "";
+  if (textContent.length < MIN_CONTENT_LENGTH) return null;
+
+  return {
+    title: pickString(article?.title, extractTitle(document)),
+    byline: pickString((article as { byline?: string } | null)?.byline),
+    excerpt: pickString(article?.excerpt, generateExcerpt(null, textContent)),
+    published: pickString((article as { publishedTime?: string } | null)?.publishedTime, extractPublishedTime(document)),
+    html: article?.content ? sanitizeHtml(article.content) : null,
+    textContent,
+    method,
+  };
+}
+
+function tryReadability(document: Document): ExtractionCandidate | null {
+  try {
+    const strictClone = document.cloneNode(true) as Document;
+    const strictResult = buildReadabilityCandidate(
+      new Readability(strictClone).parse(),
+      document,
+      "readability"
+    );
+    if (strictResult) return strictResult;
+
+    const relaxedClone = document.cloneNode(true) as Document;
+    return buildReadabilityCandidate(
+      new Readability(relaxedClone, { charThreshold: 120 }).parse(),
+      document,
+      "readability-relaxed"
+    );
+  } catch {
+    return null;
+  }
+}
+
+function trySelectorExtraction(document: Document): ExtractionCandidate | null {
+  for (const selector of CONTENT_SELECTORS) {
+    const element = document.querySelector(selector);
+    if (!element) continue;
+
+    const clone = element.cloneNode(true) as Element;
+    for (const removeSelector of REMOVE_SELECTORS) {
+      for (const node of clone.querySelectorAll(removeSelector)) {
+        node.remove();
+      }
+    }
+
+    const html = sanitizeHtml(clone.innerHTML);
+    const textContent = extractTextFromHtml(html);
+    if (textContent.length < MIN_CONTENT_LENGTH) continue;
+
+    return {
+      title: extractTitle(document),
+      byline: null,
+      excerpt: generateExcerpt(null, textContent),
+      published: extractPublishedTime(document),
+      html,
+      textContent,
+      method: `selector:${selector}`,
+    };
+  }
+
+  return null;
+}
+
+function tryBodyExtraction(document: Document): ExtractionCandidate | null {
+  const body = document.body;
+  if (!body) return null;
+
+  const clone = body.cloneNode(true) as Element;
+  for (const removeSelector of REMOVE_SELECTORS) {
+    for (const node of clone.querySelectorAll(removeSelector)) {
+      node.remove();
+    }
+  }
+
+  const html = sanitizeHtml(clone.innerHTML);
+  const textContent = extractTextFromHtml(html);
+  if (!textContent) return null;
+
+  return {
+    title: extractTitle(document),
+    byline: null,
+    excerpt: generateExcerpt(null, textContent),
+    published: extractPublishedTime(document),
+    html,
+    textContent,
+    method: "body-fallback",
+  };
+}
+
+function pickBestCandidate(candidates: ExtractionCandidate[]): ExtractionCandidate | null {
+  if (candidates.length === 0) return null;
+
+  const methodOrder = [
+    "readability",
+    "readability-relaxed",
+    "next-data",
+    "json-ld",
+    "selector:",
+    "body-fallback",
+  ];
+
+  function methodRank(method: string): number {
+    const idx = methodOrder.findIndex((entry) =>
+      entry.endsWith(":") ? method.startsWith(entry) : method === entry
+    );
+    return idx === -1 ? methodOrder.length : idx;
+  }
+
+  const ranked = [...candidates].sort((a, b) => {
+    const rankA = methodRank(a.method);
+    const rankB = methodRank(b.method);
+    if (rankA !== rankB) return rankA - rankB;
+    return (b.textContent.length ?? 0) - (a.textContent.length ?? 0);
+  });
+
+  for (const candidate of ranked) {
+    if (candidate.textContent.length >= GOOD_CONTENT_LENGTH) {
+      return candidate;
+    }
+  }
+
+  for (const candidate of ranked) {
+    if (candidate.textContent.length >= MIN_CONTENT_LENGTH) {
+      return candidate;
+    }
+  }
+
+  return ranked[0];
+}
+
+function extractFromHtml(html: string): ExtractionCandidate | null {
+  const document = parseDocument(html);
+
+  const readabilityCandidate = tryReadability(document);
+  const nextDataCandidate = tryNextDataExtraction(document);
+  const jsonLdCandidate = tryJsonLdExtraction(document);
+  const selectorCandidate = trySelectorExtraction(document);
+  const bodyCandidate = tryBodyExtraction(document);
+
+  const candidates = [
+    readabilityCandidate,
+    nextDataCandidate,
+    jsonLdCandidate,
+    selectorCandidate,
+    bodyCandidate,
+  ].filter((candidate): candidate is ExtractionCandidate => Boolean(candidate));
+
+  const winner = pickBestCandidate(candidates);
+  if (!winner) return null;
+
+  return {
+    ...winner,
+    title: winner.title ?? extractTitle(document),
+    published: winner.published ?? extractPublishedTime(document),
+    excerpt: winner.excerpt ?? generateExcerpt(null, winner.textContent),
+  };
+}
+
+const turndown = new TurndownService({
+  headingStyle: "atx",
+  hr: "---",
+  bulletListMarker: "-",
+  codeBlockStyle: "fenced",
+  emDelimiter: "*",
+  strongDelimiter: "**",
+  linkStyle: "inlined",
+});
+
+turndown.use(gfm);
+turndown.remove(["script", "style", "iframe", "noscript", "template", "svg", "path"]);
+
+turndown.addRule("collapseFigure", {
+  filter: "figure",
+  replacement(content) {
+    return `\n\n${content.trim()}\n\n`;
+  },
+});
+
+turndown.addRule("dropInvisibleAnchors", {
+  filter(node) {
+    return node.nodeName === "A" && !(node as Element).textContent?.trim();
+  },
+  replacement() {
+    return "";
+  },
+});
+
+function convertHtmlToMarkdown(html: string): string {
+  if (!html || !html.trim()) return "";
+
+  try {
+    const sanitized = sanitizeHtml(html);
+    return turndown.turndown(sanitized);
+  } catch {
+    return "";
+  }
+}
+
+function fallbackPlainText(html: string): string {
+  const document = parseDocument(html);
+  for (const selector of ["script", "style", "noscript", "template", "iframe", "svg", "path"]) {
+    for (const el of document.querySelectorAll(selector)) {
+      el.remove();
+    }
+  }
+  const text = document.body?.textContent ?? document.documentElement?.textContent ?? "";
+  return normalizeMarkdown(text.replace(/\s+/g, " "));
+}
+
+function countBylines(markdown: string): number {
+  return (markdown.match(/(^|\n)By\s+/g) || []).length;
+}
+
+function countUsefulParagraphs(markdown: string): number {
+  const paragraphs = normalizeMarkdown(markdown).split(/\n{2,}/);
+  let count = 0;
+
+  for (const paragraph of paragraphs) {
+    const trimmed = paragraph.trim();
+    if (!trimmed) continue;
+    if (/^!?\[[^\]]*\]\([^)]+\)$/.test(trimmed)) continue;
+    if (/^#{1,6}\s+/.test(trimmed)) continue;
+    if ((trimmed.match(/\b[\p{L}\p{N}']+\b/gu) || []).length < 8) continue;
+    count++;
+  }
+
+  return count;
+}
+
+function countMarkerHits(markdown: string, markers: RegExp[]): number {
+  let hits = 0;
+  for (const marker of markers) {
+    if (marker.test(markdown)) hits++;
+  }
+  return hits;
+}
+
+function scoreMarkdownQuality(markdown: string): number {
+  const normalized = normalizeMarkdown(markdown);
+  const wordCount = (normalized.match(/\b[\p{L}\p{N}']+\b/gu) || []).length;
+  const usefulParagraphs = countUsefulParagraphs(normalized);
+  const headingCount = (normalized.match(/^#{1,6}\s+/gm) || []).length;
+  const markerHits = countMarkerHits(normalized, LOW_QUALITY_MARKERS);
+  const bylineCount = countBylines(normalized);
+  const staffCount = (normalized.match(/\bForbes Staff\b/gi) || []).length;
+
+  return (
+    Math.min(wordCount, 4000) +
+    usefulParagraphs * 40 +
+    headingCount * 10 -
+    markerHits * 180 -
+    Math.max(0, bylineCount - 1) * 120 -
+    Math.max(0, staffCount - 1) * 80
+  );
+}
+
+function shouldCompareWithLegacy(markdown: string): boolean {
+  const normalized = normalizeMarkdown(markdown);
+  return (
+    countMarkerHits(normalized, LOW_QUALITY_MARKERS) > 0 ||
+    countBylines(normalized) > 1 ||
+    countUsefulParagraphs(normalized) < 6
+  );
+}
+
+function isMarkdownUsable(markdown: string, html: string): boolean {
+  const normalized = normalizeMarkdown(markdown);
+  if (!normalized) return false;
+
+  const htmlTextLength = extractTextFromHtml(html).length;
+  if (htmlTextLength < MIN_CONTENT_LENGTH) return true;
+
+  if (normalized.length >= 80) return true;
+  return normalized.length >= Math.min(200, Math.floor(htmlTextLength * 0.2));
+}
+
+async function tryDefuddleConversion(
+  html: string,
+  url: string,
+  baseMetadata: PageMetadata
+): Promise<{ ok: true; result: ConversionResult } | { ok: false; reason: string }> {
+  try {
+    const [{ JSDOM, VirtualConsole }, { Defuddle }] = await Promise.all([
+      import("jsdom"),
+      import("defuddle/node"),
+    ]);
+
+    const virtualConsole = new VirtualConsole();
+    virtualConsole.on("jsdomError", (error: Error & { type?: string }) => {
+      if (error.type === "css parsing" || /Could not parse CSS stylesheet/i.test(error.message)) {
+        return;
+      }
+      console.warn(`[url-to-markdown] jsdom: ${error.message}`);
+    });
+
+    const dom = new JSDOM(html, { url, virtualConsole });
+    const result = await Defuddle(dom, url, { markdown: true });
+    const markdown = normalizeMarkdown(result.content || "");
+
+    if (!isMarkdownUsable(markdown, html)) {
+      return { ok: false, reason: "Defuddle returned empty or incomplete markdown" };
+    }
+
+    return {
+      ok: true,
+      result: {
+        metadata: {
+          ...baseMetadata,
+          title: pickString(result.title, baseMetadata.title) ?? "",
+          description: pickString(result.description, baseMetadata.description) ?? undefined,
+          author: pickString(result.author, baseMetadata.author) ?? undefined,
+          published: pickString(result.published, baseMetadata.published) ?? undefined,
+          coverImage: pickString(result.image, baseMetadata.coverImage) ?? undefined,
+        },
+        markdown,
+        rawHtml: html,
+        conversionMethod: "defuddle",
+      },
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      reason: error instanceof Error ? error.message : String(error),
+    };
+  }
+}
+
+function convertWithLegacyExtractor(html: string, baseMetadata: PageMetadata): ConversionResult {
+  const extracted = extractFromHtml(html);
+
+  let markdown = extracted?.html ? convertHtmlToMarkdown(extracted.html) : "";
+  if (!markdown.trim()) {
+    markdown = extracted?.textContent?.trim() || fallbackPlainText(html);
+  }
+
+  return {
+    metadata: {
+      ...baseMetadata,
+      title: pickString(extracted?.title, baseMetadata.title) ?? "",
+      description: pickString(extracted?.excerpt, baseMetadata.description) ?? undefined,
+      author: pickString(extracted?.byline, baseMetadata.author) ?? undefined,
+      published: pickString(extracted?.published, baseMetadata.published) ?? undefined,
+    },
+    markdown: normalizeMarkdown(markdown),
+    rawHtml: html,
+    conversionMethod: extracted ? `legacy:${extracted.method}` : "legacy:plain-text",
+  };
+}
+
+export async function extractContent(html: string, url: string): Promise<ConversionResult> {
+  const capturedAt = new Date().toISOString();
+  const baseMetadata = extractMetadataFromHtml(html, url, capturedAt);
+
+  const defuddleResult = await tryDefuddleConversion(html, url, baseMetadata);
+  if (defuddleResult.ok) {
+    if (shouldCompareWithLegacy(defuddleResult.result.markdown)) {
+      const legacyResult = convertWithLegacyExtractor(html, baseMetadata);
+      const legacyScore = scoreMarkdownQuality(legacyResult.markdown);
+      const defuddleScore = scoreMarkdownQuality(defuddleResult.result.markdown);
+
+      if (legacyScore > defuddleScore + 120) {
+        return {
+          ...legacyResult,
+          fallbackReason: "Legacy extractor produced higher-quality markdown than Defuddle",
+        };
+      }
+    }
+
+    return defuddleResult.result;
+  }
+
+  const fallbackResult = convertWithLegacyExtractor(html, baseMetadata);
+  return {
+    ...fallbackResult,
+    fallbackReason: defuddleResult.reason,
+  };
 }

 function escapeYamlValue(value: string): string {
@@ -69,6 +69,12 @@ function formatTimestamp(): string {
  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
 }

+function deriveHtmlSnapshotPath(markdownPath: string): string {
+  const parsed = path.parse(markdownPath);
+  const basename = parsed.ext ? parsed.name : parsed.base;
+  return path.join(parsed.dir, `${basename}-captured.html`);
+}
+
 async function generateOutputPath(url: string, title: string, outputDir?: string): Promise<string> {
  const domain = new URL(url).hostname.replace(/^www\./, "");
  const slug = generateSlug(title, url);
@@ -141,7 +147,7 @@ async function captureUrl(args: Args): Promise<ConversionResult> {
 async function main(): Promise<void> {
  const args = parseArgs(process.argv);
  if (!args.url) {
-    console.error("Usage: bun main.ts <url> [-o output.md] [--wait] [--timeout ms]");
+    console.error("Usage: bun main.ts <url> [-o output.md] [--output-dir dir] [--wait] [--timeout ms] [--download-media]");
    process.exit(1);
  }

@@ -166,7 +172,9 @@ async function main(): Promise<void> {
  const result = await captureUrl(args);
  const outputPath = args.output || await generateOutputPath(args.url, result.metadata.title, args.outputDir);
  const outputDir = path.dirname(outputPath);
+  const htmlSnapshotPath = deriveHtmlSnapshotPath(outputPath);
  await mkdir(outputDir, { recursive: true });
+  await writeFile(htmlSnapshotPath, result.rawHtml, "utf-8");

  let document = createMarkdownDocument(result);

@@ -189,7 +197,12 @@ async function main(): Promise<void> {
  await writeFile(outputPath, document, "utf-8");

  console.log(`Saved: ${outputPath}`);
+  console.log(`Saved HTML: ${htmlSnapshotPath}`);
  console.log(`Title: ${result.metadata.title || "(no title)"}`);
+  console.log(`Converter: ${result.conversionMethod}`);
+  if (result.fallbackReason) {
+    console.warn(`Fallback used: ${result.fallbackReason}`);
+  }
 }

 main().catch((err) => {
@@ -0,0 +1,13 @@
+{
+  "name": "baoyu-url-to-markdown-scripts",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@mozilla/readability": "^0.6.0",
+    "defuddle": "^0.10.0",
+    "jsdom": "^24.1.3",
+    "linkedom": "^0.18.12",
+    "turndown": "^7.2.2",
+    "turndown-plugin-gfm": "^1.0.2"
+  }
+}
@@ -1,6 +1,10 @@
 ---
 name: baoyu-xhs-images
-description: Generates Xiaohongshu (Little Red Book) infographic series with 10 visual styles and 8 layouts. Breaks content into 1-10 cartoon-style images optimized for XHS engagement. Use when user mentions "小红书图片", "XHS images", "RedNote infographics", "小红书种草", or wants social media infographics for Chinese platforms.
+description: Generates Xiaohongshu (Little Red Book) infographic series with 11 visual styles and 8 layouts. Breaks content into 1-10 cartoon-style images optimized for XHS engagement. Use when user mentions "小红书图片", "XHS images", "RedNote infographics", "小红书种草", or wants social media infographics for Chinese platforms.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-xhs-images
 ---

 # Xiaohongshu Infographic Series Generator
@@ -22,6 +26,12 @@ Break down complex content into eye-catching infographic series for Xiaohongshu
 # Combine style and layout
 /baoyu-xhs-images posts/ai-future/article.md --style notion --layout list

+# Use preset (style + layout shorthand)
+/baoyu-xhs-images posts/ai-future/article.md --preset knowledge-card
+
+# Preset with override
+/baoyu-xhs-images posts/ai-future/article.md --preset poster --layout quadrant
+
 # Direct content input
 /baoyu-xhs-images
 [paste content]
@@ -37,16 +47,19 @@ Break down complex content into eye-catching infographic series for Xiaohongshu
 |--------|-------------|
 | `--style <name>` | Visual style (see Style Gallery) |
 | `--layout <name>` | Information layout (see Layout Gallery) |
+| `--preset <name>` | Style + layout shorthand (see [Style Presets](references/style-presets.md)) |

 ## Two Dimensions

 | Dimension | Controls | Options |
 |-----------|----------|---------|
-| **Style** | Visual aesthetics: colors, lines, decorations | cute, fresh, warm, bold, minimal, retro, pop, notion, chalkboard, study-notes |
+| **Style** | Visual aesthetics: colors, lines, decorations | cute, fresh, warm, bold, minimal, retro, pop, notion, chalkboard, study-notes, screen-print |
 | **Layout** | Information structure: density, arrangement | sparse, balanced, dense, list, comparison, flow, mindmap, quadrant |

 Style × Layout can be freely combined. Example: `--style notion --layout dense` creates an intellectual-looking knowledge card with high information density.

+Or use presets: `--preset knowledge-card` → style + layout in one flag. See [Style Presets](references/style-presets.md).
+
 ## Style Gallery

 | Style | Description |
@@ -61,9 +74,64 @@ Style × Layout can be freely combined. Example: `--style notion --layout dense`
 | `notion` | Minimalist hand-drawn line art, intellectual |
 | `chalkboard` | Colorful chalk on black board, educational |
 | `study-notes` | Realistic handwritten photo style, blue pen + red annotations + yellow highlighter |
+| `screen-print` | Bold poster art, halftone textures, limited colors, symbolic storytelling |

 Detailed style definitions: `references/presets/<style>.md`

+## Preset Gallery
+
+Quick-start presets by content scenario. Use `--preset <name>` or recommend during Step 2.
+
+**Knowledge & Learning**:
+
+| Preset | Style | Layout | Best For |
+|--------|-------|--------|----------|
+| `knowledge-card` | notion | dense | 干货知识卡、概念科普 |
+| `checklist` | notion | list | 清单、排行榜、必备清单 |
+| `concept-map` | notion | mindmap | 概念图、知识脉络 |
+| `swot` | notion | quadrant | SWOT分析、四象限分类 |
+| `tutorial` | chalkboard | flow | 教程步骤、操作流程 |
+| `classroom` | chalkboard | balanced | 课堂笔记、知识讲解 |
+| `study-guide` | study-notes | dense | 学习笔记、考试重点 |
+
+**Lifestyle & Sharing**:
+
+| Preset | Style | Layout | Best For |
+|--------|-------|--------|----------|
+| `cute-share` | cute | balanced | 少女风分享、日常种草 |
+| `girly` | cute | sparse | 甜美封面、氛围感 |
+| `cozy-story` | warm | balanced | 生活故事、情感分享 |
+| `product-review` | fresh | comparison | 产品对比、测评 |
+| `nature-flow` | fresh | flow | 健康流程、自然主题 |
+
+**Impact & Opinion**:
+
+| Preset | Style | Layout | Best For |
+|--------|-------|--------|----------|
+| `warning` | bold | list | 避坑指南、重要提醒 |
+| `versus` | bold | comparison | 正反对比、强烈对照 |
+| `clean-quote` | minimal | sparse | 金句、极简封面 |
+| `pro-summary` | minimal | balanced | 专业总结、商务内容 |
+
+**Trend & Entertainment**:
+
+| Preset | Style | Layout | Best For |
+|--------|-------|--------|----------|
+| `retro-ranking` | retro | list | 复古排行、经典盘点 |
+| `throwback` | retro | balanced | 怀旧分享、老物件 |
+| `pop-facts` | pop | list | 趣味冷知识、好玩的事 |
+| `hype` | pop | sparse | 炸裂封面、惊叹分享 |
+
+**Poster & Editorial**:
+
+| Preset | Style | Layout | Best For |
+|--------|-------|--------|----------|
+| `poster` | screen-print | sparse | 海报风封面、影评书评 |
+| `editorial` | screen-print | balanced | 观点文章、文化评论 |
+| `cinematic` | screen-print | comparison | 电影对比、戏剧张力 |
+
+Full preset definitions: [references/style-presets.md](references/style-presets.md)
+
 ## Layout Gallery

 | Layout | Description |
@@ -81,18 +149,19 @@ Detailed layout definitions: `references/elements/canvas.md`

 ## Auto Selection

-| Content Signals | Style | Layout |
-|-----------------|-------|--------|
-| Beauty, fashion, cute, girl, pink | `cute` | sparse/balanced |
-| Health, nature, clean, fresh, organic | `fresh` | balanced/flow |
-| Life, story, emotion, feeling, warm | `warm` | balanced |
-| Warning, important, must, critical | `bold` | list/comparison |
-| Professional, business, elegant, simple | `minimal` | sparse/balanced |
-| Classic, vintage, old, traditional | `retro` | balanced |
-| Fun, exciting, wow, amazing | `pop` | sparse/list |
-| Knowledge, concept, productivity, SaaS | `notion` | dense/list |
-| Education, tutorial, learning, teaching, classroom | `chalkboard` | balanced/dense |
-| Notes, handwritten, study guide, knowledge, realistic, photo | `study-notes` | dense/list/mindmap |
+| Content Signals | Style | Layout | Recommended Preset |
+|-----------------|-------|--------|--------------------|
+| Beauty, fashion, cute, girl, pink | `cute` | sparse/balanced | `cute-share`, `girly` |
+| Health, nature, clean, fresh, organic | `fresh` | balanced/flow | `product-review`, `nature-flow` |
+| Life, story, emotion, feeling, warm | `warm` | balanced | `cozy-story` |
+| Warning, important, must, critical | `bold` | list/comparison | `warning`, `versus` |
+| Professional, business, elegant, simple | `minimal` | sparse/balanced | `clean-quote`, `pro-summary` |
+| Classic, vintage, old, traditional | `retro` | balanced | `throwback`, `retro-ranking` |
+| Fun, exciting, wow, amazing | `pop` | sparse/list | `hype`, `pop-facts` |
+| Knowledge, concept, productivity, SaaS | `notion` | dense/list | `knowledge-card`, `checklist` |
+| Education, tutorial, learning, teaching, classroom | `chalkboard` | balanced/dense | `tutorial`, `classroom` |
+| Notes, handwritten, study guide, knowledge, realistic, photo | `study-notes` | dense/list/mindmap | `study-guide` |
+| Movie, album, concert, poster, opinion, editorial, dramatic, cinematic | `screen-print` | sparse/comparison | `poster`, `editorial`, `cinematic` |

 ## Outline Strategies

@@ -172,11 +241,12 @@ XHS Infographic Progress:
  - [ ] Found → load preferences → continue
  - [ ] Not found → run first-time setup → MUST complete before Step 1
 - [ ] Step 1: Analyze content → analysis.md
- [ ] Step 2: Confirmation 1 - Content understanding ⚠️ REQUIRED
- [ ] Step 3: Generate 3 outline + style variants
- [ ] Step 4: Confirmation 2 - Outline & style & elements selection ⚠️ REQUIRED
- [ ] Step 5: Generate images (sequential)
- [ ] Step 6: Completion report
+- [ ] Step 2: Smart Confirm ⚠️ REQUIRED
+  - [ ] Path A: Quick confirm → generate recommended outline
+  - [ ] Path B: Customize → adjust then generate outline
+  - [ ] Path C: Detailed → 3 outlines → second confirm → generate outline
+- [ ] Step 3: Generate images (sequential)
+- [ ] Step 4: Completion report
 ```

 ### Flow
@@ -190,7 +260,11 @@ Input → [Step 0: Preferences] ─┬─ Found → Continue
                                                                                      │
        ┌───────────────────────────────────────────────────────────────────────────┘
        ↓
-Analyze → [Confirm 1] → 3 Outlines → [Confirm 2: Outline + Style + Elements] → Generate → Complete
+Analyze → [Smart Confirm] ─┬─ Quick: confirm recommended → outline.md → Generate → Complete
+                           │
+                           ├─ Customize: adjust options → outline.md → Generate → Complete
+                           │
+                           └─ Detailed: 3 outlines → [Confirm 2] → outline.md → Generate → Complete
 ```

 ### Step 0: Load Preferences (EXTEND.md) ⛔ BLOCKING
@@ -258,18 +332,63 @@ Read source content, save it if needed, and perform deep analysis.
   - Swipe flow design
 4. Detect source language
 5. Determine recommended image count (2-10)
-6. **Generate clarifying questions** (see Step 2)
+6. **Auto-recommend** best strategy + style + layout based on content signals
 7. **Save to `analysis.md`**

-### Step 2: Confirmation 1 - Content Understanding ⚠️
+### Step 2: Smart Confirm ⚠️

-**Purpose**: Validate understanding + collect missing info. **Do NOT skip.**
+**Purpose**: Present auto-recommended plan, let user confirm or adjust. **Do NOT skip.**

-**Display summary**:
- Content type + topic identified
- Key points extracted
- Tone detected
- Source images count
+**Auto-Recommendation Logic**:
+1. Use Auto Selection table to match content signals → best strategy + style + layout
+2. Infer optimal image count from content density
+3. Load style's default elements from preset
+
+**Display** (analysis summary + recommended plan):
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 内容分析
+  主题：[topic] | 类型：[content_type]
+  要点：[key points summary]
+  受众：[target audience]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎨 推荐方案（自动匹配）
+  策略：[A/B/C] [strategy name]（[reason]）
+  风格：[style] · 布局：[layout] · 预设：[preset]
+  图片：[N]张（封面+[N-2]内容+结尾）
+  元素：[background] / [decorations] / [emphasis]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**Use AskUserQuestion** with single question:
+
+| Option | Description |
+|--------|-------------|
+| 1. ✅ 确认，直接生成（推荐） | Trust auto-recommendation, proceed immediately |
+| 2. 🎛️ 自定义调整 | Modify strategy/style/layout/count in one step |
+| 3. 📋 详细模式 | Generate 3 outlines, then choose (two confirmations) |
+
+#### Path A: Quick Confirm (Option 1)
+
+Generate single outline using recommended strategy + style → save to `outline.md` → Step 3.
+
+#### Path B: Customize (Option 2)
+
+**Use AskUserQuestion** with adjustable options (leave blank = keep recommended):
+
+1. **策略风格**: Current: [strategy + style]. Options: A Story-Driven(warm) | B Information-Dense(notion) | C Visual-First(screen-print). Or specify style directly: cute/fresh/warm/bold/minimal/retro/pop/notion/chalkboard/study-notes/screen-print. Or use preset: knowledge-card / checklist / tutorial / poster / cinematic / etc.
+2. **布局**: Current: [layout]. Options: sparse | balanced | dense | list | comparison | flow | mindmap | quadrant
+3. **图片数量**: Current: [N]. Range: 2-10
+4. **补充说明**（可选）: Selling point emphasis, audience adjustment, color preference, etc.
+
+**After response**: Generate single outline with user's choices → save to `outline.md` → Step 3.
+
+#### Path C: Detailed Mode (Option 3)
+
+Full two-confirmation flow for maximum control:
+
+**Step 2a: Content Understanding**

 **Use AskUserQuestion** for:
 1. Core selling point (multiSelect: true)
@@ -277,19 +396,15 @@ Read source content, save it if needed, and perform deep analysis.
 3. Style preference: Authentic sharing / Professional review / Aesthetic mood / Auto
 4. Additional context (optional)

-**After response**: Update `analysis.md` → Step 3
+**After response**: Update `analysis.md`.

-### Step 3: Generate 3 Outline + Style Variants
-
-Based on analysis + user context, create three distinct strategy variants. Each variant includes both **outline structure** and **visual style recommendation**.
-
-**For each strategy**:
+**Step 2b: Generate 3 Outline Variants**

 | Strategy | Filename | Outline | Recommended Style |
 |----------|----------|---------|-------------------|
 | A | `outline-strategy-a.md` | Story-driven: emotional, before/after | warm, cute, fresh |
 | B | `outline-strategy-b.md` | Information-dense: structured, factual | notion, minimal, chalkboard |
-| C | `outline-strategy-c.md` | Visual-first: atmospheric, minimal text | bold, pop, retro |
+| C | `outline-strategy-c.md` | Visual-first: atmospheric, minimal text | bold, pop, retro, screen-print |

 **Outline format** (YAML front matter + content):
 ```yaml
@@ -298,7 +413,7 @@ strategy: a  # a, b, or c
 name: Story-Driven
 style: warm  # recommended style for this strategy
 style_reason: "Warm tones enhance emotional storytelling and personal connection"
-elements:  # from style preset, can be customized in Step 4
+elements:  # from style preset, can be customized
  background: solid-pastel
  decorations: [clouds, stars-sparkles]
  emphasis: star-burst
@@ -326,49 +441,22 @@ image_count: 5
 - Each strategy MUST have different outline structure AND different recommended style
 - Adapt page count: A typically 4-6, B typically 3-5, C typically 3-4
 - Include `style_reason` explaining why this style fits the strategy
- Consider user's style preference from Step 2

 Reference: `references/workflows/outline-template.md`

-### Step 4: Confirmation 2 - Outline & Style & Elements Selection ⚠️
-
-**Purpose**: User chooses outline strategy, confirms visual style, and customizes elements. **Do NOT skip.**
-
-**Display each strategy**:
- Strategy name + page count + recommended style
- Page-by-page summary (P1 → P2 → P3...)
+**Step 2c: Outline & Style Selection**

 **Use AskUserQuestion** with three questions:

-**Question 1: Outline Strategy**
- Strategy A (Recommended if "authentic sharing")
- Strategy B (Recommended if "professional review")
- Strategy C (Recommended if "aesthetic mood")
- Combine: specify pages from each
+**Q1: Outline Strategy**: A / B / C / Combine (specify pages from each)

-**Question 2: Visual Style**
- Use strategy's recommended style (show which style)
- Or select from: cute / fresh / warm / bold / minimal / retro / pop / notion / chalkboard
- Or type custom style description
+**Q2: Visual Style**: Use recommended | Select preset | Select style | Custom description

-**Question 3: Visual Elements** (show after style selection)
-Display the selected style's default elements from preset, then ask:
- Use style defaults (Recommended) - show preview: background, decorations, emphasis
- Adjust background - options: solid-pastel / solid-saturated / gradient-linear / gradient-radial / paper-texture / grid
- Adjust decorations - options: hearts / stars-sparkles / flowers / clouds / leaves / confetti
- Type custom element preferences
+**Q3: Visual Elements**: Use defaults (Recommended) | Adjust background | Adjust decorations | Custom

-**After response**:
- Single strategy → copy to `outline.md` with confirmed style
- Combination → merge specified pages with confirmed style
- Custom request → regenerate based on feedback
- Style defaults → use preset's Element Combination as-is
- Background adjustment → update elements.background with user choice
- Decorations adjustment → update elements.decorations with user choice
- Custom elements → parse user's preferences into elements fields
- Update `outline.md` frontmatter with final style and elements
+**After response**: Save selected/merged outline to `outline.md` with confirmed style and elements → Step 3.

-### Step 5: Generate Images
+### Step 3: Generate Images

 With confirmed outline + style + layout:

@@ -408,12 +496,13 @@ If image generation skill supports `--sessionId`:
 2. Use same session ID for all images
 3. Combined with reference image chain, ensures maximum visual consistency

-### Step 6: Completion Report
+### Step 4: Completion Report

 ```
 Xiaohongshu Infographic Series Complete!

 Topic: [topic]
+Mode: [Quick / Custom / Detailed]
 Strategy: [A/B/C/Combined]
 Style: [style name]
 Layout: [layout name or "varies"]
@@ -421,10 +510,8 @@ Location: [directory path]
 Images: N total

 ✓ analysis.md
-✓ outline-strategy-a.md
-✓ outline-strategy-b.md
-✓ outline-strategy-c.md
-✓ outline.md (selected: [strategy])
+✓ outline.md
+✓ outline-strategy-a/b/c.md (detailed mode only)

 Files:
 - 01-cover-[slug].png ✓ Cover (sparse)
@@ -463,6 +550,7 @@ Files:
 | notion | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ |
 | chalkboard | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ |
 | study-notes | ✗ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓ |
+| screen-print | ✓✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ |

 ## References

@@ -476,6 +564,7 @@ Detailed templates in `references/` directory:

 **Presets** (Style presets):
 - `presets/<name>.md` - Element combination definitions (cute, notion, warm...)
+- `style-presets.md` - Preset shortcuts (style + layout combos)

 **Workflows** (Process guides):
 - `workflows/analysis-framework.md` - Content analysis framework
@@ -491,7 +580,7 @@ Detailed templates in `references/` directory:

 - Auto-retry once on failure | Cartoon alternatives for sensitive figures
 - Use confirmed language preference | Maintain style consistency
- **Two confirmation points required** (Steps 2 & 4) - do not skip
+- **Smart Confirm required** (Step 2) - do not skip; detailed mode uses two sub-confirmations

 ## Extension Support

@@ -143,3 +143,10 @@ Pre-composed decorative elements.
 - Chalk dust effects
 - Hand-drawn doodles
 - Mathematical formulas, simple icons
+
+### Screen-Print Style
+- Bold silhouettes, geometric shapes
+- Halftone dot patterns, print grain
+- No doodles — negative space does the work
+- Stencil-cut edges, color block boundaries
+- Vintage poster border treatments
@@ -0,0 +1,92 @@
+---
+name: screen-print
+category: poster
+---
+
+# Screen-Print Style
+
+Bold poster art with halftone textures, limited colors, and symbolic storytelling.
+
+## Element Combination
+
+```yaml
+canvas:
+  ratio: portrait-3-4
+  grid: single | dual
+
+image_effects:
+  cutout: silhouette
+  stroke: none
+  filter: halftone | print-grain
+
+typography:
+  decorated: stroke-text | shadow-3d
+  tags: none
+  direction: horizontal
+
+decorations:
+  emphasis: star-burst | numbering
+  background: solid-saturated | paper-texture
+  doodles: none
+  frames: none
+```
+
+## Color Palette
+
+| Role | Colors | Hex |
+|------|--------|-----|
+| Primary | Burnt Orange, Deep Teal | #E8751A, #0A6E6E |
+| Background | Off-Black, Warm Cream | #121212, #F5E6D0 |
+| Accents | Crimson, Amber | #C0392B, #F4A623 |
+
+**Duotone Pairs** (choose ONE based on content mood):
+
+| Pair | Color A | Color B | Feel |
+|------|---------|---------|------|
+| Orange + Teal | #E8751A | #0A6E6E | Cinematic, action |
+| Red + Cream | #C0392B | #F5E6D0 | Bold, classic |
+| Blue + Gold | #1A3A5C | #D4A843 | Premium, prestigious |
+| Crimson + Navy | #DC143C | #0D1B2A | Dramatic, noir |
+| Magenta + Cyan | #C2185B | #00BCD4 | Vibrant, pop |
+
+**Rule**: Use 2-5 colors maximum. Fewer colors = stronger impact.
+
+## Visual Elements
+
+- Bold silhouettes and symbolic shapes
+- Halftone dot patterns within color fills
+- Slight color layer misregistration (print offset effect)
+- Geometric framing (circles, arches, triangles)
+- Figure-ground inversion (negative space tells secondary story)
+- Stencil-cut edges, no outlines — shapes defined by color boundaries
+- Typography integrated as design element, not overlay
+- Vintage poster border treatments
+
+## Typography
+
+- Bold condensed sans-serif or hand-drawn lettering
+- Art Deco influences, vintage poster typography
+- Typography as integral part of composition (not separate layer)
+- High contrast with background for readability
+
+## Best Layout Pairings
+
+| Layout | Compatibility | Use Case |
+|--------|---------------|----------|
+| sparse | ✓✓ | Iconic poster covers, dramatic statements |
+| balanced | ✓✓ | Editorial compositions, opinion pieces |
+| dense | ✗ | Too much info clashes with minimal poster aesthetic |
+| list | ✓ | Bold rankings, top picks |
+| comparison | ✓✓ | Duotone split compositions, before/after |
+| flow | ✓ | Cinematic progression, timelines |
+| mindmap | ✗ | Too complex for geometric poster style |
+| quadrant | ✓✓ | Strong geometric division, classification |
+
+## Best For
+
+- Opinion pieces, cultural commentary
+- Movie/music/book recommendations
+- Dramatic announcements
+- Before/after transformations
+- Bold editorial content
+- Event promotions
@@ -0,0 +1,36 @@
+# Style Presets
+
+`--preset X` expands to a style + layout combination. Users can override either dimension.
+
+| --preset | Style | Layout |
+|----------|-------|--------|
+| `knowledge-card` | `notion` | `dense` |
+| `checklist` | `notion` | `list` |
+| `concept-map` | `notion` | `mindmap` |
+| `swot` | `notion` | `quadrant` |
+| `tutorial` | `chalkboard` | `flow` |
+| `classroom` | `chalkboard` | `balanced` |
+| `study-guide` | `study-notes` | `dense` |
+| `cute-share` | `cute` | `balanced` |
+| `girly` | `cute` | `sparse` |
+| `cozy-story` | `warm` | `balanced` |
+| `product-review` | `fresh` | `comparison` |
+| `nature-flow` | `fresh` | `flow` |
+| `warning` | `bold` | `list` |
+| `versus` | `bold` | `comparison` |
+| `clean-quote` | `minimal` | `sparse` |
+| `pro-summary` | `minimal` | `balanced` |
+| `retro-ranking` | `retro` | `list` |
+| `throwback` | `retro` | `balanced` |
+| `pop-facts` | `pop` | `list` |
+| `hype` | `pop` | `sparse` |
+| `poster` | `screen-print` | `sparse` |
+| `editorial` | `screen-print` | `balanced` |
+| `cinematic` | `screen-print` | `comparison` |
+
+## Override Examples
+
+- `--preset knowledge-card --style chalkboard` = chalkboard style with dense layout
+- `--preset poster --layout quadrant` = screen-print style with quadrant layout
+
+Explicit `--style`/`--layout` flags always override preset values.
@@ -195,4 +195,4 @@ Before proceeding to outline generation:
 - [ ] Have I identified save/share triggers?
 - [ ] Are there clear visual opportunities?
 - [ ] Is the swipe flow planned?
- [ ] Have I selected 3 style+layout combinations?
+- [ ] Have I identified the best style+layout recommendation?
@@ -77,6 +77,41 @@ Load from `presets/{style}.md` and extract key elements:
 {typography_style}
 ```

+### Screen-Print Style Override
+
+When `style: screen-print`, replace the standard Core Principles and Text Style sections with:
+
+```
+## Core Principles
+
+- Screen print / silkscreen poster art — flat color blocks, NO gradients
+- Bold silhouettes and symbolic shapes over detailed rendering
+- Negative space as active storytelling element
+- If content involves sensitive or copyrighted figures, create stylistically similar silhouettes
+- One iconic focal point per image — conceptual, not literal
+
+## Color Rules (CRITICAL)
+
+- **2-5 FLAT COLORS MAXIMUM** — fewer colors = stronger impact
+- Choose ONE duotone pair from preset as dominant palette
+- Halftone dot patterns for tonal variation (NOT gradients)
+- Slight color layer misregistration for print authenticity
+
+## Text Style (CRITICAL)
+
+- Bold condensed sans-serif or Art Deco influenced lettering
+- Typography INTEGRATED into composition as design element
+- High contrast with background, stencil-cut quality
+- **DO NOT use delicate, thin, or handwritten fonts**
+
+## Composition
+
+- Geometric framing: circles, arches, triangles
+- Figure-ground inversion where possible (negative space forms secondary image)
+- Stencil-cut edges between color blocks, no outlines
+- Paper grain texture beneath all colors
+```
+
 ## Layout Section Assembly

 Load from `elements/canvas.md` and extract relevant layout:
@@ -123,7 +158,18 @@ be legible but not distracting from the main content.

 ## Assembly Process

-### Step 1: Load Preset
+### Step 0: Resolve Style Preset (if `--preset` used)
+
+If user specified `--preset`, resolve to style + layout from `references/style-presets.md`:
+
+```python
+# e.g., --preset knowledge-card → style=notion, layout=dense
+style, layout = resolve_preset(preset_name)
+```
+
+Explicit `--style`/`--layout` flags override preset values.
+
+### Step 1: Load Style Definition

 ```python
 preset = load_preset(style_name)  # e.g., "notion"
@@ -165,13 +211,9 @@ If preferences include watermark:
 When generating multiple images in a series:

 1. **Image 1 (cover)**: Generate without `--ref` — this establishes the visual anchor
-2. **Images 2+**: Always pass image 1 as `--ref` to the image generation skill:
-   ```bash
-   ${BUN_X} ${SKILL_DIR}/scripts/main.ts \
-     --promptfiles prompts/02-content-xxx.md \
-     --ref path/to/01-cover-xxx.png \
-     --image 02-content-xxx.png --ar 3:4 --quality 2k
-   ```
+2. **Images 2+**: Always pass image 1 as `--ref` to the installed image generation skill.
+   Read that skill's `SKILL.md` and use its documented interface rather than calling its scripts directly.
+   For each later image, use the assembled prompt file as input, set the output image path, keep aspect ratio `3:4`, use quality `2k`, and pass image 1 as the reference.
   This ensures the AI maintains the same character design, illustration style, and color rendering across the series.

 ### Step 6: Combine
Author	SHA1	Message	Date
Jim Liu 宝玉	5144335916	chore: release v1.57.0	2026-03-08 19:24:45 -05:00
Jim Liu 宝玉	fa82c3d910	refactor(baoyu-xhs-images): use skill interface instead of direct script invocation for image generation	2026-03-08 19:24:03 -05:00
Jim Liu 宝玉	90730bc551	refactor(baoyu-comic): use skill interface instead of direct script invocation for image generation	2026-03-08 19:24:02 -05:00
Jim Liu 宝玉	154ccfe3ff	refactor: add openclaw metadata and rename SKILL_DIR to baseDir across all skills	2026-03-08 19:22:24 -05:00
Jim Liu 宝玉	93efa5aeb1	refactor(baoyu-comic): add openclaw metadata, baseDir rename, and decouple image skill path	2026-03-08 19:22:19 -05:00
Jim Liu 宝玉	40ccbed74a	refactor(baoyu-danger-x-to-markdown): add openclaw metadata, baseDir rename, and dynamic script path	2026-03-08 19:22:18 -05:00
Jim Liu 宝玉	fbf2bc02c5	refactor(baoyu-danger-gemini-web): add openclaw metadata, baseDir rename, and dynamic script path	2026-03-08 19:22:18 -05:00
Jim Liu 宝玉	a37c80e142	feat: add ClawHub/OpenClaw publishing support	2026-03-08 19:22:13 -05:00
Jim Liu 宝玉	2e68aa64a4	chore: release v1.56.1	2026-03-08 17:42:38 -05:00
Jim Liu 宝玉	059ebc759c	fix(baoyu-post-to-weibo): simplify article image insertion with Backspace-based placeholder deletion	2026-03-08 15:49:54 -05:00
Jim Liu 宝玉	d4a5a34865	chore: release v1.56.0	2026-03-08 14:08:40 -05:00
Jim Liu 宝玉	b3b2f8ea36	feat(baoyu-xhs-images): streamline workflow with smart confirm (6→4 steps)	2026-03-08 14:07:59 -05:00
Jim Liu 宝玉	f19ed00cb2	fix(baoyu-post-to-wechat): improve image upload with file chooser interception	2026-03-08 14:07:55 -05:00
Jim Liu 宝玉	8e58855047	feat(baoyu-article-illustrator): add preset-first selection and categorized style presets	2026-03-08 14:07:53 -05:00
Jim Liu 宝玉	fdfb0e2dfe	chore: release v1.55.0	2026-03-08 13:07:49 -05:00
Jim Liu 宝玉	b4e319ba8f	docs: add credits section to READMEs	2026-03-08 13:07:18 -05:00
Jim Liu 宝玉	691a9c2272	feat(baoyu-xhs-images): add screen-print style and style presets Add screen-print as 11th visual style with poster aesthetic. Add --preset flag for quick style + layout selection with 23 built-in presets (knowledge-card, poster, cinematic, etc.). Update auto-selection and compatibility matrices.	2026-03-08 13:07:14 -05:00
Jim Liu 宝玉	16db99a3ef	feat(baoyu-cover-image): add screen-print rendering and duotone palette Add screen-print as 7th rendering style with halftone textures and limited colors. Add duotone as 10th color palette for dramatic two-color compositions. Update all compatibility matrices and style presets (poster-art, mondo, art-deco, propaganda, cinematic).	2026-03-08 13:07:10 -05:00
Jim Liu 宝玉	adb587439d	feat(baoyu-article-illustrator): add screen-print style and style presets Add screen-print as new style option with poster aesthetic (bold silhouettes, halftone textures, limited colors). Add --preset flag for quick type + style selection (e.g., --preset tech-explainer, --preset opinion-piece).	2026-03-08 13:07:05 -05:00
Jim Liu 宝玉	f6cef6bcbb	chore: release v1.54.1	2026-03-07 16:11:24 -06:00
Jim Liu 宝玉	4300e6899c	fix(baoyu-post-to-x): keep browser open for manual publishing	2026-03-07 16:10:19 -06:00
Jim Liu 宝玉	4435366898	docs: add star history to readmes	2026-03-07 16:07:29 -06:00
Jim Liu 宝玉	69cd89184e	chore: release v1.54.0	2026-03-06 23:40:53 -06:00
Jim Liu 宝玉	5771e6d8c5	feat(baoyu-translate): add external glossary files and frontmatter transformation Support glossary_files in EXTEND.md for loading glossaries from external markdown tables or YAML files. Add frontmatter transformation rules to rename source metadata fields with source prefix during translation.	2026-03-06 23:38:27 -06:00
Jim Liu 宝玉	970f5e741a	feat(baoyu-post-to-wechat): default bottom citations for markdown input Enable bottom citations by default for markdown articles. Add --no-cite flag to all posting scripts (wechat-api, wechat-article, md-to-wechat) to optionally disable. WeChat mp links stay inline.	2026-03-06 23:38:23 -06:00
Jim Liu 宝玉	8cea550627	feat(baoyu-markdown-to-html): add --cite option for bottom citations Add optional --cite flag to convert ordinary external links to numbered bottom citations. WeChat links stay inline. Also translate theme and color descriptions from Chinese to English for consistency.	2026-03-06 23:38:19 -06:00
Jim Liu 宝玉	82029160d1	feat(baoyu-format-markdown): improve title and summary generation quality Add style-differentiated title candidates (subversive, solution, suspense, concrete number), prohibited patterns, hook-first principles, and stronger summary guidelines with concrete detail requirements.	2026-03-06 23:38:15 -06:00
Jim Liu 宝玉	46af919634	chore: release v1.53.0	2026-03-06 21:20:22 -06:00
Jim Liu 宝玉	5560db595a	feat(baoyu-url-to-markdown): add HTML snapshot saving and Defuddle fallback pipeline - Save rendered HTML as sibling -captured.html file alongside markdown - Defuddle-first conversion with automatic fallback to legacy Readability/selector extractor - Add rawHtml, conversionMethod, fallbackReason to ConversionResult - Log converter method and fallback reason in CLI output	2026-03-06 21:18:21 -06:00