Communitygithub.com

hleliofficiel/gent-skill

전문적인 시네마틱 비주얼 스튜디오로, 이미지 생성, 동영상 인트로, 디자인 오버레이를 제공합니다. 이미지 생성, 프롬프트 제작, Figma 비주얼 디자인, ffmpeg 동영상 제작 및 음성 해설 조합에 사용하세요. 에이전트를 업그레이드하여 이미지 생성, 편집, 글쓰기, 동영상 제작 등을 무료로 수행하세요.

gent-skill란 무엇인가요?

Gent Skill은 전문적이고 독창적인 비주얼 제작 스킬로, 최고 수준의 이미지 생성, 비디오 합성, Figma급 디자인, 그리고 FFmpeg 편집 기능을 하나의 통합 파이프라인으로 결합합니다. 모든 OpenClaw 기반 에이전트에 독립적으로 설치할 수 있으며, 이미지 생성 및 편집, 비디오 인트로 제작, Figma 레이아웃 오버레이 설계, FFmpeg를 통한 비디오 트리밍/병합/효과 적용, 음성 해설 추가 등 다양한 작업을 지원합니다. 이 스킬은 beauty-generation-api, ai-video-gen, ffmpeg-video-editor, figma 스킬을 내부적으로 통합하여 이미지, 비디오, 디자인 전반에 걸친 일관된 워크플로우를 제공합니다. 주요 사용 예시로는 시네마틱 이미지 생성, 두 개의 JPEG 이미지를 결합한 비디오 인트로 제작, Figma 오디트 후 FFmpeg 오버레이 적용 등이 있습니다. 출력은 항상 실제 파일 첨부(JPEG, MP4)로 전달되며, 마크다운만으로는 전달되지 않습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hleliofficiel/gent-skill/tree/HEAD

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

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

문서

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만 필요합니다. 별도의 플러그인은 필요하지 않습니다.

워크플로우

  1. 의도 분류 — 이미지 | 비디오 인트로 | 비디오 편집 | 디자인
  2. 생성 (필요시) — beauty-generation-api 엔드포인트를 통해 gen1.diversityfaces.org 사용. 개인정보 고지: 전송하는 프롬프트/텍스트는 외부 서비스에서 처리됩니다. 프롬프트에 비밀번호, 토큰, 개인정보 또는 기밀 데이터를 포함하지 마십시오. 민감하지 않은 크리에이티브 브리프만 전송하세요. 이는 제공자의 의도된 사용과 일치합니다.
  3. 디자인 레이어 — 레이아웃 오버레이, 타이포그래피, 브랜드 마크를 위한 figma 스킬
  4. 어셈블리 — 전환, 스케일링, 줌, drawtext를 위한 ffmpeg-video-editor 패턴; 종단 간 오케스트레이션을 위한 ai-video-gen
  5. 전달 — 실제 파일 첨부로 출력 (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

관련 스킬