revfactory/webtoon-harness · Archived

webtoon-scenario

웹툰 시나리오·스토리·대본을 설계/집필할 때 반드시 사용한다. 하이콘?

First seen Jul 15, 2026

Installation

$ npx skills add revfactory/webtoon-harness --skill webtoon-scenario

Summary

웹툰 시나리오·스토리·대본을 설계/집필할 때 반드시 사용한다. 하이콘셉트/로그라인, 세계관, 캐릭터, 시리즈 아크와 회차 맵, 매 회차 반전 설계와 복선, 긴장 곡선과 클리프행어, 대사 위주 회차 대본, 50+ 패널 비트 분할, 캐릭터 외형 토큰화를 다룬다. '웹툰 시나리오', '웹툰…

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from revfactory/webtoon-harness.

npx skills add revfactory/webtoon-harness

Browse all from revfactory/webtoon-harness

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 301
License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 13,566 B
  • docs SUMMARY.md 656 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

웹툰 시나리오 작성 방법론

웹툰 시나리오팀(concept-architect ~ script-editor) 전 에이전트의 공용 작법서다. 이 스킬은 무엇을 쓸지가 아니라 어떻게 쓸지를 정의한다. 특정 작품에 오버피팅하지 말고 어떤 장르·소재가 와도 동일한 절차로 적용한다.

0. 먼저 알아야 할 4대 품질 원칙 (Why-first)

웹툰은 세로 스크롤로 손가락이 멈추면 이탈한다. 그래서 모든 결정은 다음 4축을 만족시키기 위해 존재한다.

  1. 대사 위주 — 독자는 설명을 읽으러 오지 않는다. 정보·감정·반전을 캐릭터의 입과 행동으로 전달하라. 내레이션은 시공간 점프 등 꼭 필요할 때만.
  2. 고긴장 유지 — 매 패널은 "다음 패널을 보게 만드는 미끼"다. 회차 내내 긴장이 우상향하고 끝은 클리프행어로 닫는다.
  3. 매 회차 반전 — 회차마다 최소 1개, 독자의 예측을 뒤집는 순간을 둔다. 반전은 우연이 아니라 앞에 심은 복선의 회수여야 한다.
  4. 회차당 50+ 패널 — 비트시트/샷리스트 단계에서 패널 50개 이상을 보장한다. 부족하면 비트를 더 쪼갠다(아래 §8).

이 4축은 서로 강화한다: 대사로 긴장을 쌓고, 긴장의 정점에서 반전을 터뜨리고, 그 호흡을 패널로 잘게 나눈다.

1. 하이콘셉트 만드는 법 (concept-architect)

하이콘셉트 = 한 문장으로 "이거 봐야겠다"가 되는 후크. 다음 순서로 만든다.

  • What-if 압축: "만약 ___라면?"으로 세계의 핵심 비틀기를 한 문장에. (예: "죽으면 하루 전으로 돌아가는 형사가, 자기를 죽인 범인을 쫓는다.")
  • 친숙함 70% + 신선함 30%: 독자가 아는 장르 코드 위에 단 하나의 낯선 변수를 얹는다. 전부 낯설면 진입이 막히고, 전부 친숙하면 안 본다.
  • 로그라인 공식: [결함 있는 주인공]이 [목표]를 위해 [강한 적대/제약]과 맞서다가 [반전 가능성]에 직면한다.
  • 시리즈 훅(엔진): 회차가 무한히 나오게 하는 반복 가능한 갈등 구조를 명시한다. (회귀물=루프, 헌터물=등급 상승, 로맨스=관계의 진전/후퇴) 이 엔진이 약하면 시리즈가 5화에서 멈춘다.
  • 타깃·플랫폼 적합도: trend-brief.md의 인기 트로프/이탈 요인과 대조해 "왜 지금 이게 먹히는가"를 한 단락으로 정당화한다.

출력: 하이콘셉트 1줄, 로그라인 1줄, 시리즈 훅(엔진) 설명, 톤/장르, 비교작(comps) 2~3개, 핵심 차별점.

2. 세계관 설계 (worldbuilder)

세계관은 백과사전이 아니라 갈등을 만드는 규칙 세트다. 이야기에 쓰일 것만 정한다.

  • 핵심 규칙 3~5개: 세계가 작동하는 법칙. 특히 대가/제약을 명확히(능력에는 비용이 있어야 긴장이 산다).
  • 금기와 위반의 결과: 깨면 안 되는 선과 깼을 때의 대가 → 이것이 후반 반전의 연료.
  • 세력·계층·자원: 누가 무엇을 두고 다투는가. 갈등의 구조적 원천.
  • 미스터리 우물: 처음부터 다 밝히지 말고 "나중에 회수할 빈칸"을 의도적으로 남긴다(twist 연료).
  • 감각 디테일: 비주얼팀이 그릴 수 있게 색/건축/의상/날씨 등 시각 톤을 구체화.

3. 캐릭터 설계 + 외형 토큰화 (character-designer)

캐릭터는 (a) 드라마 엔진이자 (b) 비주얼팀의 일관성 토큰 소스다. 두 역할을 모두 채운다.

드라마 측면

  • 욕망(want) vs 진짜 필요(need), 치명적 결함, 비밀, 관계망(우호/적대/로맨스), 캐릭터 아크(어떻게 변하는가).
  • 말투 시그니처: 각 캐릭터가 대사만 봐도 누군지 알게 어휘·문장 길이·말버릇을 다르게.

외형 토큰(필수, 비주얼팀이 그대로 복붙해 일관성 유지) — 각 주요 캐릭터마다 고정 키워드로:

  • 헤어(색/길이/스타일), 눈(색/형태), 체형/키, 피부톤, 연령대
  • 기본 복장 1~2벌(실루엣/색 팔레트), 식별 특징(흉터·문신·안경·액세서리 등 항상 보이는 1~2개)
  • 표정 디폴트(무표정/미소 등), 색 팔레트 3색
  • 한 줄 토큰 예: 세이/16세 여/단발 은발/홍채 보라/마른 체형/검은 후드+붉은 머플러/왼눈 밑 점/무표정

이 토큰은 characters.md에 별도 블록으로 모아 둔다. art-director가 character-sheets.md로, prompt-smith가 패널 프롬프트로 그대로 가져간다.

4. 시리즈 아크 + 회차 맵 (series-plotter)

  • 3막/시즌 구조: 전체를 시즌→막→회차로 분해. 각 막의 전환점(중간점 반전, 1막 종결의 '돌아갈 수 없는 문')을 명시.
  • 회차 맵 표: 회차마다 핵심 사건 / 등장 캐릭터 / 진척되는 떡밥 / 회차 끝 클리프행어를 한 줄로. 이것이 twist-master와 episode-outliner의 골격.
  • 장기 떡밥 트래커: 심는 회차 ↔ 회수 회차를 매핑(아래 §6 복선 원칙과 정합).
  • 매 회차가 작은 목표 달성 + 더 큰 위협 노출로 끝나도록 설계(상승 나선).

5. 회차 구조 (episode-outliner) — 훅·상승·반전·클리프행어

한 회차는 4구간으로 나눈다. 패널 비율은 가이드일 뿐, 4축을 만족하면 조정 가능.

  1. 콜드 오픈 훅 (약 10%): 첫 3~5패널 안에 질문/위협/욕망을 던진다. 전 회차 클리프행어를 곧장 받거나 새 미끼를 던진다.
  2. 상승 (약 55%): 정보 공개와 장애물로 긴장을 계단식으로 올린다. 사이사이 복선 패널을 무심한 척 심는다.
  3. 반전 (약 20%): 쌓은 예측을 뒤집는다. 복선을 회수하며 의미를 재배치. (반전 카탈로그 → references/twist-patterns.md)
  4. 클리프행어 (약 15%): 다음을 안 보면 못 견디게. 새 위협/충격 공개/결정의 순간에서 컷.

6. 매 회차 반전 설계 원칙 + 복선 심기 (twist-master)

반전이 "갑툭튀"면 독자는 배신감을 느낀다. 좋은 반전은 "맞아 단서가 있었어!"다. 규칙:

  • 회차당 최소 1개 보장. 회차 끝 큰 반전 + (가능하면) 중반 작은 반전.
  • 복선 3회 노출 법칙: 단서는 ① 무심히 ② 한 번 더 다르게 ③ 회수. 1번은 못 보고, 2번은 흘리고, 3번에 "아!"가 오게.
  • 이중 의미 대사: 처음 읽을 땐 A, 반전 후 다시 보면 B로 읽히는 대사를 심는다(재독 유발).
  • 미스디렉션: 독자의 시선을 가짜 위협/가짜 범인에 묶어두고 진짜를 옆에 둔다.
  • 반전의 대가: 반전은 캐릭터에게 새 비용/딜레마를 부과해야 다음 회차 엔진이 된다. 충격만 주고 끝나면 소모적.
  • 정합성 체크: 모든 반전은 world.md 규칙과 characters.md 동기에 어긋나지 않아야 한다. 어기면 그건 반전이 아니라 설정 붕괴.

반전 유형 카탈로그(정체/배신/시간·기억/시점/떡밥 회수 등)와 복선 기법이 필요하면 → references/twist-patterns.md를 읽어라.

7. 긴장 곡선 유지법 (tension-engineer)

  • 비트 단위 긴장 레벨(1~10): 회차를 비트로 쪼개고 각 비트에 긴장 수치를 매긴다. 전체 추세는 우상향 톱니(올렸다 살짝 내렸다 더 올림). 평탄하면 지루, 계속 최고치면 마비.
  • 숨 고르기 밸브: 정점 직전에 짧은 이완(농담/일상)을 둬 다음 충격을 키운다. 단, 길게 끌면 이탈.
  • 정보 격차로 긴장 만들기: 독자만 아는 위협(서스펜스) vs 독자도 모르는 충격(서프라이즈)을 의도적으로 배치.
  • 타이머/제약: "30분 안에", "들키면 끝" 같은 가시적 제약은 즉시 긴장을 올린다.
  • 클리프행어 설계: 회차 마지막 비트는 반드시 긴장 9~10. 질문을 열어둔 채 컷.

8. 대사 위주 작법 (dialogue-writer)

내레이션으로 "설명"하지 말고 대사·행동으로 "보여줘라."

  • Show, don't tell: "그는 화났다"(X) → "…커피잔을 내려놓는 소리가 유독 컸다 / '한 번만 더 말해봐.'"(O)
  • 서브텍스트: 인물은 속내를 직접 말하지 않는다. 진심은 행간·말 돌리기·침묵으로. 긴장은 "말하지 않은 것"에서 온다.
  • 대사로 정보 전달: 세계관/규칙 설명도 갈등 중의 대사로 흘린다("그 문 열면 너도 끌려가, 형처럼.").
  • 목소리 차별화: §3의 말투 시그니처를 지킨다. 이름 가리고도 누구인지 알게.
  • 패널 1개 = 대사 1~2개: 말풍선이 패널을 넘치게 하지 말 것. 긴 대사는 여러 패널로 쪼개 호흡을 만든다. (말풍선이 이미지에 베이크되는 하네스에서는 한글 짧게 끊기가 더욱 중요 — 길수록 생성이 깨진다.)
  • 대사 흐름의 연속성(중요): 회차는 "대사로 굴러가는 흐름"이어야 한다. 인접 패널의 대사가 이어 읽혔을 때 화자 교대·맥락이 자연스러운 하나의 대화/독백 흐름이 되게 쓴다. 무대사 구간이 길게 늘어지거나(이미지만 연속) 맥락이 끊긴 대사 점프가 없게 한다. 침묵 컷은 의도된 박자일 때만(반전 직후 "쿵" 등).
  • 반전·정보·긴장을 대사에 싣기: 핵심 폭로는 내레이션이 아니라 인물의 입에서 터지게.
  • 효과음/감탄: 짧은 의성어·의태어 패널로 리듬을 준다(웹툰 특유의 박자).

9. 50+ 패널 분량 확보를 위한 비트 분할 (episode-outliner)

세로 스크롤은 한 패널=한 동작/한 감정/한 대사가 기본이다. 50패널은 다음으로 자연스럽게 나온다.

  • 1동작 1패널: "문을 본다 → 손을 뻗는다 → 멈칫한다 → 연다"를 4패널로. 감정의 미세 변화를 끊어 보여준다.
  • 리액션 컷: 사건 패널 뒤에 반응 클로즈업 패널을 붙인다(충격·눈동자·손 떨림).
  • 클로즈업 분해: 중요한 순간은 와이드→미디엄→클로즈업→익스트림 클로즈업으로 점층.
  • 대사 분할: 긴 대사 한 덩어리를 여러 말풍선/패널로 쪼개 긴장 호흡을 만든다.
  • 정적 패널의 활용: 침묵·여백 패널로 박자를 준다(스크롤의 '쉼').
  • 점검: 비트시트 완성 후 패널 카운트를 세어 50 미만이면 정점·반전 구간을 더 쪼갠다(절대 채우기용 군더더기를 넣지 말 것).

10. 회차 대본 교정 (script-editor)

  • 반전 명료성: 반전이 독자에게 "전달"되는가? 복선이 회수되는가? 너무 빨라 김새거나, 너무 모호해 이해 불가는 아닌가.
  • 톤 통일: 회차 전체의 어조/세계관 용어/캐릭터 말투 일관성.
  • 대사 자연스러움: 어색한 번역투·설명충 대사 제거. 소리 내어 읽어 걸리면 고친다.
  • 페이싱: 늘어지는 구간 압축, 급한 구간 패널 추가 권고.
  • 연속성: 직전 회차/characters.md와 모순 없는지. 이 파일(ep{NN}scriptfinal.md)이 비주얼팀의 입력이므로 패널 단위 구조를 깨끗하게 정리한다.

11. 장르 트로프 활용

인기 장르(회귀/환생/헌터·게임/로맨스판타지/스릴러·복수/학원물 등)의 핵심 트로프와 클리셰를 활용/전복하는 법이 필요하면 → references/genre-tropes.md를 읽어라. 트렌드 정합은 trend-brief.md를 기준으로 한다.

12. 출력 경로 (HARNESS_CONTRACT §3 준수)

작업 루트 _workspace/. {NN}=2자리 회차. 각 에이전트는 자기 출력만 쓴다.

  • concept-architect → workspace/02story/concept.md
  • worldbuilder → workspace/02story/world.md
  • character-designer → workspace/02story/characters.md
  • series-plotter → workspace/02story/series-arc.md
  • twist-master → workspace/02story/twist-plan.md
  • tension-engineer → workspace/02story/tension-curve.md
  • episode-outliner → workspace/03episode/ep{NN}_beatsheet.md
  • dialogue-writer → workspace/03episode/ep{NN}_script.md
  • script-editor → workspace/03episode/ep{NN}scriptfinal.md (비주얼팀 panel-director의 입력)

13. 최종 품질 체크리스트 (출력 전 자가검증)

  • 대사 위주인가? 내레이션이 꼭 필요한 곳에만 있는가?
  • 회차 내 긴장이 우상향하고 끝이 클리프행어인가?
  • 회차당 반전 1개 이상이며 복선이 앞에 심겼는가?
  • (회차 산출물) 패널이 50개 이상인가?
  • 캐릭터 외형 토큰이 구체적이고 일관되는가?
  • world.md 규칙·characters.md 동기와 모순이 없는가?
  • 출력 경로가 §12와 정확히 일치하는가?