Communitygithub.com

ZJU-REAL/Easel

범용 이미지 처리: 크기 조절/자르기/패딩/포맷 변환/압축/워터마크/둥근 모서리/콜라주/썸네일 생성 및 이미지 정보 읽기. image_ops.py 기반의 결정적 처리.

Easel란 무엇인가요?

이 스킬은 사용자가 제공한 기존 이미지 파일에 대해 확정적인(pixel-level) 처리를 수행합니다. `skills/shared/scripts/image_ops.py` (Pillow 기반) 스크립트를 통해 크기 조절, 자르기, 패딩(소셜 미디어 플랫폼 맞춤), 포맷 변환, 압축, 텍스트/이미지 워터마크 추가, 둥근 모서리 처리, 콜라주(다중 이미지 연결), 썸네일 생성, 이미지 메타데이터 읽기 등의 작업을 지원합니다. `card-*` 스킬(HTML 디자인 및 렌더링)과 달리, 이 스킬은 시각적 디자인 없이 순수하게 이미지 파일만을 가공합니다. 사용자가 '크기 조절', '자르기', '워터마크 추가', '포맷 변환' 등의 요청을 할 때 사용되며, 처리 결과는 항상 파일 경로와 함께 출력됩니다. 또한 프로필 정보를 활용하여 워터마크 텍스트나 출력 비율을 자동으로 설정할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/openclaw/image-editing

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

이미지 처리 가공

기존 이미지에 대한 결정적 처리: 크기 조절/자르기/패딩/포맷 변환/압축/워터마크/둥근 모서리/콜라주/썸네일. 모든 작업은 skills/shared/scripts/image_ops.py (순수 Pillow)를 통해 실행되며, 즉석에서 스크립트를 작성하지 않습니다.

입력

  • 하나 이상의 기존 이미지 파일 경로 (png/jpg/webp 등 Pillow 지원 포맷)
  • 대상 작업 및 파라미터 (크기, 비율, 품질, 워터마크 텍스트, 콜라주 방식 등)

출력

  • 처리된 이미지 파일 (경로는 사용자가 지정하거나 기본적으로 outputs/주제명/에 저장)
  • 각 명령은 ✅ 경로 (너비x높이, 크기KB)를 반환하며, info 명령은 json을 출력합니다.

경계 (card-*와의 구분)

  • card-quote / card-xiaohongshu / poster-hero / comparison-card = 디자인 및 새 이미지 렌더링 (HTML→스크린샷)
  • image-editing = 기존 이미지 가공, 시각적 디자인 없음, 콘텐츠 생성 없음, 픽셀 수준 처리만 수행
  • "데이터/텍스트로 이미지 생성" 필요 → chart/infographic/card-* 사용; 이 SKILL은 기존 이미지 파일만 처리

실행 단계

  1. 입력 이미지 존재 확인, 대상 작업 및 파라미터 명확히 정의
  2. 프로젝트 루트 디렉토리에서 image_ops.py 해당 하위 명령 실행 (아래 참조)
  3. 플랫폼 크기 필요 시 references/platform-sizes.md에서 권장 비율/픽셀 확인
  4. 출력 경로 및 크기 반환; 여러 단계 작업은 연결 가능 (예: resize 후 compress)

명령어 빠른 참조

스크립트 경로는 통일적으로 skills/shared/scripts/image_ops.py이며, 모두 -h로 파라미터를 확인할 수 있습니다.

# 크기 조절: 너비/높이/퍼센트, --keep-ratio로 비율 유지하며 프레임 내에 맞춤 (늘어나지 않음)
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --percent 50
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080 --height 1440 --keep-ratio

# 자르기: 좌표 기준 또는 중앙에서 지정 크기로 자르기
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --box 100,50,900,650
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --width 1080 --height 1080

# 패딩 (소셜 미디어 맞춤 핵심): 임의 이미지를 1:1 / 9:16 / 16:9로 패딩
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 9:16 --background "#ffffff"
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 1:1 --background "20,20,30"

# 포맷 변환 png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85

# 압축: 지정 품질 또는 목표 파일 크기 상한에 맞춤 (jpg/webp)
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --quality 80
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --max-kb 200

# 워터마크: 텍스트 (위치/투명도/글자 크기/색상, 자동으로 시스템 한글 폰트 찾음) 또는 이미지 (오른쪽 아래 등)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@계정명" --position bottom-right --opacity 0.5 --size 40
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --image logo.png --position bottom-right --scale 0.3 --opacity 0.8

# 둥근 모서리 (투명 png 출력); --radius-percent 50은 원형
python skills/shared/scripts/image_ops.py round -i in.jpg -o out.png --radius 60
python skills/shared/scripts/image_ops.py round -i avatar.jpg -o out.png --radius-percent 50

# 다중 이미지 콜라주: 가로/세로/그리드 NxM (열x행), --cell-width/height로 셀 크기 통일
python skills/shared/scripts/image_ops.py collage -i a.jpg b.jpg c.jpg -o out.jpg --mode horizontal --gap 12
python skills/shared/scripts/image_ops.py collage -i 1.jpg 2.jpg 3.jpg 4.jpg -o out.jpg --grid 2x2 --gap 10 --cell-width 540 --cell-height 540

# 썸네일 (가장 긴 변 기준 픽셀)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256

# 이미지 정보 읽기 (json: 크기/포맷/비율/용량/투명 채널)
python skills/shared/scripts/image_ops.py info -i in.jpg

도메인 지식: 플랫폼 권장 크기

자주 사용되는 플랫폼 권장 사항은 references/platform-sizes.md에 있습니다. 자주 쓰이는 값:

  • 샤오홍슈 세로형 이미지/텍스트: 1080×1440 (3:4); 샤오홍슈 동영상/세로형 포스터: 1080×1920 (9:16)
  • 위챗 모멘츠 단일 이미지 / 일반 정사각형: 1:1 (예: 1080×1080)
  • 가로형 명언/커버: 16:9 (예: 1920×1080); 위챗 공식 계정 헤더 이미지 900×383
  • 웨이보 첨부 이미지: 1:1 또는 4:3; 틱톡/위챗 비디오 커버: 9:16 (1080×1920)

적용 방법: 우선 pad (내용 자르지 않고 변형 없이 패딩)로 이미지 보존; 꽉 찬 이미지가 필요하면 crop 중앙에서 목표 비율로 자르기; 단순 용량 축소는 resize/compress 사용.

프로필 인식

  • 프로필 있음: 워터마크 텍스트 기본값 = 계정명/handle; 출력 비율 기본값 = 계정의 주 플랫폼에 맞춤 (예: 샤오홍슈 계정 기본 1080×1440)
  • 프로필 없음: 사용자가 명시적으로 지정한 파라미터로 실행, 비율 기본값 = 원본 유지, 워터마크는 사용자가 텍스트 제공 필요

의존성 및 오류 처리

  • 의존성: Pillow (이미 설치됨, python -c "import PIL" 사용 가능), 순수 표준 라이브러리, 타사 라이브러리 없음
  • 스크립트 내장 경계 검사: 파일 없음 / 자르기 영역 초과 / 잘못된 비율 또는 색상 → 종료 코드 2 및 ERROR: 출력
  • 시스템 한글 폰트를 찾지 못하면 PIL 기본 폰트로 대체하고 WARN 출력, --font로 지정 가능
  • 자체 테스트: python skills/shared/scripts/image_ops.py --selftest

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ZJU-REAL/Easel

AI 视频生成:文生视频 / 图生视频 / 数字人首帧驱动。通过可插拔 provider(通义万相 Wan / 火山 Seedance / 快手可灵 / OpenAI 兼容)异步生成视频,用户自备 API key。当用户说 AI 视频生成、文生视频、图生视频、AI 生成视频、AI 短视频、让图片动起来、数字人视频、生成一段视频 时使用。与 video-strategy(选型/策略)、video-editing(剪辑处理)、clipify(切片)区别:本 SKILL 是从 0 用 AI 生成新视频。

ZJU-REAL/Easel

通用音频处理:音频剪辑/裁剪、格式转码(mp3/wav/m4a/aac)、音量归一化、从视频提取音轨、多段拼接、淡入淡出、变速(保音高)。当用户说“剪音频”“裁一段”“转成 mp3”“调音量/响度”“提取音轨/扒音频”“拼接音频”“淡入淡出”“加速/减速音频”“变速不变调”时使用。与 audio-denoise 的区别:audio-denoise 专做降噪,audio-editing 做除降噪外的通用音频操作(也内置 denoise 作为兜底)。

ZJU-REAL/Easel

一句话主题 → 成品短视频:自动串联 文案→配图/AI视频→配音→字幕→BGM→合成,把 Easel 制作层零件编排成一条'一键出片'流水线。**单条视频、口播/资讯向,画面默认逐句配图 + Ken Burns 缓动,需要动态时才逐段图生视频**。当用户说 一键生成视频、自动做短视频、主题生成视频、帮我做条视频、口播视频一条龙、自动出片、短视频一键生成 时使用。**有剧情/角色/对白/反转/多集的短剧改用 short-drama(每镜强制图生视频、不用静态图冒充);只写脚本用 video-script;只生成单个片段用 ai-video-gen。**

ZJU-REAL/Easel

自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。

ZJU-REAL/Easel

音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow 每图固定时长、柔和转场,本 SKILL 切换点由音乐节拍决定、硬切踩点带特效。

ZJU-REAL/Easel

Easel clipify: long English talk → punchline cuts → optional 16:9→9:16 face-pan/split → opus word-by-word ASS burn. Ships scripts + assets/preview.png. Part of 1.6k★ Easel suite.

ZJU-REAL/Easel

多角色对话配音:按 cast 和逐行对白为不同角色分配音色与情绪,合成多声线音轨和带角色名字幕。 当用户说“多角色/双人/剧本/对话配音、多人对白、不同角色不同声音、有声剧配音”时使用。 单一公共音色用 tts-voiceover;克隆本人音色用 voice-clone;整部短剧制作由 short-drama 编排。

ZJU-REAL/Easel

Easel video-highlights: CN/livestream highlight extract + stable static vertical reframe (sibling to clipify).

ZJU-REAL/Easel

>- 视频制作策略与工具选型:AI 视频生成模型对比、视频脚本结构设计、制作流程规划,覆盖产品演示/解说/社媒短视频场景。 当用户说"视频怎么做""视频选型""用什么工具做视频""视频制作流程""视频策略""视频系列规划"时使用。 和 video-script 的区别:video-strategy 做内容规划与工具选型,video-script 写具体某条视频的脚本。

관련 스킬