에이전트 스킬

스킬 7종의 설치·업데이트·제거입니다.

스킬이란

스킬은 외부 AI 도구(Claude Code, Codex 등)에 설치하는 절차 문서입니다. 도구 목록과 한도의 정본은 서버이고, 스킬은 그 위에 "어떤 순서로 부를지"만 담습니다. 스킬 안에는 토큰, 서버 주소가 없습니다. 연결은 빠른 시작대로 따로 합니다.

참고

이 스킬은 스튜디오 안의 코파일럿이 쓰는 스킬과 별개입니다. 한쪽을 고쳐도 다른 쪽이 바뀌지 않습니다.

스킬	다루는 기능	체리 사용
`mellowz-studio-video`	영상·이미지 캔버스 문서 저작(읽기, 시뮬레이션, 수정 제안, 파일 업로드)	아니오
`mellowz-studio-toon`	만화 저작(만화 작업실이 열린 환경에서만)	아니오
`mellowz-studio-novel`	웹소설 저작	아니오
`mellowz-studio-studio`	잔액·에셋·업로드·스킬 등록·공유·즐겨찾기	아니오
`mellowz-studio-image`	이미지 생성(모델·가격 조회, 견적, 접수, 진행 조회, 업스케일, 취소)	예
`mellowz-studio-video-gen`	영상 생성(클립, 오디오, 캔버스 실행, 씬 배치)	예

저작 스킬은 수정을 제안만 합니다. 적용은 사용자가 앱에서 승인합니다.

스킬을 쓰려면 연결한 키에 같은 이름의 기능 권한이 있어야 합니다. 권한이 없으면 그 서버의 도구는 열리지 않습니다. 작업을 시작할 때 맨 먼저 부르는 도구는 서버의 가이드 도구입니다.

스킬	서버 주소	필요한 권한	먼저 부르는 가이드
`mellowz-studio-video`	`/video/mcp`	`video` (파일 업로드는 `assets`도 필요)	`get_video_guide`
`mellowz-studio-toon`	`/toon/mcp`	`toon`	`get_toon_guide`
`mellowz-studio-novel`	`/novel/mcp`	`novel`	`get_novel_guide`
`mellowz-studio-studio`	`/studio/mcp`	`studio`	`studio_guide`
`mellowz-studio-image`	`/image/mcp`	`image`	`image_guide`
`mellowz-studio-video-gen`	`/video-gen/mcp`	`video_gen`	`video_guide`

권한 이름과 허용 범위는 로그인과 키에 있습니다.

모든 스킬이 공통으로 담는 규칙입니다.

스킬마다 더 있는 규칙은 다음과 같습니다.

스킬	규칙
`studio`	공개 범위를 넓히는 호출은 승인 대기로 끝납니다. 사용자가 웹에서 승인하기 전에는 공개됐다고 말하지 않습니다. 업로드와 등록의 재시도는 같은 `idempotencyKey`로 합니다. 새 키를 쓰면 사본이 생깁니다. 새로 등록한 스킬은 항상 비공개이고 장착되지 않은 상태입니다.
`image`	제출 전에 견적과 잔액을 보여 주고 확인받습니다. 재시도는 같은 키, 다시 뽑기는 새 키를 씁니다. 참조 이미지에 실존 인물이 있으면 `real_person_reference` 경고를 그대로 전달합니다. 성인 생성은 이 서버가 지원하지 않습니다.
`video-gen`	접수 전에 견적과 잔액을 보여 주고 확인받습니다. 장면 묶음 확정은 사람 승인이 필요하므로 승인 전에는 실행됐다고 말하지 않습니다. 완성 영상은 서버가 렌더하지 않습니다. 조립이 끝나면 편집기에서 직접 내보내도록 안내합니다.

참고

안내에 있는 도구가 "없다"고 나오면 서버가 아니라 AI 도구 쪽 도구 목록 캐시가 옛것일 수 있습니다. 연결 설정에서 도구 목록을 새로 고친 뒤 새 대화에서 다시 시도하세요.

저장소를 내려받은 환경에서 스킬 폴더를 복사합니다.


mkdir -p ~/.claude/skills
cp -R distribution/mcp-client/skills/* ~/.claude/skills/

Claude Code는 플러그인으로도 불러올 수 있습니다.

Claude Code 플러그인으로 불러오기 — bash
claude --plugin-dir ./distribution/mcp-client

플러그인 스킬은 /mellowz-studio:mellowz-studio-video처럼 플러그인 이름을 앞에 붙여 부릅니다. 스킬이 보이지 않으면 Codex를 다시 시작하세요.

업데이트: 저장소를 최신으로 받고 같은 복사 명령을 다시 실행합니다. 이전 버전에서 사라진 스킬 폴더는 직접 지웁니다.
제거: 복사해 둔 mellowz-studio-* 폴더를 지웁니다. 연결해 둔 MCP 서버와 발급한 키는 스킬과 별개이므로 키는 연결 화면에서 폐기합니다.

처음에는 읽기 전용으로 시작합니다. 에이전트가 가이드 도구를 먼저 부르고, 조회 도구로 목록과 상세를 읽게 하세요. 연결 키에 읽기만 필요한 기능만 허용하면 생성이 실수로 일어날 수 없습니다.

에이전트의 대화와 로그에 연결 키를 남기지 않게 하세요. 키는 환경변수로만 넘기고, 대화에 붙인 키는 폐기하고 새로 만듭니다.