This Skill is designed to help users quickly and automatically crop designed grid collages (such as six-grid, nine-grid, and twelve-grid) and generate assets compliant with the WeChat Sticker Open Platform specifications.
Core Features
- Automatic Cropping: Supports multiple grid layouts such as 2x3, 3x2, 3x3, 3x4, and 4x3.
- Specification Conversion：
- Sticker Main Image: uniformly resized to 240x240 pixels (PNG).
- Chat Page Icon: uniformly resized to 50x50 pixels (PNG).
- Meaning Word Generation: automatically generates
meta.txtfile, reserving a place to fill in the "meaning word", making batch management convenient. - Information Template Generation: automatically generates
info.txtfile, including fill-in templates and character limit prompts for [Sticker Name], [Sticker Introduction], and [One-Sentence Introduction]. - Candidate Asset Generation: automatically extracts the 1st sticker and generates a specification-compliant [Avatar/Cover Image Candidate] (240x240) and [Chat Page Icon Candidate] (50x50).
- Automatic Naming: automatically numbers according to WeChat specifications (01, 02, ...).
Usage Guide
1. Quick Start
No need to manually install dependencies; simply run the script. The tool will automatically create a virtual environment (.venv) and install the required dependencies.
# 基本用法：自动处理并生成
./skills/wechat-sticker-maker/scripts/run.sh /path/to/your/grid_image.png
# 常用选项：
# - 指定布局 (例如 3x3)
./skills/wechat-sticker-maker/scripts/run.sh /path/to/image.png --layout 3x3
# - 指定输出目录
./skills/wechat-sticker-maker/scripts/run.sh /path/to/image.png --output ./my_stickers
2. (Optional) Manual Installation
If you wish to manage the environment manually:
python3 -m venv .venv
source .venv/bin/activate
pip install -r skills/wechat-sticker-maker/requirements.txt
python3 skills/wechat-sticker-maker/scripts/make_stickers.py ...
3. Output Results
The script will generate two subfolders and multiple files in the specified output directory.
- Default Output Path: if the user does not specify one, by default it creates and outputs to the
output/stickers_[theme]directory (where[theme]is replaced according to the specific theme of the sticker pack, such asoutput/stickers_cat）。 - Custom Output Path: users can also specify a custom output directory via
--output. - Output Content：
main/: stores sticker main images (240x240)icon/: stores sticker thumbnail icons (50x50, here icon refers to the thumbnail of each sticker, not the single chat page icon)meta.txt: Meaning Word Configuration Table (format:01.png [请输入表情含义])info.txt: Album Information Template (includes name and introduction templates)cover_candidate.png: Cover Image Candidate (240x240, taken from the 1st image)chat_icon_candidate.png: Chat Page Icon Candidate (50x50, taken from the 1st image)
Output Directory Customization: When invoking the script, the Agent should pass the --output parameter: if the user specifies a path, use the user-specified path; if not specified, use the default output/stickers_[theme] format path. After generation is complete, report to the user the specific file paths and file previews generated in that directory.
Important: Meta-Data Auto-Population
After running this script, the Agent mustBased on the generated meme theme, image content, or the template used,automatically modify and fill in info.txt and meta.txt placeholders in:
- Supplement
info.txt：- [Emoticon Name]: Create a vivid name based on the theme (no more than 8 Chinese characters, no punctuation).
- [Emoticon Introduction]: Describe the style and applicable scenarios of this emoji pack (no more than 80 Chinese characters).
- [One-sentence introduction]: Refine an eye-catching promotional slogan (no more than 11 Chinese characters, no punctuation).
- Supplement
meta.txt：- Replace the
[请输入表情含义]in each line with the specific action or emotion meaning corresponding to that emoji image (e.g.:01.png 收到、02.png 摸鱼, etc., usually 2-4 characters).
- Replace the