skill이란 무엇인가요?

skill은 agent를 위한 재사용 가능한 능력 패키지라고 보면 됩니다. 보통 설명 문서, 실행 규칙, 스크립트, 참고 리소스를 포함하며, agent가 매번 처음부터 판단하지 않고도 특정 작업을 더 안정적으로 수행할 수 있게 해줍니다.

Python이 꼭 필요한가요?

네. README와 SKILL.md 모두 Python 3.8+를 전제 조건으로 명시합니다. 인증, 생성, Board 관리, 사용량 조회가 모두 Python 스크립트로 이루어집니다.

인증은 어떻게 하나요?

python scripts/auth.py login으로 디바이스 플로우 로그인을 진행합니다. 로그인 후 TOPVIEW_UID와 TOPVIEW_API_KEY가 자동 설정되며 CI 환경에서는 수동 설정도 가능합니다.

어떤 모듈이 포함되어 있나요?

README에는 Auth, Avatar4, Video Gen, AI Image, Remove BG, Product Avatar, Text2Voice, Voice, Board, User의 10개 모듈이 안내되어 있습니다.

curl로 직접 API를 호출해도 되나요?

권장되지 않습니다. SKILL.md는 scripts/ 아래 Python 스크립트를 사용하고 curl이나 직접 HTTP 호출은 피하라고 명시합니다.

run과 query는 어떻게 구분하나요?

새 작업은 기본적으로 run을 사용합니다. run은 제출 후 자동으로 폴링하며, query는 타임아웃 후 재개하거나 기존 taskId가 있을 때만 사용합니다.

Board ID 프로토콜이란 무엇인가요?

board.py list --default -q로 기본 board를 가져오고 모든 생성 작업에 --board-id를 붙이는 방식입니다. 이렇게 해야 결과가 정리되고 boardTaskId가 있을 때 편집 링크도 생성할 수 있습니다.

로컬 파일을 바로 전달할 수 있나요?

네. SKILL.md에 따르면 이미지, 오디오, 비디오 파일 경로를 인자로 넘기면 자동 업로드되므로 별도의 수동 업로드 단계가 필요 없습니다.

User 모듈은 무엇을 하나요?

잔액과 사용 내역을 확인하는 모듈입니다. auth, board와 함께 워크플로 지원 레이어를 이루며 생성 전후의 계정 상태를 확인할 때 사용합니다.

어떻게 설치하나요?

Send this prompt to your agent: "Install Topview Skill for me: https://github.com/topviewai/skill.git". Your agent will handle the installation automatically. After that, you can start describing what you want to create.

공식 GitHub 저장소: topviewai/skill

Topview Skill

Plug Topview Skill into your AI assistant and unlock video generation, image creation and editing, talking avatars, and voice capabilities in one unified toolkit.

지원 플랫폼

Codex

Claude Code

OpenClaw

Hermes

Cursor

Copy to your agent to installInstall Topview Skill for me: https://github.com/topviewai/skill.git

Explore video & image use cases

Real results created with Topview Skill — generated end-to-end through your AI assistant.

Video use cases

영상 생성

업로드한 이미지로 영상을 만들어줘. 무너진 도시에서 전사와 어두운 기사 한 명이 격렬하게 결투하고, 빠른 검 격돌, 번개, 지면이 폭발하듯 갈라지는 장면이 필요해.

영상이 생성되었고 바로 검토할 수 있습니다.

Seedance 2.016:9

영상 편집

이 영상을 미국식 애니메이션 스타일로 바꿔줘

영상 편집이 완료되었습니다. 확인해 주세요.

Seedance 2.016:9

Image use cases

이미지 생성

이미지에 보이는 로고를 기반으로 VI(Visual Identity) 디자인 굿즈 세트를 만들어줘.

이미지가 생성되었고 바로 검토할 수 있습니다.

GPT Image1:1

이미지 편집

이미지 속 흰색 자동차를 빨간색으로 바꿔줘

이미지가 업데이트되었습니다. 확인해 주세요.

Image Edit16:9

제품 모델 이미지

이미지 속 남성이 내가 업로드한 제품 이미지를 들고 있게 해줘.

모델 이미지가 업데이트되었습니다. 확인해 주세요.

Product Model2:3

배경 제거

이 이미지의 배경을 제거해줘.

배경이 제거된 이미지가 생성되었고 바로 검토할 수 있습니다.

Remove BG2:3

AI 어시스턴트에 Topview Skill 추가

AI video generator skill

텍스트로 영상

프롬프트로 영상 생성

이미지로 영상

정지 이미지를 영상으로

참조 기반 생성

참조 기반 영상 생성

참고 자료 지원

이미지, 영상, 오디오, 텍스트 지원

AI image generator skill

텍스트로 이미지

프롬프트로 이미지 생성

이미지 편집

기존 비주얼을 AI로 편집

크리에이티브 변형

다양한 시안 생성

멀티 모델

10+ 이미지 모델 지원

AI avatar skill

사진 입력

한 장의 인물 사진으로 시작

토킹 아바타

말하는 아바타 영상 생성

자막 스타일

필요 시 자막 스타일 조회

AI 워크플로

AI가 아바타 모듈 실행

AI voiceovers skill

텍스트 음성 변환

음성 오디오 생성

음성 검색

음성 검색과 탐색

음성 복제

커스텀 음성 생성

오디오 출력

AI에 오디오 출력 추가

Claude Skill 프로토콜

Claude Skill 프로토콜 기반으로 제작

이 skill 은 Claude Skill 프로토콜 구조를 따르므로 agent 가 안정적이고 예측 가능한 방식으로 설치, 읽기, 실행할 수 있습니다. 실행 파일형 설치 프로그램이 아니라 워크플로 패키지이기 때문에 일반적인 사용에서 바이러스나 악성코드 위험이 없습니다.

VirusTotal 바이러스 검사 보고서 보기

사용 방법

Install Topview Skill for me: https://github.com/topviewai/skill.git

1단계: skill을 AI에 연결

Topview Skill을 설치해 AI 어시스턴트가 관련 기능을 사용할 수 있게 합니다.

🦞

2단계: AI에 만들고 싶은 내용을 전달

프롬프트, 이미지, 상품 사진, 인물 사진, 오디오 관련 작업을 그대로 보내면 됩니다.

🦞

3단계: AI가 결과 생성

AI가 적절한 Topview 모듈을 호출해 영상, 이미지, 아바타, 오디오 결과를 생성합니다.

자주 묻는 질문

Topview AI Skill의 공식 GitHub 저장소입니다. Topview AI 개발 워크플로를 스크립트, 참고 문서, 운영 규칙과 함께 Agent Skills 호환 Python 툴킷으로 제공합니다.

Topview Skill

Plug Topview Skill into your AI assistant and unlock video generation, image creation and editing, talking avatars, and voice capabilities in one unified toolkit.

지원 플랫폼

Codex

Claude Code

OpenClaw

Hermes

Cursor

Copy to your agent to installInstall Topview Skill for me: https://github.com/topviewai/skill.git

자주 묻는 질문

Topview AI Skill의 공식 GitHub 저장소입니다. Topview AI 개발 워크플로를 스크립트, 참고 문서, 운영 규칙과 함께 Agent Skills 호환 Python 툴킷으로 제공합니다.

Topview Skill