baoyu-skills

Skills shared by Baoyu for improving daily work efficiency with Claude Code.

Prerequisites

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

Installation

Quick Install (Recommended)

npx skills add jimliu/baoyu-skills

Publish to ClawHub / OpenClaw

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

Run the following command in Claude Code:

/plugin marketplace add JimLiu/baoyu-skills

Install Skills

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 Claude Code:

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

Available Plugin

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

Update Skills

To update skills to the latest version:

1. Run /plugin in Claude Code
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

Skills are organized into three categories:

Content Skills

Content generation and publishing skills.

baoyu-xhs-images

Xiaohongshu (RedNote) infographic series generator. Breaks down content into 1-10 cartoon-style infographics with Style × Layout two-dimensional system.

# 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 tech --layout list

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

Styles (visual aesthetics): cute (default), fresh, warm, bold, minimal, retro, pop, notion, chalkboard

Style Previews:

Layouts (information density):

Layout Previews:

baoyu-infographic

Generate professional infographics with 20 layout types and 17 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-cover-image

Generate cover images for articles with 5 dimensions: Type × Palette × Rendering × Text × Mood. Combines 9 color palettes with 6 rendering styles for 54 unique combinations.

# 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
• Rendering: flat-vector, hand-drawn, painterly, digital, pixel, chalk
• Text: none, title-only (default), title-subtitle, text-rich
• Mood: subtle, balanced (default),

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 two-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
/baoyu-article-illustrator path/to/article.md --type infographic

# Specify style
/baoyu-article-illustrator path/to/article.md --style blueprint

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

Types (information structure):

Styles (visual aesthetics):

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 Claude Code!"

# 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).

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

AI-powered generation backends.

baoyu-image-gen

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

# Basic generation (auto-detect provider)
/baoyu-image-gen --prompt "A cute cat" --image cat.png

# With aspect ratio
/baoyu-image-gen --prompt "A landscape" --image landscape.png --ar 16:9

# High quality (2k)
/baoyu-image-gen --prompt "A banner" --image banner.png --quality 2k

# Specific provider
/baoyu-image-gen --prompt "A cat" --image cat.png --provider openai

# OpenRouter
/baoyu-image-gen --prompt "A cat" --image cat.png --provider openrouter

# DashScope (Aliyun Tongyi Wanxiang)
/baoyu-image-gen --prompt "一只可爱的猫" --image cat.png --provider dashscope

# Replicate
/baoyu-image-gen --prompt "A cat" --image cat.png --provider replicate

# Jimeng (即梦)
/baoyu-image-gen --prompt "一只可爱的猫" --image cat.png --provider jimeng

# Seedream (豆包)
/baoyu-image-gen --prompt "一只可爱的猫" --image cat.png --provider seedream

# With reference images (Google, OpenAI, OpenRouter, Replicate, or Seedream 5.0/4.5/4.0)
/baoyu-image-gen --prompt "Make it blue" --image out.png --ref source.png

Options:

Environment Variables (see Environment Configuration for setup):

Provider Auto-Selection:

1. If --provider specified → use it
2. If only one API key available → use that provider
3. If multiple available → default to Google

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

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/<user>/status/<id>
• https://twitter.com/<user>/status/<id>
• https://x.com/i/article/<id>

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

Environment Configuration

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-1.5
# OPENAI_BASE_URL=https://api.openai.com/v1

# OpenRouter
OPENROUTER_API_KEY=sk-or-xxx
OPENROUTER_IMAGE_MODEL=google/gemini-3.1-flash-image-preview
# OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

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

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

# Replicate
REPLICATE_API_TOKEN=r8_xxx
REPLICATE_IMAGE_MODEL=google/nano-banana-pro
# 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

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

baoyu-danger-gemini-web

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

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

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

License

MIT

Star History