baoyu-skills Documentation

File: README.md Copy Chapter

baoyu-skills

English | 中文

Skills shared by Baoyu for improving daily work efficiency with AI Agents (Claude Code, Codex, etc.).

Prerequisites Copy Chapter

• Node.js environment installed
• Ability to run npx bun commands

Installation Copy Chapter

Tip: This repository contains 20+ skills. Install only the ones you actually need — bulk-installing every skill adds unnecessary context overhead for your AI agent on every run.

Quick Install (Recommended) Copy Section

npx skills add jimliu/baoyu-skills

Codex Project-Level Install Copy Section

If you only need a subset of skills in one project, you do not need to install the full plugin. Codex scans .agents/skills inside a project, so copy or symlink each needed skill as a full directory:

/.agents/skills/baoyu-cover-image/SKILL.md
/.agents/skills/baoyu-article-illustrator/SKILL.md
/.agents/skills/baoyu-post-to-wechat/SKILL.md

For a WeChat Official Account article workflow, the usual minimal set is:

• baoyu-cover-image
• baoyu-article-illustrator
• baoyu-post-to-wechat

You do not need to install baoyu-markdown-to-html separately. baoyu-post-to-wechat already includes the Markdown to WeChat-ready HTML conversion flow. Install baoyu-format-markdown only if you need to first turn raw text or drafts into structured Markdown articles with titles, summaries, headings, bold text, lists, and similar formatting.

Place WeChat API credentials according to the scope you want:

• User-level: ~/.baoyu-skills/.env
• Project-level: /.baoyu-skills/.env

Project-level .env files are useful when credentials should apply only to the current project. Do not commit them to Git.

Publish to ClawHub / OpenClaw Copy Section

This repository now supports publishing each skills/baoyu-* directory as an individual ClawHub skill.

# 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:

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 Copy Section

Run the following command in the Agent:

/plugin marketplace add JimLiu/baoyu-skills

Install Skills Copy Section

Option 1: Via Browse UI

1. Select Browse and install plugins
2. Select baoyu-skills
3. Select the baoyu-skills plugin
4. Select Install now

Option 2: Direct Install

# Install the marketplace's single plugin
/plugin install baoyu-skills@baoyu-skills

Option 3: Ask the Agent

Simply tell the Agent:

Please install Skills from github.com/JimLiu/baoyu-skills

Available Plugin Copy Section

The marketplace now exposes a single plugin so each skill is registered exactly once.

Update Skills Copy Chapter

To update skills to the latest version:

1. Run /plugin in the Agent
2. Switch to Marketplaces tab (use arrow keys or Tab)
3. Select baoyu-skills
4. Choose Update marketplace

You can also Enable auto-update to get the latest versions automatically.

Available Skills Copy Chapter

Skills are organized into three categories:

Featured Design Skill: baoyu-design Copy Section

If you want a design-focused Agent Skill, check out JimLiu/baoyu-design. It is a separate project that runs Claude Design locally in Cursor, Claude Code, Codex, Claude Desktop, or any file-capable coding agent, producing polished UI mockups, interactive prototypes, wireframes, landing pages, dashboards, mobile apps, and slide decks as self-contained HTML.

npx skills add JimLiu/baoyu-design

Content Skills Copy Section

Content generation and publishing skills.

baoyu-xhs-images

Xiaohongshu image card series generator. Breaks down content into 1-10 cartoon-style image cards with Style × Layout system and optional palette override.

# Auto-select style and layout
/baoyu-xhs-images posts/ai-future/article.md

# Specify style
/baoyu-xhs-images posts/ai-future/article.md --style notion

# Specify layout
/baoyu-xhs-images posts/ai-future/article.md --layout dense

# Combine style and layout
/baoyu-xhs-images posts/ai-future/article.md --style notion --layout list

# Override palette
/baoyu-xhs-images posts/ai-future/article.md --style notion --palette macaron

# Direct content input
/baoyu-xhs-images 今日星座运势

# Non-interactive (skip all confirmations, for scheduled tasks)
/baoyu-xhs-images posts/ai-future/article.md --yes
/baoyu-xhs-images posts/ai-future/article.md --yes --preset knowledge-card

Styles (visual aesthetics): cute (default), fresh, warm, bold, minimal, retro, pop, notion, chalkboard, study-notes, screen-print, sketch-notes

Palettes (optional color override): macaron, warm, neon

Style Previews:

Layouts (information density):

Layout Previews:

baoyu-infographic

Generate professional infographics with 21 layout types and 21 visual styles. Analyzes content, recommends layout×style combinations, and generates publication-ready infographics.

# Auto-recommend combinations based on content
/baoyu-infographic path/to/content.md

# Specify layout
/baoyu-infographic path/to/content.md --layout pyramid

# Specify style (default: craft-handmade)
/baoyu-infographic path/to/content.md --style technical-schematic

# Specify both
/baoyu-infographic path/to/content.md --layout funnel --style corporate-memphis

# With aspect ratio (named preset or custom W:H)
/baoyu-infographic path/to/content.md --aspect portrait
/baoyu-infographic path/to/content.md --aspect 3:4

Options:

Layouts (information structure):

Layout Previews:

Styles (visual aesthetics):

Style Previews:

baoyu-diagram

Generate publication-ready SVG diagrams from source material — flowcharts, sequence/protocol diagrams, structural/architecture diagrams, and illustrative intuition diagrams. Analyzes input material to recommend diagram type(s) and splitting strategy, confirms the plan once, then generates all diagrams. Claude writes real SVG code directly following a cohesive design system. Output is self-contained .svg files with embedded styles and auto dark-mode.

# Topic string — skill analyzes and proposes a plan
/baoyu-diagram "how JWT authentication works"
/baoyu-diagram "Kubernetes architecture" --type structural
/baoyu-diagram "OAuth 2.0 flow"          --type sequence

# File path — skill reads, analyzes, and proposes a plan
/baoyu-diagram path/to/article.md

# Language and output path
/baoyu-diagram "微服务架构" --lang zh
/baoyu-diagram "build pipeline" --out docs/build-pipeline.svg

Options:

Diagram types:

Not an image-generation skill — no LLM image model is called. Claude writes the SVG by hand with hand-computed layout math, so every diagram honors the design system. Embedded <style> block with @media (prefers-color-scheme: dark) means the same file renders correctly in both light and dark mode anywhere it's embedded.

baoyu-cover-image

Generate cover images for articles with 5 dimensions: Type × Palette × Rendering × Text × Mood. Combines 11 color palettes with 7 rendering styles for 77 unique combinations.

# Auto-select all dimensions based on content
/baoyu-cover-image path/to/article.md

# Quick mode: skip confirmation, use auto-selection
/baoyu-cover-image path/to/article.md --quick

# Specify dimensions (5D system)
/baoyu-cover-image path/to/article.md --type conceptual --palette cool --rendering digital
/baoyu-cover-image path/to/article.md --text title-subtitle --mood bold

# Style presets (backward-compatible shorthand)
/baoyu-cover-image path/to/article.md --style blueprint

# Specify aspect ratio (default: 16:9)
/baoyu-cover-image path/to/article.md --aspect 2.35:1

# Visual only (no title text)
/baoyu-cover-image path/to/article.md --no-title

Five Dimensions:

• Type: hero, conceptual, typography, metaphor, scene, minimal
• Palette: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro, duotone, macaron
• Rendering: flat-vector, hand-drawn, painterly, digital, pixel, chalk, screen-print
• Text: none, title-only (default), title-subtitle, text-rich
• Mood: subtle, balanced (default), bold

baoyu-slide-deck

Generate professional slide deck images from content. Creates comprehensive outlines with style instructions, then generates individual slide images.

# From markdown file
/baoyu-slide-deck path/to/article.md

# With style and audience
/baoyu-slide-deck path/to/article.md --style corporate
/baoyu-slide-deck path/to/article.md --audience executives

# Target slide count
/baoyu-slide-deck path/to/article.md --slides 15

# Outline only (no image generation)
/baoyu-slide-deck path/to/article.md --outline-only

# With language
/baoyu-slide-deck path/to/article.md --lang zh

Options:

Style System:

Styles are built from 4 dimensions: Texture × Mood × Typography × Density

Presets (pre-configured dimension combinations):

Style Previews:

After generation, slides are automatically merged into .pptx and .pdf files for easy sharing.

baoyu-comic

Knowledge comic creator with flexible art style × tone combinations. Creates original educational comics with detailed panel layouts and sequential image generation.

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

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

# Use preset (includes special rules)
/baoyu-comic posts/turing-story/source.md --style ohmsha
/baoyu-comic posts/turing-story/source.md --style wuxia

# Specify layout and aspect ratio
/baoyu-comic posts/turing-story/source.md --layout cinematic
/baoyu-comic posts/turing-story/source.md --aspect 16:9

# Specify language
/baoyu-comic posts/turing-story/source.md --lang zh

# Direct content input
/baoyu-comic "The story of Alan Turing and the birth of computer science"

Options:

Art Styles (rendering technique):

Tones (mood/atmosphere):

Presets (art + tone + special rules):

Layouts (panel arrangement):

Layout Previews:

baoyu-article-illustrator

Smart article illustration skill with Type × Style × Palette three-dimension approach. Analyzes article structure, identifies positions requiring visual aids, and generates illustrations.

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

# Specify type and style
/baoyu-article-illustrator path/to/article.md --type flowchart --style notion

# With palette override
/baoyu-article-illustrator path/to/article.md --style vector-illustration --palette macaron

Types (information structure):

Styles (rendering approach):

Palettes (optional color override):

Style Previews:

baoyu-post-to-x

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.

# Post with text
/baoyu-post-to-x "Hello from AI Agent!"

# Post with images
/baoyu-post-to-x "Check this out" --image photo.png

# Post X Article
/baoyu-post-to-x --article path/to/article.md

baoyu-post-to-wechat

Post content to WeChat Official Account (微信公众号). Two modes available:

Image-Text (贴图) - Multiple images with short title/content:

/baoyu-post-to-wechat 贴图 --markdown article.md --images ./photos/
/baoyu-post-to-wechat 贴图 --markdown article.md --image img1.png --image img2.png --image img3.png
/baoyu-post-to-wechat 贴图 --title "标题" --content "内容" --image img1.png --submit

Article (文章) - Full markdown/HTML with rich formatting:

/baoyu-post-to-wechat 文章 --markdown article.md
/baoyu-post-to-wechat 文章 --markdown article.md --theme grace
/baoyu-post-to-wechat 文章 --html article.html

Publishing Methods:

API Configuration (for faster publishing):

# Add to .baoyu-skills/.env (project-level) or ~/.baoyu-skills/.env (user-level)
WECHAT_APP_ID=your_app_id
WECHAT_APP_SECRET=your_app_secret

To obtain credentials:

1. Visit https://developers.weixin.qq.com/platform/
2. Go to: 我的业务 → 公众号 → 开发密钥
3. Create development key and copy AppID/AppSecret
4. Add your machine's IP to the whitelist

Browser Method (no API setup needed): Requires Google Chrome. First run opens browser for QR code login (session preserved).

Remote API Method (for when WeChat's IP allowlist excludes your local machine): tunnels WeChat API calls through an SSH SOCKS5 dynamic port forward to a server whose IP is on the allowlist. No files are written to the remote host and AppSecret never leaves the local process. Add to your EXTEND.md:

# Optional: only set when WeChat's IP allowlist excludes your local machine
remote_publish_host: server.example.com
remote_publish_user: deploy
remote_publish_identity_file: ~/.ssh/id_ed25519

Then publish with --remote (or set default_publish_method: remote-api). Authentication is SSH key only; only the typed remote_publish_* keys are honored.

Multi-Account Support: Manage multiple WeChat Official Accounts via EXTEND.md:

mkdir -p .baoyu-skills/baoyu-post-to-wechat

Create .baoyu-skills/baoyu-post-to-wechat/EXTEND.md:

# Global settings (shared across all accounts)
default_theme: default
default_color: blue

# Account list
accounts:
  - name: My Tech Blog
    alias: tech-blog
    default: false
    default_publish_method: api
    default_author: Author Name
    need_open_comment: 1
    only_fans_can_comment: 0
    app_id: your_wechat_app_id
    app_secret: your_wechat_app_secret
  - name: AI Newsletter
    alias: ai-news
    default_publish_method: browser
    default_author: AI Newsletter
    need_open_comment: 1
    only_fans_can_comment: 0

Each account gets an isolated Chrome profile for independent login sessions (browser method). API credentials can be set inline in EXTEND.md or via .env with alias-prefixed keys (e.g., WECHAT_TECH_BLOG_APP_ID).

baoyu-post-to-weibo

Post content to Weibo (微博). Supports regular posts with text, images, and videos, and headline articles (头条文章) with Markdown input. Uses real Chrome with CDP to bypass anti-automation.

Regular Posts - Text + images/videos (max 18 files):

# Post with text
/baoyu-post-to-weibo "Hello Weibo!"

# Post with images
/baoyu-post-to-weibo "Check this out" --image photo.png

# Post with video
/baoyu-post-to-weibo "Watch this" --video clip.mp4

Headline Articles (头条文章) - Long-form Markdown:

# Publish article
/baoyu-post-to-weibo --article article.md

# With cover image
/baoyu-post-to-weibo --article article.md --cover cover.jpg

Article Options:

Note: Scripts fill content into the browser. User reviews and publishes manually. First run requires manual Weibo login (session persists).

AI Generation Skills Copy Section

AI-powered generation backends.

baoyu-image-gen

AI SDK-based image generation using OpenAI GPT Image 2, Azure OpenAI, Google, OpenRouter, DashScope (Aliyun Tongyi Wanxiang), MiniMax, Jimeng (即梦), Seedream (豆包), and Replicate APIs. Supports text-to-image, reference images, aspect ratios, custom sizes, batch generation, and quality presets.

/* Detailed source-code truncated for AI context efficiency. */

Options:

Environment Variables (see Environment Configuration for setup):

Provider Notes:

• Azure OpenAI: --model means Azure deployment name, not the underlying model family.
• DashScope: qwen-image-2.0-pro is the recommended default for custom --size, 21:9, and strong Chinese/English text rendering.
• Z.AI: glm-image is recommended for posters, diagrams, and text-heavy Chinese/English images. Reference images are not supported.
• MiniMax: image-01 supports documented custom width / height; image-01-live is lower latency and works best with --ar.
• MiniMax reference images are sent as subject_reference; the current API is specialized toward character / portrait consistency.
• Jimeng does not support reference images.
• Seedream reference images are supported by Seedream 5.0 / 4.5 / 4.0, not Seedream 3.0.
• Replicate defaults to google/nano-banana-2. baoyu-image-gen only enables Replicate advanced options for google/nano-banana*, bytedance/seedream-4.5, bytedance/seedream-5-lite, wan-video/wan-2.7-image, and wan-video/wan-2.7-image-pro.
• Replicate currently saves exactly one output image per request. --n > 1 is blocked locally instead of silently dropping extra results.
• Replicate model behavior is family-specific: nano-banana uses --quality / --ar, Seedream uses validated --size / --ar, and Wan uses validated --size (with --ar converted locally to a concrete size).

Provider Auto-Selection:

1. If --provider is specified → use it
2. If --ref is provided and no provider is specified → try Google, then OpenAI, Azure, OpenRouter, Replicate, Seedream, MiniMax, and finally Agnes
3. If only one API key is available → use that provider
4. If multiple providers are available → default to Google, then OpenAI, Azure, OpenRouter, DashScope, Z.AI, MiniMax, Replicate, Jimeng, Seedream, Agnes

baoyu-danger-gemini-web

Interacts with Gemini Web to generate text and images.

Text Generation:

/baoyu-danger-gemini-web "Hello, Gemini"
/baoyu-danger-gemini-web --prompt "Explain quantum computing"

Image Generation:

/baoyu-danger-gemini-web --prompt "A cute cat" --image cat.png
/baoyu-danger-gemini-web --promptfiles system.md content.md --image out.png

Utility Skills Copy Section

Utility tools for content processing.

baoyu-youtube-transcript

Download YouTube video transcripts/subtitles and cover images. Supports multiple languages, translation, chapters, and speaker identification. Caches raw data for fast re-formatting.

# Default: markdown with timestamps
/baoyu-youtube-transcript https://www.youtube.com/watch?v=VIDEO_ID

# Specify languages (priority order)
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --languages zh,en,ja

# With chapters and speaker identification
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --chapters --speakers

# SRT subtitle format
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --format srt

# List available transcripts
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --list

Options:

baoyu-url-to-markdown

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.

# Auto mode (default) - capture when page loads
/baoyu-url-to-markdown https://example.com/article

# Wait mode - for login-required pages
/baoyu-url-to-markdown https://example.com/private --wait

# Save to specific file
/baoyu-url-to-markdown https://example.com/article -o output.md

Capture Modes:

Options:

baoyu-danger-x-to-markdown

Converts X (Twitter) content to markdown format. Supports tweet threads and X Articles.

# Convert tweet to markdown
/baoyu-danger-x-to-markdown https://x.com/username/status/123456

# Save to specific file
/baoyu-danger-x-to-markdown https://x.com/username/status/123456 -o output.md

# JSON output
/baoyu-danger-x-to-markdown https://x.com/username/status/123456 --json

# Download media (images/videos) to local files
/baoyu-danger-x-to-markdown https://x.com/username/status/123456 --download-media

Supported URLs:

• https://x.com//status/
• https://twitter.com//status/
• https://x.com/i/article/

Authentication: Uses environment variables (X_AUTH_TOKEN, X_CT0) or Chrome login for cookie-based auth.

baoyu-compress-image

Compress images to reduce file size while maintaining quality.

/baoyu-compress-image path/to/image.png
/baoyu-compress-image path/to/images/ --quality 80

baoyu-format-markdown

Format plain text or markdown files with proper frontmatter, titles, summaries, headings, bold, lists, and code blocks.

# Format a markdown file
/baoyu-format-markdown path/to/article.md

# Format with specific output
/baoyu-format-markdown path/to/draft.md

Workflow:

1. Read source file and analyze content structure
2. Check/create YAML frontmatter (title, slug, summary, coverImage)
3. Handle title: use existing, extract from H1, or generate candidates
4. Apply formatting: headings, bold, lists, code blocks, quotes
5. Save to {filename}-formatted.md
6. Run typography script: ASCII→fullwidth quotes, CJK spacing, autocorrect

Frontmatter Fields:

Formatting Rules:

baoyu-markdown-to-html

Convert markdown files into styled HTML with WeChat-compatible themes, syntax highlighting, and optional bottom citations for external links.

# Basic conversion
/baoyu-markdown-to-html article.md

# Theme + color
/baoyu-markdown-to-html article.md --theme grace --color red

# Convert ordinary external links to bottom citations
/baoyu-markdown-to-html article.md --cite

baoyu-translate

Translate articles and documents between languages with three modes: quick (direct), normal (analysis-informed), and refined (full publication-quality workflow with review and polish).

# Normal mode (default) - analyze then translate
/translate article.md --to zh-CN

# Quick mode - direct translation
/translate article.md --mode quick --to ja

# Refined mode - full workflow with review and polish
/translate article.md --mode refined --to zh-CN

# Translate a URL
/translate https://example.com/article --to zh-CN

# Specify audience
/translate article.md --to zh-CN --audience technical

# Specify style
/translate article.md --to zh-CN --style humorous

# With additional glossary
/translate article.md --to zh-CN --glossary my-terms.md

Options:

Modes:

After normal mode completes, you can reply "继续润色" or "refine" to continue with review and polish steps.

Audience Presets:

Custom audience descriptions are also accepted, e.g., --audience "AI-interested general readers".

Style Presets:

Custom style descriptions are also accepted, e.g., --style "poetic and lyrical".

Features:

• Custom glossaries via EXTEND.md with built-in EN→ZH glossary
• Audience-aware translation with adjustable annotation depth
• Automatic chunking for long documents (4000+ words) with parallel subagent translation
• Figurative language interpreted by meaning, not word-for-word
• Translator's notes for cultural/domain-specific references
• Output directory with all intermediate files preserved

baoyu-wechat-summary

Summarize WeChat group chat highlights into a structured digest. Extracts topics, quotes, and stats from group messages using wx-cli. Maintains per-group history, per-user profiles, and per-group fact memory across runs. Supports normal and roast (毒舌) versions, and answers @bot questions raised in the chat.

# Summarize a group's recent messages
/baoyu-wechat-summary 相亲相爱一家人 最近 1 天

# Weekly summary
/baoyu-wechat-summary AI 技术群 最近 7 天

# Incremental (since last digest)
/baoyu-wechat-summary 相亲相爱一家人

# Roast version
/baoyu-wechat-summary 相亲相爱一家人 最近 3 天 毒舌版

Requirements:

• wx-cli installed (npm install @jackwener/wx-cli)
• WeChat 4.x running and logged in on macOS

Features:

• Topic extraction with attribution and quotes
• Message leaderboard and per-user profiles
• Per-group fact memory: corrections confirmed in chat persist across digests (with injection guardrails)
• Incremental mode (picks up where last digest left off)
• Multi-day range splitting for large batches
• Normal and roast (毒舌) digest versions
• Profile backfill from historical digests

baoyu-electron-extract

Extract resources and JavaScript from any installed Electron app's app.asar. When .js.map files embed sourcesContent, restores the original source tree (TypeScript/JSX included); otherwise formats the minified JS/CSS with Prettier in place. Always skips node_modules. Works on macOS and Windows; pass --asar on other platforms.

# Extract by app name (default output: ~/Downloads/Codex-electron-extract/)
/baoyu-electron-extract Codex

# Extract by absolute path (.app bundle, install dir, or .asar file)
/baoyu-electron-extract "/Applications/Visual Studio Code.app"
/baoyu-electron-extract --asar /Applications/Codex.app/Contents/Resources/app.asar Codex

# Custom output directory
/baoyu-electron-extract Codex --output ~/work/codex-source

# Preview discovery without writing anything
/baoyu-electron-extract Codex --dry-run

# Overwrite an existing output directory
/baoyu-electron-extract Codex --force

Options:

Output layout: extract-report.json (counts, warnings, paths), extracted/ (raw asar, formatted in place when no map), extracted.unpacked/ (native modules if present), and restored/ (rebuilt source tree from .js.map files).

Environment Configuration Copy Chapter

Some skills require API keys or custom configuration. Environment variables can be set in .env files:

Load Priority (higher priority overrides lower):

1. CLI environment variables (e.g., OPENAI_API_KEY=xxx /baoyu-image-gen ...)
2. process.env (system environment)
3. <cwd>/.baoyu-skills/.env (project-level)
4. ~/.baoyu-skills/.env (user-level)

Setup:

# Create user-level config directory
mkdir -p ~/.baoyu-skills

# Create .env file
cat > ~/.baoyu-skills/.env << 'EOF'
# OpenAI
OPENAI_API_KEY=sk-xxx
OPENAI_IMAGE_MODEL=gpt-image-2
# OPENAI_BASE_URL=https://api.openai.com/v1
# OPENAI_IMAGE_USE_CHAT=false

# Azure OpenAI
AZURE_OPENAI_API_KEY=xxx
AZURE_OPENAI_BASE_URL=https://your-resource.openai.azure.com
AZURE_OPENAI_DEPLOYMENT=gpt-image-2
# AZURE_API_VERSION=2025-04-01-preview

# OpenRouter
OPENROUTER_API_KEY=sk-or-xxx
OPENROUTER_IMAGE_MODEL=google/gemini-3.1-flash-image
# OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
# OPENROUTER_HTTP_REFERER=https://your-app.example.com
# OPENROUTER_TITLE=Your App Name

# Google
GOOGLE_API_KEY=xxx
GOOGLE_IMAGE_MODEL=gemini-3-pro-image
# GOOGLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta

# DashScope (Aliyun Tongyi Wanxiang)
DASHSCOPE_API_KEY=sk-xxx
DASHSCOPE_IMAGE_MODEL=qwen-image-2.0-pro
# DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1

# Z.AI
ZAI_API_KEY=xxx
ZAI_IMAGE_MODEL=glm-image
# ZAI_BASE_URL=https://api.z.ai/api/paas/v4

# MiniMax
MINIMAX_API_KEY=xxx
MINIMAX_IMAGE_MODEL=image-01
# MINIMAX_BASE_URL=https://api.minimaxi.com

# Replicate
REPLICATE_API_TOKEN=r8_xxx
REPLICATE_IMAGE_MODEL=google/nano-banana-2
# REPLICATE_BASE_URL=https://api.replicate.com

# Jimeng (即梦)
JIMENG_ACCESS_KEY_ID=xxx
JIMENG_SECRET_ACCESS_KEY=xxx
JIMENG_IMAGE_MODEL=jimeng_t2i_v40
# JIMENG_BASE_URL=https://visual.volcengineapi.com
# JIMENG_REGION=cn-north-1

# Seedream (豆包)
ARK_API_KEY=xxx
SEEDREAM_IMAGE_MODEL=doubao-seedream-5-0-260128
# SEEDREAM_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
EOF

Project-level config (for team sharing):

mkdir -p .baoyu-skills
# Add .baoyu-skills/.env to .gitignore to avoid committing secrets
echo ".baoyu-skills/.env" >> .gitignore

Customization Copy Chapter

All skills support customization via EXTEND.md files. Create an extension file to override default styles, add custom configurations, or define your own presets.

Extension paths (checked in priority order):

1. .baoyu-skills/<skill-name>/EXTEND.md - Project-level (for team/project-specific settings)
2. ~/.baoyu-skills/<skill-name>/EXTEND.md - User-level (for personal preferences)

Example: To customize baoyu-cover-image with your brand colors:

mkdir -p .baoyu-skills/baoyu-cover-image

Then create .baoyu-skills/baoyu-cover-image/EXTEND.md:

## Custom Palettes

### corporate-tech
- Primary colors: #1a73e8, #4A90D9
- Background: #F5F7FA
- Accent colors: #00B4D8, #48CAE4
- Decorative hints: Clean lines, subtle gradients
- Best for: SaaS, enterprise, technical

The extension content will be loaded before skill execution and override defaults.

Disclaimer Copy Chapter

baoyu-danger-gemini-web Copy Section

This skill uses the Gemini Web API (reverse-engineered).

Warning: This project uses unofficial API access via browser cookies. Use at your own risk.

• First run opens a browser to authenticate with Google
• Cookies are cached for subsequent runs
• No guarantees on API stability or availability

Supported browsers (auto-detected): Google Chrome, Chrome Canary/Beta, Chromium, Microsoft Edge

Proxy configuration: If you need a proxy to access Google services (e.g., in China), set environment variables inline:

HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 /baoyu-danger-gemini-web "Hello"

baoyu-danger-x-to-markdown Copy Section

This skill uses a reverse-engineered X (Twitter) API.

Warning: This is NOT an official API. Use at your own risk.

• May break without notice if X changes their API
• Account restrictions possible if API usage detected
• First use requires consent acknowledgment
• Authentication via environment variables or Chrome login

Credits Copy Chapter

This project was inspired by and builds upon the following open source projects:

• x-article-publisher-skill by @wshuyi — Inspiration for the X article publishing skill
• doocs/md by @doocs — Core implementation logic for Markdown to HTML conversion
• High-density Infographic Prompt by AJ@WaytoAGI — Inspiration for the infographic skill
• qiaomu-mondo-poster-design by @joeseesun（乔木） — Inspiration for the Mondo style
• architecture-diagram-generator by @Cocoon-AI — Inspiration for the diagram skill's design system

License Copy Chapter

Unless otherwise noted, this repository is licensed under the MIT License.

Published ClawHub skills follow ClawHub registry rules and are distributed under MIT-0. Third-party code and assets retain their original licenses where noted.

Star History Copy Chapter

File: README.zh.md Copy Chapter

baoyu-skills

English | 中文

宝玉分享的 AI Agent 技能集（适用于 Claude Code、Codex 等），提升日常工作效率。

作者的图书 Copy Chapter

作者的图书《图解 Skill —— AI 提效实战指南》系统讲解如何设计、编写、安装和迭代 Skill，并配有完整示例、提示词、插图生成工作流和章节配套资源。

• 官方配套仓库：JimLiu/Illustrated-Agent-Skills
• 购买链接：京东购买
• 电子书购买链接：https://www.ituring.com.cn/book/3616

前置要求 Copy Chapter

• 已安装 Node.js 环境
• 能够运行 npx bun 命令

安装 Copy Chapter

提示：本仓库已收录 20+ 个 skill，请按需安装你真正会用到的那几个，不要一次性全装 —— 每个加载的 skill 都会在 Agent 每次运行时占用额外上下文。

快速安装（推荐） Copy Section

npx skills add jimliu/baoyu-skills

Codex 项目级安装 Copy Section

如果只在某个项目中使用部分技能，不需要安装整个插件。Codex 会扫描项目里的 .agents/skills，可以只把需要的 skill 按整个目录复制或软链接到当前项目：

/.agents/skills/baoyu-cover-image/SKILL.md
/.agents/skills/baoyu-article-illustrator/SKILL.md
/.agents/skills/baoyu-post-to-wechat/SKILL.md

公众号文章发布的最小组合通常是：

• baoyu-cover-image
• baoyu-article-illustrator
• baoyu-post-to-wechat

不需要单独安装 baoyu-markdown-to-html，baoyu-post-to-wechat 已内置 Markdown 到公众号可用 HTML 的转换流程。只有需要先把原始文本或草稿整理成 Markdown 文章结构（标题、摘要、层级标题、加粗、列表等）时，再额外安装 baoyu-format-markdown。

公众号 API 凭证按作用范围放置：

• 全局：~/.baoyu-skills/.env
• 项目：/.baoyu-skills/.env

项目级 .env 适合只给当前项目使用，注意不要提交到 Git。

发布到 ClawHub / OpenClaw Copy Section

现在这个仓库支持把每个 skills/baoyu-* 目录作为独立 ClawHub skill 发布。

# 预览将要发布的变更
./scripts/sync-clawhub.sh --dry-run

# 发布 ./skills 下所有已变更的 skill
./scripts/sync-clawhub.sh --all

ClawHub 按“单个 skill”安装，不是把整个 marketplace 一次性装进去。发布后，用户可以按需安装：

clawhub install baoyu-image-gen
clawhub install baoyu-markdown-to-html

根据 ClawHub 的 registry 规则，发布到 ClawHub 的 skill 会以 MIT-0 许可分发。

注册插件市场 Copy Section

在 Agent 中运行：

/plugin marketplace add JimLiu/baoyu-skills

安装技能 Copy Section

方式一：通过浏览界面

1. 选择 Browse and install plugins
2. 选择 baoyu-skills
3. 选择 baoyu-skills 插件
4. 选择 Install now

方式二：直接安装

# 安装 marketplace 中唯一的插件
/plugin install baoyu-skills@baoyu-skills

方式三：告诉 Agent

直接告诉 Agent：

请帮我安装 github.com/JimLiu/baoyu-skills 中的 Skills

可用插件 Copy Section

现在 marketplace 只暴露一个插件，这样每个 skill 只会注册一次。

更新技能 Copy Chapter

更新技能到最新版本：

1. 在 Agent 中运行 /plugin
2. 切换到 Marketplaces 标签页（使用方向键或 Tab）
3. 选择 baoyu-skills
4. 选择 Update marketplace

也可以选择 Enable auto-update 启用自动更新，每次启动时自动获取最新版本。

可用技能 Copy Chapter

技能分为三大类：

设计技能推荐：baoyu-design Copy Section

如果你想让本地 Agent 直接做设计，可以试试 JimLiu/baoyu-design。这是一个独立项目，它把 Claude Design 打包成可移植的 Agent Skill，可在 Cursor、Claude Code、Codex、Claude Desktop 或其他能读写文件的编码 Agent 中运行，用来生成精致 UI 稿、可交互原型、线框图、落地页、仪表盘、移动 App 和幻灯片，产物都是自包含 HTML，留在你自己的仓库里。

npx skills add JimLiu/baoyu-design

内容技能 (Content Skills) Copy Section

内容生成和发布技能。

baoyu-xhs-images

小红书图片卡片系列生成器。将内容拆解为 1-10 张卡通风格图片卡片，支持 风格 × 布局 系统和可选配色覆盖。

# 自动选择风格和布局
/baoyu-xhs-images posts/ai-future/article.md

# 指定风格
/baoyu-xhs-images posts/ai-future/article.md --style notion

# 指定布局
/baoyu-xhs-images posts/ai-future/article.md --layout dense

# 组合风格和布局
/baoyu-xhs-images posts/ai-future/article.md --style notion --layout list

# 覆盖配色
/baoyu-xhs-images posts/ai-future/article.md --style notion --palette macaron

# 直接输入内容
/baoyu-xhs-images 今日星座运势

# 非交互模式（跳过所有确认，适用于定时任务）
/baoyu-xhs-images posts/ai-future/article.md --yes
/baoyu-xhs-images posts/ai-future/article.md --yes --preset knowledge-card

风格（视觉美学）：cute（默认）、fresh、warm、bold、minimal、retro、pop、notion、chalkboard、study-notes、screen-print、sketch-notes

配色（可选颜色覆盖）：macaron、warm、neon

风格预览：

布局（信息密度）：

布局预览：

baoyu-infographic

专业信息图生成器，支持 21 种布局和 21 种视觉风格。分析内容后推荐布局×风格组合，生成可发布的信息图。

# 根据内容自动推荐组合
/baoyu-infographic path/to/content.md

# 指定布局
/baoyu-infographic path/to/content.md --layout pyramid

# 指定风格（默认：craft-handmade）
/baoyu-infographic path/to/content.md --style technical-schematic

# 同时指定布局和风格
/baoyu-infographic path/to/content.md --layout funnel --style corporate-memphis

# 指定比例（预设名称或自定义 W:H）
/baoyu-infographic path/to/content.md --aspect portrait
/baoyu-infographic path/to/content.md --aspect 3:4

选项：

布局（信息结构）：

布局预览：

风格（视觉美学）：

风格预览：

baoyu-diagram

从源素材生成可直接发布的 SVG 图表 —— 包括流程图、时序/协议图、架构/结构图、示意图（直觉图解）。分析输入素材，推荐图表类型和拆分策略，一次确认后批量生成。Claude 直接输出符合统一设计规范的真实 SVG 代码，产物是自包含的 .svg 文件，内嵌样式并自动支持深色模式。

# 主题描述 —— 技能分析并提出方案
/baoyu-diagram "JWT 认证流程是怎么工作的"
/baoyu-diagram "Kubernetes 架构" --type structural
/baoyu-diagram "OAuth 2.0 流程"  --type sequence

# 文件路径 —— 技能读取、分析并提出方案
/baoyu-diagram path/to/article.md

# 语言和输出路径
/baoyu-diagram "微服务架构" --lang zh
/baoyu-diagram "build pipeline" --out docs/build-pipeline.svg

参数：

五种图表类型：

本技能不调用任何图像生成模型 —— Claude 通过手算坐标直接写 SVG 代码，确保每个图表都遵守设计规范。内嵌的 <style> 块包含 @media (prefers-color-scheme: dark)，同一个文件在浅色和深色模式下均正确渲染，可嵌入到任意支持 SVG 的宿主环境中。

baoyu-cover-image

为文章生成封面图，支持五维定制系统：类型 × 配色 × 渲染 × 文字 × 氛围。11 种配色方案与 7 种渲染风格组合，提供 77 种独特效果。

# 根据内容自动选择所有维度
/baoyu-cover-image path/to/article.md

# 快速模式：跳过确认，使用自动选择
/baoyu-cover-image path/to/article.md --quick

# 指定维度（5D 系统）
/baoyu-cover-image path/to/article.md --type conceptual --palette cool --rendering digital
/baoyu-cover-image path/to/article.md --text title-subtitle --mood bold

# 风格预设（向后兼容的简写方式）
/baoyu-cover-image path/to/article.md --style blueprint

# 指定宽高比（默认：16:9）
/baoyu-cover-image path/to/article.md --aspect 2.35:1

# 纯视觉（不含标题文字）
/baoyu-cover-image path/to/article.md --no-title

五个维度：

• 类型 (Type)：hero、conceptual、typography、metaphor、scene、minimal
• 配色 (Palette)：warm、elegant、cool、dark、earth、vivid、pastel、mono、retro、duotone、macaron
• 渲染 (Rendering)：flat-vector、hand-drawn、painterly、digital、pixel、chalk、screen-print
• 文字 (Text)：none、title-only（默认）、title-subtitle、text-rich
• 氛围 (Mood)：subtle、balanced（默认）、bold

baoyu-slide-deck

从内容生成专业的幻灯片图片。先创建包含样式说明的完整大纲，然后逐页生成幻灯片图片。

# 从 markdown 文件生成
/baoyu-slide-deck path/to/article.md

# 指定风格和受众
/baoyu-slide-deck path/to/article.md --style corporate
/baoyu-slide-deck path/to/article.md --audience executives

# 指定页数
/baoyu-slide-deck path/to/article.md --slides 15

# 仅生成大纲（不生成图片）
/baoyu-slide-deck path/to/article.md --outline-only

# 指定语言
/baoyu-slide-deck path/to/article.md --lang zh

选项：

风格系统：

风格由 4 个维度组合而成：纹理 × 氛围 × 字体 × 密度

预设（预配置的维度组合）：

风格预览：

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

baoyu-comic

知识漫画创作器，支持画风 × 基调灵活组合。创作带有详细分镜布局的原创教育漫画，逐页生成图片。

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

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

# 使用预设（包含特殊规则）
/baoyu-comic posts/turing-story/source.md --style ohmsha
/baoyu-comic posts/turing-story/source.md --style wuxia

# 指定布局和比例
/baoyu-comic posts/turing-story/source.md --layout cinematic
/baoyu-comic posts/turing-story/source.md --aspect 16:9

# 指定语言
/baoyu-comic posts/turing-story/source.md --lang zh

# 直接输入内容
/baoyu-comic "图灵的故事与计算机科学的诞生"

选项：

画风（渲染技法）：

基调（氛围/情绪）：

预设（画风 + 基调 + 特殊规则）：

布局（分镜排列）：

布局预览：

baoyu-article-illustrator

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

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

# 组合类型和风格
/baoyu-article-illustrator path/to/article.md --type flowchart --style notion

# 使用色板覆盖
/baoyu-article-illustrator path/to/article.md --style vector-illustration --palette macaron

类型（信息结构）：

风格（渲染手法）：

色板（可选配色覆盖）：

风格预览：

baoyu-post-to-x

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

纯文本输入默认按普通帖子处理，Markdown 文件默认按 X 文章处理。脚本会将内容填入浏览器，用户需手动检查并发布。

# 发布文字
/baoyu-post-to-x "Hello from AI Agent!"

# 发布带图片
/baoyu-post-to-x "看看这个" --image photo.png

# 发布 X 文章
/baoyu-post-to-x --article path/to/article.md

baoyu-post-to-wechat

发布内容到微信公众号，支持两种模式：

贴图模式 - 多图配短标题和正文：

/baoyu-post-to-wechat 贴图 --markdown article.md --images ./photos/
/baoyu-post-to-wechat 贴图 --markdown article.md --image img1.png --image img2.png --image img3.png
/baoyu-post-to-wechat 贴图 --title "标题" --content "内容" --image img1.png --submit

文章模式 - 完整 markdown/HTML 富文本格式：

/baoyu-post-to-wechat 文章 --markdown article.md
/baoyu-post-to-wechat 文章 --markdown article.md --theme grace
/baoyu-post-to-wechat 文章 --html article.html

发布方式：

API 配置（更快的发布方式）：

# 添加到 .baoyu-skills/.env（项目级）或 ~/.baoyu-skills/.env（用户级）
WECHAT_APP_ID=你的AppID
WECHAT_APP_SECRET=你的AppSecret

获取凭证方法：

1. 访问 https://developers.weixin.qq.com/platform/
2. 进入：我的业务 → 公众号 → 开发密钥
3. 添加开发密钥，复制 AppID 和 AppSecret
4. 将你操作的机器 IP 加入白名单

浏览器方式（无需 API 配置）：需已安装 Google Chrome，首次运行需扫码登录（登录状态会保存）

远程 API 方式（适用于本机 IP 不在公众号白名单内的情况）：通过 SSH SOCKS5 动态端口转发，将对 api.weixin.qq.com 的 HTTPS 调用转发到 IP 在白名单内的服务器上。Markdown 渲染、图片处理、草稿组装仍在本地完成；远端不会落任何文件，AppSecret 不会离开本地进程。仅支持 SSH 密钥认证，且只接受类型化的 remote_publish_* 配置项，不透传任意 ssh 选项。在 EXTEND.md 中配置 remote_publish_host 等字段后，发布时加上 --remote（或将 default_publish_method 设为 remote-api）。

多账号支持：通过 EXTEND.md 管理多个微信公众号：

mkdir -p .baoyu-skills/baoyu-post-to-wechat

创建 .baoyu-skills/baoyu-post-to-wechat/EXTEND.md：

# 全局设置（所有账号共享）
default_theme: default
default_color: blue

# 账号列表
accounts:
  - name: 宝玉的技术分享
    alias: baoyu
    default: false
    default_publish_method: api
    default_author: 宝玉
    need_open_comment: 1
    only_fans_can_comment: 0
    app_id: 你的微信 AppID
    app_secret: 你的微信 AppSecret
  - name: AI 工具集
    alias: ai-tools
    default_publish_method: browser
    default_author: AI 工具集
    need_open_comment: 1
    only_fans_can_comment: 0

每个账号拥有独立的 Chrome 配置目录，保证浏览器方式下的登录会话互不干扰。API 凭证可在 EXTEND.md 中直接配置，也可通过 .env 文件使用别名前缀的环境变量（如 WECHAT_BAOYU_APP_ID）。

baoyu-post-to-weibo

发布内容到微博。支持文字、图片、视频发布和头条文章（长篇 Markdown）。使用真实 Chrome + CDP 绕过反自动化检测。

普通微博 - 文字 + 图片/视频（最多 18 个文件）：

# 发布文字
/baoyu-post-to-weibo "Hello Weibo!"

# 发布带图片
/baoyu-post-to-weibo "看看这个" --image photo.png

# 发布带视频
/baoyu-post-to-weibo "看这个" --video clip.mp4

头条文章 - 长篇 Markdown 文章：

# 发布文章
/baoyu-post-to-weibo --article article.md

# 带封面图
/baoyu-post-to-weibo --article article.md --cover cover.jpg

文章选项：

说明：脚本会将内容填入浏览器，用户需手动检查并发布。首次运行需手动登录微博（登录状态会保存）。

AI 生成技能 (AI Generation Skills) Copy Section

AI 驱动的生成后端。

baoyu-image-gen

基于 AI SDK 的图像生成，支持 OpenAI GPT Image 2、Azure OpenAI、Google、OpenRouter、DashScope（阿里通义万相）、MiniMax、即梦（Jimeng）、豆包（Seedream）和 Replicate API。支持文生图、参考图、宽高比、自定义尺寸、批量生成和质量预设。

/* Detailed source-code truncated for AI context efficiency. */

选项：

环境变量（配置方法见环境配置）：

Provider 说明：

• Azure OpenAI：--model 表示 Azure deployment name，不是底层模型家族名。
• DashScope：qwen-image-2.0-pro 是自定义 --size、21:9 和中英文排版的推荐默认模型。
• Z.AI：glm-image 适合海报、图表和中英文排版密集的图片生成，暂不支持参考图。
• MiniMax：image-01 支持官方文档里的自定义 width / height；image-01-live 更偏低延迟，适合配合 --ar 使用。
• MiniMax 参考图会走 subject_reference，当前能力更偏角色 / 人像一致性。
• 即梦不支持参考图。
• 豆包参考图能力仅适用于 Seedream 5.0 / 4.5 / 4.0，不适用于 Seedream 3.0。
• Replicate 默认模型改为 google/nano-banana-2。baoyu-image-gen 目前只对 google/nano-banana*、bytedance/seedream-4.5、bytedance/seedream-5-lite、wan-video/wan-2.7-image 和 wan-video/wan-2.7-image-pro 开启本地能力识别与校验。
• Replicate 当前只保存单张输出图，--n > 1 会在本地直接报错，避免多图结果被静默丢弃。
• Replicate 的参数能力按模型家族区分：nano-banana 走 --quality / --ar，Seedream 走校验后的 --size / --ar，Wan 走校验后的 --size（--ar 会先在本地换算成具体尺寸）。

服务商自动选择：

1. 如果指定了 --provider → 使用指定的
2. 如果传了 --ref 且未指定 provider → 依次尝试 Google、OpenAI、Azure、OpenRouter、Replicate、Seedream、MiniMax，最后是 Agnes
3. 如果只有一个 API 密钥 → 使用对应服务商
4. 如果多个可用 → 默认使用 Google，然后依次为 OpenAI、Azure、OpenRouter、DashScope、Z.AI、MiniMax、Replicate、即梦、豆包、Agnes

baoyu-danger-gemini-web

与 Gemini Web 交互，生成文本和图片。

文本生成：

/baoyu-danger-gemini-web "你好，Gemini"
/baoyu-danger-gemini-web --prompt "解释量子计算"

图片生成：

/baoyu-danger-gemini-web --prompt "一只可爱的猫" --image cat.png
/baoyu-danger-gemini-web --promptfiles system.md content.md --image out.png

工具技能 (Utility Skills) Copy Section

内容处理工具。

baoyu-youtube-transcript

下载 YouTube 视频字幕/转录文本和封面图片。支持多语言、翻译、章节分段和说话人识别。缓存原始数据以便快速重新格式化。

# 默认：带时间戳的 Markdown
/baoyu-youtube-transcript https://www.youtube.com/watch?v=VIDEO_ID

# 指定语言（按优先级排列）
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --languages zh,en,ja

# 章节分段 + 说话人识别
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --chapters --speakers

# SRT 字幕格式
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --format srt

# 列出可用字幕
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --list

选项：

baoyu-url-to-markdown

通过 Chrome CDP 抓取任意 URL 并转换为 Markdown。同时保存渲染后的 HTML 快照，Defuddle 失败时自动回退到旧版提取器。

# 自动模式（默认）- 页面加载后立即抓取
/baoyu-url-to-markdown https://example.com/article

# 等待模式 - 适用于需要登录的页面
/baoyu-url-to-markdown https://example.com/private --wait

# 保存到指定文件
/baoyu-url-to-markdown https://example.com/article -o output.md

抓取模式：

选项：

baoyu-danger-x-to-markdown

将 X (Twitter) 内容转换为 markdown 格式。支持推文串和 X 文章。

# 将推文转换为 markdown
/baoyu-danger-x-to-markdown https://x.com/username/status/123456

# 保存到指定文件
/baoyu-danger-x-to-markdown https://x.com/username/status/123456 -o output.md

# JSON 输出
/baoyu-danger-x-to-markdown https://x.com/username/status/123456 --json

# 下载媒体文件（图片/视频）到本地
/baoyu-danger-x-to-markdown https://x.com/username/status/123456 --download-media

支持的 URL：

• https://x.com//status/
• https://twitter.com//status/
• https://x.com/i/article/

身份验证： 使用环境变量（X_AUTH_TOKEN、X_CT0）或 Chrome 登录进行 cookie 认证。

baoyu-compress-image

压缩图片以减小文件大小，同时保持质量。

/baoyu-compress-image path/to/image.png
/baoyu-compress-image path/to/images/ --quality 80

baoyu-format-markdown

格式化纯文本或 Markdown 文件，添加 frontmatter、标题、摘要、层级标题、加粗、列表和代码块。

# 格式化 markdown 文件
/baoyu-format-markdown path/to/article.md

# 格式化指定文件
/baoyu-format-markdown path/to/draft.md

工作流程：

1. 读取源文件并分析内容结构
2. 检查/创建 YAML frontmatter（title、slug、summary、coverImage）
3. 处理标题：使用现有标题、提取 H1 或生成候选标题
4. 应用格式：层级标题、加粗、列表、代码块、引用
5. 保存为 {文件名}-formatted.md
6. 运行排版脚本：半角引号→全角引号、中英文空格、autocorrect

Frontmatter 字段：

格式化规则：

baoyu-markdown-to-html

将 Markdown 文件转换为样式化 HTML，支持微信公众号兼容主题、代码高亮，以及可选的外链底部引用。

# 基础转换
/baoyu-markdown-to-html article.md

# 主题 + 颜色
/baoyu-markdown-to-html article.md --theme grace --color red

# 将普通外链转换为文末引用
/baoyu-markdown-to-html article.md --cite

baoyu-translate

三模式翻译技能：快速（直接翻译）、标准（分析后翻译）、精翻（完整出版级工作流，含审校与润色）。

# 标准模式（默认）- 先分析再翻译
/translate article.md --to zh-CN

# 快速模式 - 直接翻译
/translate article.md --mode quick --to ja

# 精翻模式 - 完整工作流，含审校与润色
/translate article.md --mode refined --to zh-CN

# 翻译 URL
/translate https://example.com/article --to zh-CN

# 指定受众
/translate article.md --to zh-CN --audience technical

# 指定风格
/translate article.md --to zh-CN --style humorous

# 附加术语表
/translate article.md --to zh-CN --glossary my-terms.md

选项：

模式：

标准模式完成后，可回复「继续润色」或「refine」继续审校润色步骤。

受众预设：

也支持自定义受众描述，如 --audience "对 AI 感兴趣的普通读者"。

风格预设：

也支持自定义风格描述，如 --style "诗意而抒情"。

特性：

• 通过 EXTEND.md 自定义术语表，内置英中术语表
• 面向受众的翻译，可调节注释深度
• 长文档（4000+ 词）自动分块并行翻译
• 比喻和修辞按意译而非逐字翻译
• 为文化/专业术语添加译注
• 输出目录保留所有中间文件

baoyu-wechat-summary

微信群聊精华提取。使用 wx-cli 从群消息中提取话题、引言和统计数据，生成结构化简报。支持跨次运行的群聊历史、群友画像和群级事实记忆维护，可生成正常版和毒舌版，并在简报中回应群里向 @bot 提出的问题。

# 总结群最近消息
/baoyu-wechat-summary 相亲相爱一家人 最近 1 天

# 周报
/baoyu-wechat-summary AI 技术群 最近 7 天

# 增量模式（从上次摘要继续）
/baoyu-wechat-summary 相亲相爱一家人

# 毒舌版
/baoyu-wechat-summary 相亲相爱一家人 最近 3 天 毒舌版

前置要求：

• 安装 wx-cli（npm install @jackwener/wx-cli）
• macOS 上运行并登录 WeChat 4.x

特性：

• 话题提取，带归属和引言
• 发言排行榜和群友画像
• 群级事实记忆：群友指正过的事实跨期生效（内置防注入规则）
• 增量模式（从上次摘要断点继续）
• 大批量消息自动按天分割
• 正常版和毒舌版两种风格
• 支持从历史摘要回溯初始化画像

baoyu-electron-extract

从任意已安装的 Electron 应用的 app.asar 中提取资源和 JavaScript。当 .js.map 内嵌 sourcesContent 时，还原原始源码树（含 TypeScript/JSX）；否则用 Prettier 原地美化压缩后的 JS/CSS。始终跳过 node_modules。支持 macOS 和 Windows，其他平台请用 --asar 指定 asar 文件。

# 按应用名提取（默认输出：~/Downloads/<AppName>-electron-extract/）
/baoyu-electron-extract Codex

# 按绝对路径提取（.app 包、安装目录或 .asar 文件均可）
/baoyu-electron-extract "/Applications/Visual Studio Code.app"
/baoyu-electron-extract --asar /Applications/Codex.app/Contents/Resources/app.asar Codex

# 自定义输出目录
/baoyu-electron-extract Codex --output ~/work/codex-source

# 仅预览发现的路径，不写入任何文件
/baoyu-electron-extract Codex --dry-run

# 覆盖已存在的输出目录
/baoyu-electron-extract Codex --force

选项：

输出结构：extract-report.json（计数、警告、路径），extracted/（asar 原始内容，无 map 时原地美化），extracted.unpacked/（存在时复制的原生模块），以及 restored/（基于 .js.map 重建的源码树）。

环境配置 Copy Chapter

部分技能需要 API 密钥或自定义配置。环境变量可以在 .env 文件中设置：

加载优先级（高优先级覆盖低优先级）：

1. 命令行环境变量（如 OPENAI_API_KEY=xxx /baoyu-image-gen ...）
2. process.env（系统环境变量）
3. <cwd>/.baoyu-skills/.env（项目级）
4. ~/.baoyu-skills/.env（用户级）

配置方法：

# 创建用户级配置目录
mkdir -p ~/.baoyu-skills

# 创建 .env 文件
cat > ~/.baoyu-skills/.env << 'EOF'
# OpenAI
OPENAI_API_KEY=sk-xxx
OPENAI_IMAGE_MODEL=gpt-image-2
# OPENAI_BASE_URL=https://api.openai.com/v1
# OPENAI_IMAGE_USE_CHAT=false

# Azure OpenAI
AZURE_OPENAI_API_KEY=xxx
AZURE_OPENAI_BASE_URL=https://your-resource.openai.azure.com
AZURE_OPENAI_DEPLOYMENT=gpt-image-2
# AZURE_API_VERSION=2025-04-01-preview

# OpenRouter
OPENROUTER_API_KEY=sk-or-xxx
OPENROUTER_IMAGE_MODEL=google/gemini-3.1-flash-image
# OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
# OPENROUTER_HTTP_REFERER=https://your-app.example.com
# OPENROUTER_TITLE=你的应用名

# Google
GOOGLE_API_KEY=xxx
GOOGLE_IMAGE_MODEL=gemini-3-pro-image
# GOOGLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta

# DashScope（阿里通义万相）
DASHSCOPE_API_KEY=sk-xxx
DASHSCOPE_IMAGE_MODEL=qwen-image-2.0-pro
# DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1

# Z.AI
ZAI_API_KEY=xxx
ZAI_IMAGE_MODEL=glm-image
# ZAI_BASE_URL=https://api.z.ai/api/paas/v4

# MiniMax
MINIMAX_API_KEY=xxx
MINIMAX_IMAGE_MODEL=image-01
# MINIMAX_BASE_URL=https://api.minimaxi.com

# Replicate
REPLICATE_API_TOKEN=r8_xxx
REPLICATE_IMAGE_MODEL=google/nano-banana-2
# REPLICATE_BASE_URL=https://api.replicate.com

# 即梦（Jimeng）
JIMENG_ACCESS_KEY_ID=xxx
JIMENG_SECRET_ACCESS_KEY=xxx
JIMENG_IMAGE_MODEL=jimeng_t2i_v40
# JIMENG_BASE_URL=https://visual.volcengineapi.com
# JIMENG_REGION=cn-north-1

# 豆包（Seedream）
ARK_API_KEY=xxx
SEEDREAM_IMAGE_MODEL=doubao-seedream-5-0-260128
# SEEDREAM_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
EOF

项目级配置（团队共享）：

mkdir -p .baoyu-skills
# 将 .baoyu-skills/.env 添加到 .gitignore 避免提交密钥
echo ".baoyu-skills/.env" >> .gitignore

自定义扩展 Copy Chapter

所有技能支持通过 EXTEND.md 文件自定义。创建扩展文件可覆盖默认样式、添加自定义配置或定义个人预设。

扩展路径（按优先级检查）：

1. .baoyu-skills/<skill-name>/EXTEND.md - 项目级（团队/项目特定设置）
2. ~/.baoyu-skills/<skill-name>/EXTEND.md - 用户级（个人偏好设置）

示例：为 baoyu-cover-image 自定义品牌配色：

mkdir -p .baoyu-skills/baoyu-cover-image

然后创建 .baoyu-skills/baoyu-cover-image/EXTEND.md：

## 自定义配色

### corporate-tech
- 主色：#1a73e8、#4A90D9
- 背景色：#F5F7FA
- 强调色：#00B4D8、#48CAE4
- 装饰提示：简洁线条、渐变效果
- 适用于：SaaS、企业、技术内容

扩展内容会在技能执行前加载，并覆盖默认设置。

免责声明 Copy Chapter

baoyu-danger-gemini-web Copy Section

此技能使用 Gemini Web API（逆向工程）。

警告： 本项目通过浏览器 cookies 使用非官方 API。使用风险自负。

• 首次运行会打开浏览器进行 Google 身份验证
• Cookies 会被缓存供后续使用
• 不保证 API 的稳定性或可用性

支持的浏览器（自动检测）：Google Chrome、Chrome Canary/Beta、Chromium、Microsoft Edge

代理配置：如果需要通过代理访问 Google 服务（如中国大陆用户），请在命令前设置环境变量：

HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 /baoyu-danger-gemini-web "你好"

baoyu-danger-x-to-markdown Copy Section

此技能使用逆向工程的 X (Twitter) API。

警告： 这不是官方 API。使用风险自负。

• 如果 X 更改其 API，可能会无预警失效
• 如检测到 API 使用，账号可能受限
• 首次使用需确认免责声明
• 通过环境变量或 Chrome 登录进行身份验证

致谢 Copy Chapter

本项目受到以下开源项目的启发，感谢它们的作者：

• x-article-publisher-skill by @wshuyi — 发布 X 文章技能的灵感来源
• doocs/md by @doocs — Markdown 转 HTML 的核心实现逻辑
• 高密度信息图 Prompt by AJ@WaytoAGI — 信息图技能的灵感来源
• qiaomu-mondo-poster-design by @joeseesun（乔木） — Mondo 风格的灵感来源
• architecture-diagram-generator by @Cocoon-AI — 图表技能设计体系的灵感来源

许可证 Copy Chapter

除另有说明外，本仓库采用 MIT License 授权。

发布到 ClawHub 的 skill 根据 ClawHub registry 规则以 MIT-0 分发。第三方代码和素材按其注明的原始许可授权。

Star History Copy Chapter