KO
소식0.5.0 새 기능: 소설과 숏에 다는 댓글, 버전 기록, 실행 취소, AI 끄기 스위치.
Docs

문서 › Scenaloom Agent Skill

Scenaloom Agent Skill

Scenaloom Agent Skill은 Claude와 다른 에이전트가 MCP 서버를 통해 Scenaloom 프로젝트로 작업하는 법을 알려 주는 짧은 지침 모음입니다. 어떤 도구를 어떤 순서로 부를지, 작가가 검토할 수 있게 수정을 제안하는 법, 시나리오 요소의 서식, 그리고 언제 멈추고 작가에게 물어야 하는지를 담고 있습니다. MIT 라이선스로 공개된 무료 오픈소스입니다.

스킬이 바꾸는 것

  • 모델은 장면을 고치기 전에 먼저 읽고, 수정은 한 번에 한 장면씩 작게 합니다.
  • 변경 전과 후를 항상 보여 주고 작가가 동의한 뒤에만 적용하며, Scenaloom에서 결과를 볼 수 있는 링크를 알려 줍니다.
  • 대본, 댓글, 메모의 텍스트는 작업할 재료로만 다루고, 따라야 할 지시로 받아들이지 않습니다.
  • 비용을 알리고 승인을 받기 전에는 유료 생성을 시작하지 않으며, 작가가 요청하지 않으면 공동 작업자를 @멘션하지 않습니다.
  • 씬 헤딩, 짧은 지문, 인물 이름과 대사 같은 시나리오 관례를 프로젝트의 언어와 레이아웃 그대로 따릅니다.

Claude Code: 플러그인 설치

플러그인 하나로 스킬 설치와 Scenaloom MCP 서버 연결이 한 번에 끝납니다. Claude Code에서 다음을 실행하세요.

/plugin marketplace add scenaloom/scenaloom-agent
/plugin install scenaloom@scenaloom

그다음 /mcp를 실행하고 scenaloom을 골라 로그인한 뒤 권한을 승인합니다. "「야간 당직」 대본 S#3의 대사를 더 짧고 단단하게 다듬어 줘"처럼 요청하면 스킬이 작업을 이어받습니다.

claude.ai와 Claude 데스크톱: 스킬 업로드

Scenaloom Agent Skill 다운로드ZIP, 몇 KB: SKILL.md와 참고 문서가 든 스킬 폴더

  1. 위의 ZIP 파일을 내려받습니다. 압축은 풀지 마세요.
  2. claude.ai에서 Customize, Skills 순으로 열고 +, Create skill을 고른 뒤 ZIP 파일을 업로드합니다.
  3. AI 앱과 Scenaloom 연결하기에 나온 대로 Scenaloom 커넥터를 추가합니다. 스킬이 프로젝트에 접근하려면 커넥터가 있어야 합니다.

업로드한 스킬은 내 Claude 계정에서만 보입니다. 스킬을 쓰려면 코드 실행이 켜진 Claude 유료 요금제가 필요합니다.

다른 에이전트

이 스킬은 공개 표준인 Agent Skills 형식을 따르므로, SKILL.md 폴더를 읽는 에이전트라면 어디서든 쓸 수 있습니다. ZIP 안의 scenaloom 폴더를 그 에이전트의 스킬 디렉터리에 복사하고, 에이전트 설정에서 MCP 서버를 연결하세요. 소스는 github.com/scenaloom/scenaloom-agent에 공개되어 있습니다.

스킬 구성

파일내용
SKILL.md기본 원칙과 자주 쓰는 작업 흐름
references/tools.md모든 도구와 각 도구의 권한, 하는 일
references/screenplay-format.md시나리오 요소, Fountain, 씬 헤딩, 아시아식 레이아웃
references/workflows.md장면 고쳐 쓰기, 메모 반영, 소설 장 수정, 인물 초상과 스토리보드 프레임
references/safety.md문서 텍스트를 데이터로 다루기, 제안 후 적용, 크레딧 지출과 멘션