image-processing

Original：🇨🇳 Chinese

Translated

1 scriptsChecked / no sensitive code detected

Process images and support adding captions to images. Two caption modes: bottom frame style (like a picture frame) and internal sticker style (similar to Xiaohongshu effect). Implemented with PIL/Pillow, supports Chinese and Emoji.

3installs

Sourcez0gsh1u/oh-my-writing-skill

Added on2026-02-08

NPX Install

npx skill4agent add z0gsh1u/oh-my-writing-skill image-processing

SKILL.md Content (Chinese)

View Translation Comparison →

Image Processing Skill

You are an image processing assistant responsible for adding text annotations and decorative effects to images.

Core Capabilities

Bottom Frame Caption: Add an independent text area below the image, similar to a picture frame effect
Internal Sticker Caption: Add text labels with background inside the image, similar to Xiaohongshu sticker effect
Chinese Support: Use the built-in Microsoft YaHei font of Windows system
Emoji Support: Use the pilmoji library to render Emoji expressions

Usage

Mode 1: Bottom Frame Caption

Add a text area with white/dark background below the image:

bash

python scripts/image_processor.py input.jpg output.jpg --mode frame --text "这是配文 🎉"

Effect Example:

┌────────────────────┐
│                    │
│      Original Image│
│                    │
├────────────────────┤
│  这是配文 🎉        │
└────────────────────┘

Parameters:

```
--mode frame
```
: Frame mode
```
--text
```
: Caption content (supports Chinese and Emoji)
```
--bg-color
```
: Background color (default
```
white
```
, available options:
```
black
```
,
```
#RRGGBB
```
)
```
--text-color
```
: Text color (default
```
black
```
)
```
--font-size
```
: Font size (default 32)
```
--padding
```
: Inner padding (default 20)

Mode 2: Internal Sticker Caption

Add text labels with background at specified positions inside the image:

bash

python scripts/image_processor.py input.jpg output.jpg --mode sticker --text "重点！" --position bottom-right

Effect Example:

┌────────────────────┐
│                    │
│      Original Image    ┌───┤
│               │重点│
└───────────────┴───┘

Parameters:

```
--mode sticker
```
: Sticker mode
```
--text
```
: Caption content

--position

: Position, optional values:

top-left

,

top-right

,

bottom-left

,

bottom-right

,

center

```
--bg-color
```
: Label background color (default
```
#FFE4B5
```
, light orange)
```
--text-color
```
: Text color (default
```
#333333
```
)
```
--font-size
```
: Font size (default 28)
```
--opacity
```
: Background transparency 0-255 (default 230)
```
--radius
```
: Rounded corner radius (default 10)
```
--margin
```
: Distance from the edge (default 20)

Batch Processing

Process multiple images:

bash

python scripts/image_processor.py ./images/*.jpg --output-dir ./output --mode frame --text "配文"

Font Configuration

The script will search for Chinese fonts in the following order:

```
C:/Windows/Fonts/msyh.ttc
```
- Microsoft YaHei
```
C:/Windows/Fonts/simhei.ttf
```
- SimHei
```
C:/Windows/Fonts/simsun.ttc
```
- SimSun
System default font (may not support Chinese)

To use a custom font:

bash

python scripts/image_processor.py input.jpg output.jpg --font "C:/MyFonts/custom.ttf" --text "配文"

Color Reference

Common color values:

Name	Code	Usage
White	`white` / `#FFFFFF`	Frame background
Black	`black` / `#000000`	Dark background/text
Light Orange	`#FFE4B5`	Sticker background
Light Blue	`#E3F2FD`	Sticker background
Light Green	`#E8F5E9`	Sticker background
Light Pink	`#FCE4EC`	Sticker background

Cooperation with Other Skills

Use Image Search Skill to find suitable images
Use this Skill to add captions
Reference the processed images in General Writing Skill

Notes

Image Format: Supports common formats such as JPG, PNG, WEBP
Output Format: Automatically select the format based on the output file extension
Emoji Rendering: Need to install the pilmoji library
Font Permissions: Ensure you have read permissions for the font files

image-processing

NPX Install

Tags

SKILL.md Content (Chinese)

Image Processing Skill

Core Capabilities

Usage

Mode 1: Bottom Frame Caption

Mode 2: Internal Sticker Caption

Batch Processing

Font Configuration

Color Reference

Cooperation with Other Skills

Notes