CommunityWriting & Editinggithub.com

goodmorninghope-khs/storytelling-loop

스토리텔링 루프: 로그라인을 북극성으로 삼아 접수 → 로그라인 공방 → 뼈대 → 인물 → 장면·회차 설계 → 초고 → 점검(로그라인 대조·대항 리뷰·실화/공공 게이트) → 판정(작가 반박·되돌리기) → 넘기기를 돌리는 상위 스킬. screenwriting(jtydhr88 작법 22모듈, sw-workflow 단계표·story-bible), screenplay-review-checklist(37개 기준 대항 리뷰), writing-loop(기획의도·홍보 문장), marketingskills(쇼츠·홍보), humanize-korean(지문·기획서만)을 엮는다. 트리거: 스토리텔링 루프, 로그라인 잡아줘, 드라마 대본, 시나리오, 극본, 웹드라마, 숏폼 드라마, 단편영화, 연극, 영상 시리즈 구성안, 쇼츠 대본, 실화 각색, 평전 서사, 이야기 구조, 시놉시스, 트리트먼트, 회차 구성, 공모전 원고.

What is storytelling-loop?

storytelling-loop is a Claude Code agent skill that 스토리텔링 루프: 로그라인을 북극성으로 삼아 접수 → 로그라인 공방 → 뼈대 → 인물 → 장면·회차 설계 → 초고 → 점검(로그라인 대조·대항 리뷰·실화/공공 게이트) → 판정(작가 반박·되돌리기) → 넘기기를 돌리는 상위 스킬. screenwriting(jtydhr88 작법 22모듈, sw-workflow 단계표·story-bible), screenplay-review-checklist(37개 기준 대항 리뷰), writing-loop(기획의도·홍보 문장), marketingskills(쇼츠·홍보), humanize-korean(지문·기획서만)을 엮는다. 트리거: 스토리텔링 루프, 로그라인 잡아줘, 드라마 대본, 시나리오, 극본, 웹드라마, 숏폼 드라마, 단편영화, 연극, 영상 시리즈 구성안, 쇼츠 대본, 실화 각색, 평전 서사, 이야기 구조, 시놉시스, 트리트먼트, 회차 구성, 공모전 원고.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/goodmorninghope-khs/storytelling-loop/tree/HEAD

Installed? Explore more Writing & Editing skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

스토리텔링 루프

이야기 글(극·대본·영상 서사·실화 각색)은 정보 글과 다르게 돈다. 사실 목록이 아니라 로그라인 한 줄이 모든 단계의 기준점이고, 점수 대신 지뢰(🔴🟠🟡)와 작가의 반박으로 판정하며, 대사는 매끈하게 다듬지 않는다. 작법 지식은 screenwriting 묶음에, 단계 진행과 상태 저장은 그 안의 sw-workflow에 있다. 이 스킬은 그 단계표 위에 로그라인 대조, 대항 리뷰, 실화·공공 게이트, 되돌리기 규칙, 다른 스킬로 넘기기를 얹는다.

스킬 위치: Aside 계정 스킬 폴더 skills/user/<스킬>/ (screenwriting, screenplay-review-checklist, writing-loop, marketingskills, humanize-korean, doc-coauthoring, policy-media-desk). 원본 저장소는 README의 표를 본다.

writing-loop와 다른 점

writing-loop (정보·설득 글)storytelling-loop (이야기·극)
기준점근거 목록(원문 사실)로그라인(관객과의 한 줄 약속)
단위문단·절비트·장면·회차
판정문체 5축 점수 40/50🔴🟠🟡 지뢰 + 작가 반박, 단계 통과 기준
윤문humanize-korean 필수대사에는 쓰지 않는다(말투·사투리·비문·끊김은 인물의 것). 지문·시놉시스·기획서만 light
되돌리기최대 3바퀴원인 단계로. 로그라인이 흔들리면 멈추고 ①로. 바퀴 수는 작가가 정함
상태회차 점검표story-bible.md(세션을 넘어 이어 쓰기)
누가 쓰나Aside 초안모드 선택: 공동집필 / 코치(작가 원고는 고쳐 쓰지 않음) / 점검만

루프

⓪ 접수 → ① 로그라인 공방 → ② 뼈대 → ③ 인물 → ④ 장면·회차 설계 → ⑤ 초고 → ⑥ 점검 → ⑦ 판정 ─ 통과 → ⑧ 넘기기·기록
              ▲  (북극성)        ▲        ▲            ▲                ▲                │
              └──────────────────┴────────┴────────────┴────────────────┴──── 되돌리기 ──┘
              모든 단계 끝에서 "로그라인 대조": 이 단계의 결과가 그 한 줄을 지키는가?

⓪ 접수

  1. 형식을 고른다: references/forms.md (장편, 드라마 시리즈·미니시리즈, 단편·웹드라마·숏폼, 무대극, 다큐·정책 영상 구성안, 쇼츠, 실화·평전 서사, 소설).
  2. 모드를 묻는다(ask_user_question 한 번): 공동집필(Aside가 초안), 코치(Aside는 질문·진단·연습만, 원고는 작가가 씀), 점검만(⑥만).
  3. 정할 것: 분량(분·쪽·회차 수), 플랫폼·제출처와 그 규격(공모전·방송사 규격이 스킬 체계보다 우선), 마감, 원작·실화 여부, story-bible 위치.
  4. 이미 원고가 있으면 sw-workflow 입구 경로의 "역으로 표 채우기"로 로그라인·구조·인물을 원고에서 뽑아 story-bible에 넣고, 빈 칸을 수정 목록으로 삼아 ⑥부터 돈다.
  5. 시작 줄: 스토리텔링 루프 · 형식 {형식} · 모드 {모드} · 경로 {장편 0~7 | 시리즈 S0~S7 | 짧은 경로}.

① 로그라인 공방 (북극성 세우기)

references/logline-card.md의 카드를 채운다. 후보를 5개 만들고 테스트로 걸러 하나를 고정해 story-bible 맨 위 "북극성" 칸에 적는다. 시리즈는 엔진(매주 이야기가 생기는 이유)과 회차 확장 테스트를 함께 통과해야 한다. 근거 스킬: sw-premise-theme, sw-industry-business(PROBLEM 점검), 시리즈는 sw-series-engine-bible.

②~⑤ 뼈대 · 인물 · 장면 · 초고

screenwriting/modules/sw-workflow/GUIDE.md의 단계표를 그대로 따른다(장편 25단계, 시리즈 S2S6). 단계마다 그 표의 산출물을 story-bible에 쓰고, 통과 기준을 자문한다. 단계 끝마다 로그라인 대조 한 줄을 남긴다: ② 대조: 중간점(가짜 승리)이 '…하려는 주인공'의 욕망을 키우는가 → 예.

  • 한국 드라마·영화 실무는 sw-korean-french-screenwriting, sw-series-case-studies(노희경)를 참고 사례로 붙인다.
  • 대본 형식은 sw-format-adaptation(한국식 S# 장면 번호제, Fountain). 제출처 양식이 있으면 그것.
  • 코치 모드에서는 산출물을 Aside가 쓰지 않고, 질문 목록과 연습 과제로 낸다.

⑥ 점검

references/gates.md의 다섯 칸을 채운다.

  • L 로그라인 대조: 장면·회차 목록 전체가 북극성을 지키는가. 지키지 않는 장면 목록.
  • W 단계 통과 기준: sw-workflow 표와 각 모듈의 진단 질문(구조 13, 인물 14, 대사 14, 장면 13, 형식).
  • R 대항 리뷰: screenplay-review-checklist(7층 37개 기준). AI가 함께 쓴 원고는 B 방식(subagent 1차 판정 → 증거 검증)이 기본.
  • F 실화·공공 게이트: 실존 인물·실화·기관 영상이면 켠다(사실, 명예·사생활·초상, 동의, 공공기관이면 선거법·평가로 느껴지지 않는 문체).
  • A 관객 시뮬레이션: subagent에 원고만 주고 차가운 읽기(cold read)를 시킨다. "다음 장면·다음 회가 궁금한가, 무엇이 헷갈리는가, 주인공이 원하는 것을 한 줄로".

⑦ 판정과 되돌리기

통과: 🔴 없음 + 🟠는 고쳤거나 작가가 반박으로 남기기로 함 + L 대조 통과 + F 게이트 통과(켰다면). 작가 반박은 screenplay-review-checklist의 마지막 단계다. 작가가 "의도"라고 하면 지뢰를 기둥으로 기록하고 넘어간다(결정 로그).

걸린 곳되돌릴 단계
A층(착상·주제) 🔴, L 대조 실패가 여러 단계에 걸침, "한 줄로 말이 안 됨"① 로그라인
C층(인과·구조), 막 끝(act out)이 새 질문을 안 던짐, 중간 처짐② 뼈대
B층(인물), 대사가 안 써짐(보통 인물에 잃을 것이 없음)③ 인물
D·F층(공간·리듬), 가치 전환 없는 장면, 설명 장면④ 장면·회차 설계
E층(대사·감정), 형식 위반⑤ 초고
F 게이트 실패해당 장면을 ④에서 다시 설계(사실·동의 확인 전에는 쓰지 않음)
  • 로그라인을 바꾸는 것은 작가의 결정이다. Aside는 바꿀 이유와 후보만 낸다. 바뀌면 story-bible 결정 로그에 남기고 ②부터 대조를 다시 한다.
  • 바퀴 수 제한은 없다. 다만 같은 지뢰가 두 바퀴 연속 남으면 멈추고 작가에게 "고칠까, 기둥으로 둘까"를 묻는다.

⑧ 넘기기와 기록

  1. story-bible.md 갱신(현재 단계, 결정 로그, 다음 할 일). 원고는 사용자가 고른 형식(docx 스킬, google-docs 스킬, 텍스트·Fountain 파일)으로.
  2. 다음 고리(사용자 확인 뒤):
    • 기획의도·시놉시스·공모전 제출 문서의 문장 → writing-loop(② 초안부터, 문서 경로).
    • 홍보 카피·예고 문구·포스터 → writing-loop 홍보 경로(marketingskills copywriting).
    • 쇼츠·SNS 클립 대본 → marketingskills social/video 모듈 + 이 루프의 짧은 경로.
    • 유튜브에 올릴 영상(쇼츠 드라마·정책 영상·실화 서사) → youtube-agent(원본 Jakeschincariol/youtube-agent-skill, MIT): yt-script로 첫 15초 훅(21개 공식, 채점)과 [ON SCREEN] 화면 지시를 붙이고, yt-package로 제목·썸네일, yt-chapters·yt-seo로 설명란. 긴 영상이 나오면 yt-shorts로 쇼츠를 다시 뽑는다. 훅이 약하면 ④ 장면 설계로 되돌린다.
    • 영상 제작(모션그래픽·쇼릴) → policy-media-desk 연계 표 ⑤ 확산 고리.
    • 실화·평전 서사 → 사실 근거는 writing-loop A 게이트 방식으로, 기록은 연계 표 ⑥ 기록 고리.
  3. 노하우는 references/lessons.md에 한 줄로 더한다.

판단 경계

  • 코치 모드에서는 작가의 원고 문장을 고쳐 쓰지 않는다. 진단·질문·연습만 낸다.
  • 실존 인물을 다루는 이야기는 본인(또는 유족) 동의와 사실 확인 전에 공개용 원고로 넘기지 않는다. 각색이면 각색이라고 밝힌다.
  • 기관 홍보 영상·단체장 출연물은 writing-loop D 게이트(평가로 느껴지지 않는 문체, 선거법 점검, 효과 과장 금지)를 함께 켠다. 법률 판단은 하지 않는다.
  • 작법 원저의 인용문과 screenplay-review-checklist의 원저 전문은 공개 저장소에 옮기지 않는다.

변경 이력

  • 2026-11-04 v1.1: 넘기기에 youtube-agent 고리 추가(유튜브 영상의 훅·제목·썸네일·설명란·쇼츠).
  • 2026-11-02 v1.0: 처음 만듦. screenwriting(jtydhr88)·screenplay-review-checklist(zhlmi)를 설치하고 writing-loop·marketingskills·humanize-korean·policy-media-desk와 엮음.

Related Skills