Gent Skill
전문적이고 독자적인 비주얼 제작 스킬 — 최고 수준의 이미지 생성, 비디오 합성, Figma급 디자인, FFmpeg 편집을 하나의 공급자 파이프라인 아래 통합합니다. 모든 OpenClaw에 설치할 수 있는 독립 스킬입니다.
사용 시기
트리거 구문 (사용자가 생성/편집/디자인을 명시적으로 요청할 때만):
- "프롬프트 X로 이미지 생성", "시네마틱 이미지 만들어 줘"
- "gent-skill 동영상 인트로 만들어 줘", "인트로 비디오 제작"
- "이것을 Figma 레이아웃으로 디자인해 줘", "Figma 오버레이 디자인 생성"
- "이 비디오 편집: 트림/압축/병합", "비디오에서 오디오 추출", "비디오에 음성 해설 추가"
- "이 이미지를 Figma에서 텍스트와 결합" "이스탄불", "사진", "디자인" 같은 단독 언급에는 생성 의도가 명확하지 않으면 트리거하지 마십시오.
아키텍처 (통합 스킬)
- 이미지 생성 —
beauty-generation-api스킬 (참조 엔드포인트:https://gen1.diversityfaces.org/api/generate) - 비디오 오케스트레이션 —
ai-video-gen스킬 (generate_video.py,images_to_video.py,add_voiceover.py) - 비디오 편집 —
ffmpeg-video-editor스킬 (트림, 병합, 리사이즈, 효과를 위한SKILL.md패턴) - 디자인 —
figma스킬 (시각적 감사, 자산, 오버레이)
설치 시 이미지 생성을 위해 BEAUTY_API_KEY만 필요합니다. 별도의 플러그인은 필요하지 않습니다.
워크플로우
- 의도 분류 — 이미지 | 비디오 인트로 | 비디오 편집 | 디자인
- 생성 (필요시) — beauty-generation-api 엔드포인트를 통해 gen1.diversityfaces.org 사용. 개인정보 고지: 전송하는 프롬프트/텍스트는 외부 서비스에서 처리됩니다. 프롬프트에 비밀번호, 토큰, 개인정보 또는 기밀 데이터를 포함하지 마십시오. 민감하지 않은 크리에이티브 브리프만 전송하세요. 이는 제공자의 의도된 사용과 일치합니다.
- 디자인 레이어 — 레이아웃 오버레이, 타이포그래피, 브랜드 마크를 위한 figma 스킬
- 어셈블리 — 전환, 스케일링, 줌, drawtext를 위한 ffmpeg-video-editor 패턴; 종단 간 오케스트레이션을 위한 ai-video-gen
- 전달 — 실제 파일 첨부로 출력 (
message도구,attachments배열). 마크다운 전용으로 전달하지 마십시오.
이미지 파이프라인 (필수 JPEG)
- 제공자: gen1.diversityfaces.org
- 기본 URL:
https://gen1.diversityfaces.org - 생성 엔드포인트:
/api/generate/custom - 상태:
/api/status/{prompt_id} - 다운로드:
/api/image/{filename} - 환경 변수:
BEAUTY_API_KEY - 형식: 모든 출력을 전송 전에 JPEG로 변환합니다. 소스 형식과 관계없습니다.
- 유효성 검사: 파일 존재 여부, 읽기 가능 여부, 유효한 JPEG 헤더 확인.
- 전송:
message(action=send, target=<chat>, attachments:[{type:"image", media:"/local/path.jpg", mimeType:"image/jpeg"}])
비디오 파이프라인
- 기본:
skills/ai-video-gen/(generate_video.py,images_to_video.py,add_voiceover.py) - 대체/수동:
ffmpeg-video-editor패턴 (zoompan, xfade, drawtext) - 기울어진 레이어/텍스트 인트로의 경우 ffmpeg 전에
figma스킬을 참조하십시오. - 항상 파일 첨부로 전달하며, 마크다운 전용으로 전달하지 마십시오.
안전 기본값
- 제공자: gen1.diversityfaces.org 우선; N회 실패 후 중단하고 이유 보고.
- 이미지: JPEG, 품질 90, 시네마틱인 경우 16:9.
- API 키는 비공개 유지; 대량 실행 전에 할당량 확인.
- 비디오 인트로: 최대 12초, 기본 해상도 1280x720, 30fps, 가독성을 고려한 텍스트 오버레이.
도구 참조
- 이미지 생성:
https://gen1.diversityfaces.org/api/generate/custom - 비디오 오케스트레이션:
skills/ai-video-gen/generate_video.py,images_to_video.py,add_voiceover.py(서브디렉토리 스크립트) 사용 - FFmpeg 패턴: ffmpeg-video-editor 사용법에 문서화됨 (트림, 병합, 리사이즈, 효과) — 설명하되 다른 SKILL.md 파일을 나열하지 마십시오.
- Figma 디자인: 레이아웃 오버레이, 타이포그래피, 브랜드 마크에 figma 스킬 사용
출력 정책
- 기본 첨부: 이미지는 JPEG, 비디오는 MP4.
- 전송 전에 항상
ok:true+ messageId를 확인하십시오. - 실패 시 이유를 기록하십시오.
배포
단일 자체 포함 스킬입니다. skills/gent-skill/를 복사하고 BEAUTY_API_KEY를 설정하여 모든 OpenClaw에 설치할 수 있습니다.
예제
- 이미지: 시네마틱 도시夜景 프롬프트 -> gen1 생성 -> JPEG -> 첨부 전송 (messageId 확인)
- 비디오: 두 JPEG -> images_to_video + drawtext -> MP4 -> 첨부 전송 (messageId 확인)
- 디자인: figma 감사 + 오버레이 -> ffmpeg 내보내기 -> MP4