스프쌤
AI 작법

screenwriting-skills로 AI 대본 작법을 붙이는 법

✍ 야금야금⏱ 15분 소요2026-11-14👁
← 목록으로 돌아가기

AI가 문장은 매끄럽게 쓰는데 왜 이야기는 밋밋할까? 답은 문장력이 아니라 빠진 작법에 있다.

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: AI 대본에 작법 스킬을 붙이는 screenwriting-skills

✦ KR 핵심 요약: screenwriting-skills는 AI 대본의 밋밋함을 문장력 문제가 아니라 드라마투르기 부재로 보고, 47권 작법서와 23권 출간작에서 뽑은 26개 스킬을 agentskills.io 형식으로 제공한다. Claude Code와 Codex가 같은 파일을 공유하며, 질의는 한국어로 하고 답변도 한국어로 받을 수 있다. 다만 스킬 본문이 중국어로 정리돼 있고 Codex 전용 설치 절차는 확인 자료에 없으므로, 설치는 공식 README 기준으로 확인해야 한다.

🌐 Global Takeaway: The project treats weak AI scripts as a missing craft problem, not a fluency problem. It packages 26 screenwriting and dramaturgy skills distilled from 47 craft books and 23 published works, formatted for agentskills.io so Claude Code and Codex can share one install. Treat it as a craft layer for agents, then verify skill scope, output quality, and agent-specific installation before relying on it.

아래 그림은 원시 프롬프트와 screenwriting-skills를 붙인 작업 흐름의 차이를 보여준다.

프롬프트만 vs screenwriting-skills
기존
  • 스타일 참고만 전달
  • 갈등·반전 설계가 흐림
  • 대사·장면 검수 기준 없음
VS
screenwriting-skills
  • 26개 작법 스킬 제공
  • 47권 작법서·23권 출간작 근거
  • Claude Code·Codex 공유 설치
AI에게 대본을 맡길 때 작법 스킬을 붙이면 무엇이 달라지는지 비교한다.

1. 문장이 매끄러워도 이야기가 밋밋한 이유

AI에게 웹드라마나 숏폼 대본을 맡기면 첫 인상은 좋다. 문장은 자연스럽고, 상황 설명도 빠르며, 피드백을 반영하면 표현을 고쳐준다. 그런데 여러 번 다듬어도 인물의 욕망, 갈등의 상승, 반전의 위치, 대사의 압박감이 약하면 이야기는 여전히 밋밋하다. 이 글의 출발점은 “AI가 문장을 잘 쓰는데 작법을 모른다”는 문제의식이다.

스킬이 만들어지는 층
근거 자료작법서 47권, 출간 대본·악보·희곡 23권
정제시나리오·TV·드라마투르기 내용 26개 스킬로 추출
표준agentskills.io 형식으로 파일 공유
실행Claude Code·OpenAI Codex가 같은 스킬을 읽음
출간 작품과 작법서를 AI가 쓸 수 있는 스킬 파일로 바꾸는 과정을 보여준다.

시나리오와 TV 드라마, 연극을 가리키는 드라마투르기에는 장르별 규칙, 구조 설계, 대사 긴장감, 장면 전환 같은 반복 가능한 판단 기준이 있다. 사람이 작법서를 읽고 현장에서 익히는 부분을, AI 작업에서는 프롬프트에 명시하거나 도구가 참조할 규칙으로 내려야 한다. screenwriting-skills는 이 문제를 “스킬” 형태로 푼다. 깃허브 저장소 jtydhr88/screenwriting-skills는 시나리오·TV 드라마·드라마투르기용 에이전트 스킬 26개를 공개하고, Claude Code와 OpenAI Codex에서 같은 파일을 쓰도록 설계했다.

1-1. 문제를 작법으로 바꿔 보기

밋밋한 대본을 고칠 때 흔히 쓰는 프롬프트는 “더 흥미롭게”, “반전 추가”, “감정을 살려” 같은 추상 지시다. 이런 말은 방향은 있지만 기준이 없다. AI는 문장을 다듬을 수 있어도 무엇이 “좋은 반전”인지, 장면이 언제 꺾여야 하는지, 대사가 정보 전달이 아니라 충돌이 되려면 무엇이 필요한지 판단할 도구가 없다.

이 저장소가 제시하는 접근은 다르다. 47권의 작법서와 실제 출간된 대본·악보·희곡 23권에서 나온 내용을 스킬 파일로 정제했다. 출간작은 중국·미국·영국·일본·한국 작품을 포함한다고 README가 설명한다. 즉, AI가 스스로 만들어낸 일반론이 아니라, 여러 언어권의 출간 작품에서 반복 확인된 작법을 단일 저장소로 모은 셈이다.

2. screenwriting-skills는 무엇인가

공식 README 기준으로 이 프로젝트는 “Professional agent skills for screenwriting, television writing and dramaturgy”를 표방한다. 번역하면 전문 에이전트용 시나리오·TV 드라마·드라마투르기 스킬 모음이다. 핵심은 스킬 개수가 26개라는 점과, 그 근거가 작법서 47권과 출간작 23권이라는 점이다.

2-1. 스킬 26개와 근거 자료

README는 26개 agent skills를 Claude Code와 OpenAI Codex용으로 제공한다고 적는다. 스킬 파일은 개방 표준인 agentskills.io를 따르며, 한 번 설치하면 두 에이전트가 같은 내용을 공유한다. 플러그인으로 설치하면 /screenwriting:<skill> 형태로 호출하고, 예시로 /screenwriting:sw-dialogue가 제시된다.

항목 README·수집 자료 기준 내용
저장소 jtydhr88/screenwriting-skills
대상 시나리오, TV 드라마, 드라마투르기
스킬 수 26개 agent skills
근거 작법서 47권, 출간 대본·악보·희곡 23권
출간작 범위 중국·미국·영국·일본·한국 등
표준 agentskills.io
지원 에이전트 Claude Code, OpenAI Codex
호출 예시 /screenwriting:sw-dialogue
문서 README_KO, README_JA, README_FR, README_ZH 제공

Threads 글에는 별 1,470개라는 숫자가 언급됐지만, 확인 자료에는 저장소의 정확한 별 수가 명시돼 있지 않다. 그래서 이 글에서는 별 수보다 “무엇을 담았는가”와 “어떻게 설치하는가”를 기준으로 삼는다. 저장소에는 LICENSE 파일이 존재한다는 사실만 확인되고 세부 조건은 확인 자료에 없으므로, 상업적 사용이나 재배포 전에 라이선스를 직접 확인해야 한다.

2-2. 중국어 본문과 다국어 질의의 관계

README는 스킬 본문의 텍스트가 중국어로 작성돼 있다고 밝힌다. 이유는 원천 자료 상당수가 중국어 원작이거나 중국어 번역이기 때문이다. 그렇다고 중국어로만 물어야 하는 것은 아니다. README는 영어·일본어·한국어·프랑스어 등 사용자가 자기 언어로 질의하면 해당 언어로 답변을 받는다고 설명한다. 다만 다국어 README와 실제 답변 품질은 별개의 문제이므로, 한국어로 대본 작업을 맡길 때는 장르 용어와 결과물 품질을 샘플로 검증하는 편이 안전하다.

3. 작법이 AI 작업에 들어가는 방식

이 프로젝트의 가치는 “대본을 대신 써준다”가 아니라 “대본을 쓸 때 참조할 작법 지식을 에이전트가 꺼내 쓴다”는 데 있다. 일반 프롬프트는 대화를 시작할 때마다 기억에 의존하지만, 스킬은 파일로 남아 관련 작업이 감지될 때 자동으로 로드된다. README는 “Skills load automatically when the agent detects relevant context”라고 설명한다. 즉, 사용자가 매번 작법서를 인용하지 않아도 에이전트가 작업 맥락을 보고 스킬을 참조할 수 있는 구조다.

인용에 가까운 해석: 이 도구는 AI의 문장력을 높이는 플러그인이 아니라, 시나리오·TV·드라마투르기의 판단 기준을 에이전트가 참조하도록 만드는 작법층이다.

이를 계층으로 보면 단순하다. 아래에서 위로 갈수록 사람의 작업에 가까워진다.

대본 작업 흐름
아이디어소재·장르를 정함
→
작법 선택갈등·대사·구조 스킬 호출
→
초안AI가 장면·대사 초안 생성
→
검수반전·인물·리듬을 사람이 수정
작법 스킬을 붙인 뒤에도 사람이 장르·갈등·대사를 검수하는 순서다.

실무에서는 이 계층을 “설치하고 끝”이 아니라 “검수 기준으로 사용”해야 한다. 스킬이 갈등 설계나 대사 압박을 잘 짚어도, 최종 작품의 톤, 플랫폼 규격, 등장인물 설정은 프로젝트마다 다르다. 그래서 AI 초안을 완성본으로 보기보다, 구조와 반전 후보를 뽑는 작업대로 보는 편이 맞다.

3-1. 어떤 작업에 맞는가

웹드라마, 숏폼 대본, TV 에피소드 구조, 희곡식 장면 설계처럼 “문장보다 구조”가 중요한 작업에 맞다. 반대로 코드 리뷰, 데이터 분석, 일반 문서 요약에는 직접 관련이 없다. 스킬이 26개라고 해서 모든 분야를 커버하는 범용 팩이 아니라, 화면극·드라마·연극의 작법에 특화된 팩이라고 이해하는 것이 정확하다.

3-2. 어떤 작업에는 부족한가

스킬은 판타지 대본을 자동으로 완성해주거나 특정 플랫폼의 최신 규격을 보장하지 않는다. 한국어 대본의 최신 트렌드, 방송사 편성 규칙, 플랫폼별 세로형 포맷 제한은 별도 자료와 사람 검수가 필요하다. 또한 스킬 본문이 중국어로 정리돼 있다는 점은 번역 품질과 문화적 맥락의 차이를 만들 수 있다. 한국 대본에 적용할 때는 “작법 원리”는 참고하되, 대사 톤과 사회적 상황 묘사는 한국 작품을 추가 근거로 삼는 것이 좋다.

4. 설치와 호출은 공식 README 기준으로

README가 안내하는 첫 번째 방법은 Claude Code 플러그인 마켓플레이스다. 저장소를 마켓플레이스에 추가한 뒤 screenwriting 플러그인을 설치하면 된다. 두 번째 방법은 저장소를 clone한 뒤 스킬 폴더를 개인용 ~/.claude/skills/ 또는 프로젝트용 .claude/skills/에 복사하는 수동 방식이다. 확인 자료에는 OpenAI Codex에서 같은 스킬 파일을 공유한다는 설명은 있지만, Codex 전용 설치 명령은 포함돼 있지 않다.

/plugin marketplace add jtydhr88/screenwriting-skills
/plugin install screenwriting@screenwriting-skills

설치 후 호출 예시는 README에 나온 /screenwriting:sw-dialogue처럼 슬래시 명령과 스킬 이름을 조합하는 방식이다. 개인 프로젝트에서만 쓰려면 .claude/skills/에 복사하고, 여러 프로젝트에서 쓰려면 홈 디렉터리의 ~/.claude/skills/를 쓰는 구조다. 다만 이 경로는 README가 Claude Code 중심으로 안내한 내용이므로, Codex에서 동일하게 동작하는지는 실제 환경에서 확인이 필요하다.

설치 방식 README 기준 절차 적합한 경우
플러그인 마켓플레이스 marketplace add 후 plugin install 업데이트와 호출 명령을 쉽게 관리하고 싶을 때
개인 스킬 복사 clone 후 ~/.claude/skills/에 복사 모든 프로젝트에서 같은 스킬을 쓰고 싶을 때
프로젝트 스킬 복사 clone 후 .claude/skills/에 복사 저장소별로 버전을 고정하고 싶을 때
Codex 사용 같은 skill 파일 공유라고만 명시 설치 방법은 별도 확인 필요

설치는 짧지만, 실제 품질은 “어떤 스킬을 언제 부르는가”에서 갈린다. /screenwriting:sw-dialogue는 대사 관련 스킬 호출 예시일 뿐, 모든 대본 작업이 이 명령 하나로 끝나지 않는다. 스킬 목록을 먼저 확인하고, 장르·막 구성·대사·장면 전환 중 현재 문제에 맞는 스킬을 고르는 순서가 필요하다.

5. 실제 대본 작업에 적용하는 순서

screenwriting-skills를 쓰는 가장 현실적인 방법은 AI를 대본가로 믿는 것이 아니라, 작법 검토자와 초안 생성기로 나누는 것이다. 먼저 사람이 장르, 러닝타임, 플랫폼, 등장인물 수를 정한다. 그다음 AI에게 구조 초안과 대사 후보를 만들게 하되, 결과가 밋밋하면 문장 수정을 반복하기보다 작법 스킬을 호출해 갈등의 원인, 정보 공개 시점, 장면 전환의 기능을 다시 점검한다.

이 흐름을 순서로 정리하면 다음과 같다.

  1. 소재와 플랫폼을 정하고 한 줄 로그라인을 만든다.
  2. 장르에 맞는 작법 스킬을 골라 구조 초안을 받는다.
  3. 대사 스킬로 대화의 압박감과 정보 공개 순서를 점검한다.
  4. 사람이 반전 위치, 인물 동기, 플랫폼 길이에 맞게 수정한다.
  5. 최종본은 작법 참고가 아니라 한국어 대본 규격에 맞게 다시 다듬는다.

이 순서에서 AI의 역할은 “완성”이 아니라 “선택지 확대”다. 작법 스킬이 있어도 최종 판단은 사람에게 남는다. 특히 한국어 대본은 번역투, 설명조 대사, 과도한 정보 나열이 생기기 쉽다. 스킬이 구조를 잡아줘도 마지막 톤은 사람이 들어가야 한다.

6. 한계와 확인할 것

먼저 라이선스를 확인해야 한다. 저장소에 LICENSE 파일이 있다는 사실은 확인됐지만, 구체적인 허용 범위와 의무는 확인 자료에 없다. 공개 저장소라고 해서 상업적 콘텐츠 제작에 바로 쓸 수 있다고 단정하면 안 된다. 제작물에 반영하는 방식과 결과물의 저작권 처리도 프로젝트 정책에 맞춰 검토해야 한다.

두 번째는 Codex 지원의 실체다. README는 Claude Code와 OpenAI Codex가 같은 스킬 파일을 공유한다고 설명하지만, 확인 자료에는 Codex 전용 설치 명령이 없다. 따라서 “Codex에서도 된다”는 설명을 그대로 믿기보다, 실제 Codex 환경에서 스킬 파일이 로드되는지와 /screenwriting: 호출이 가능한지 테스트해야 한다.

세 번째는 스킬 본문의 중국어 문제다. README는 본문이 중국어인 이유를 설명하지만, 한국어 대본 작업에서 번역 품질이 항상 동일하다고 보장하지는 않는다. 따라서 스킬을 참고할 때는 원문 의미를 확인하고, 필요한 경우 한국어 대본으로 직접 재작성하는 편이 낫다. 좋은 작법 원리와 좋은 한국어 대사가 항상 같은 문장으로 나오지는 않기 때문이다.

마지막으로 기대치를 낮춰 잡는 것이 좋다. screenwriting-skills는 대본 품질을 보장하는 마법 도구가 아니라, AI 에이전트가 작법을 참조할 수 있게 만드는 지식 팩이다. 26개 스킬과 47권·23권의 근거는 강점이지만, 실제 작품의 흥행, 플랫폼 적합성, 법적 사용 범위는 별도 검증이 필요하다.

7. 결론: 밋밋함을 작법 문제로 다시 정의하기

AI 대본이 밋밋한 이유를 문장력 부족으로만 보면 해결이 늦어진다. 더 정확한 진단은 “구조와 작법이 프롬프트에 충분히 들어가지 않았다”는 것이다. screenwriting-skills는 이 진단에 맞춰 26개 작법 스킬을 Claude Code와 Codex가 공유할 수 있는 형태로 공개했다. 출간작 47권과 23권을 근거로 삼는다는 점은 희망적이지만, 스킬 본문의 언어, Codex 설치 절차, 라이선스 조건은 직접 확인해야 한다.

실무 적용은 단순하다. 설치 후 바로 완성본을 기대하지 말고, 구조 초안과 대사 검토에 스킬을 쓰고, 한국어 대본의 톤과 플랫폼 규격은 사람이 마무리한다. AI에게 작법을 붙이는 순간, 대본 작업은 “한 번에 좋은 글을 받는 일”에서 “근거 있는 선택지를 비교하고 다듬는 일”로 바뀐다.

자주 묻는 질문

Q. screenwriting-skills는 어떤 AI 에이전트에서 쓸 수 있나?
A. README 기준으로 Claude Code와 OpenAI Codex가 같은 스킬 파일을 공유하도록 설계됐다. 설치 절차는 Claude Code 플러그인 마켓플레이스를 우선 안내하고, Codex 전용 설치 명령은 확인 자료에 없으므로 실제 환경에서 확인이 필요하다.

Q. 한국어로 대본을 요청해도 되나?
A. README는 영어·일본어·한국어·프랑스어 등 사용자 언어로 질의하고 답변을 받을 수 있다고 설명한다. 다만 스킬 본문은 중국어로 정리돼 있으므로 한국어 대사 품질은 샘플 검증 후 사용하는 것이 안전하다.

Q. 이 도구가 대본을 자동으로 완성해주나?
A. 완성 보장 도구가 아니라 시나리오·TV·드라마투르기 작법을 참조하는 스킬 모음이다. 구조와 반전 후보를 뽑는 데 유용하지만, 최종 톤과 플랫폼 규격은 사람이 검수해야 한다.

Q. 상업적 콘텐츠에 바로 써도 되나?
A. LICENSE 파일 존재는 확인됐지만 세부 조건은 확인 자료에 없다. 사용 전에 저장소의 라이선스 원문과 NOTICE 파일을 직접 확인하고, 결과물 반영 방식이 정책에 맞는지 검토해야 한다.

원본

https://github.com/jtydhr88/screenwriting-skills

https://www.threads.com/@nangman_muk/post/Dd8Z_P7AdDS

함께 보면 좋은 글

댓글 0개