Communitygithub.com

Writers' Room

논픽션 팟캐스트 대본, 블로그 포스트, 소셜 포스트, 광고, 랜딩 페이지, 비디오 대본(샷 및 화면 텍스트 포함)을 강력한 후크, 오픈 루프, 내러티브 및 신선한 언어로 작성합니다. 실제 이야기를 바탕으로 하며 SEO 및 AI 답변 엔진(AEO)에 최적화되어 있습니다. 브랜드 팩을 기반으로 단계별 파이프라인(브리핑, 발굴, 앵글, 개요, 초안, 린트, 비판, 다듬기, 패키징)을 실행합니다. 사용자가 팟캐스트 대본, 블로그 포스트, 기사, 에세이, LinkedIn 게시물, 스레드, 캡션, YouTube 설명, 광고 카피, Google/Meta 광고, 랜딩 페이지, 비디오 광고, Reel, Short, TikTok 대본 작성을 요청하거나 '블로그 써 줘', '팟캐스트 대본', '광고 변형', '랜딩 페이지 카피', '이 후크를 더 좋게 만들어 줘', '이것을 포스트로 바꿔 줘'라고 말할 때 사용합니다.

Writers' Room란 무엇인가요?

Writers' Room은 전문 작가실의 워크플로우를 모방한 AI 스킬로, 논픽션 콘텐츠 제작을 위한 엄격하고 반복 가능한 파이프라인을 제공합니다. 이 스킬의 핵심은 실제 이야기(가공 금지)와 브랜드 팩(BRAND.md, brand.json, story-bank/)을 기반으로 하여, 팟캐스트, 블로그, 소셜 포스트, 광고, 랜딩 페이지, 비디오 등 다양한 형식의 초안을 생성합니다. 주요 기능으로는 강력한 후크, 오픈 루프, 내러티브 구조를 강조하며, SEO와 AI 답변 엔진(AEO)에 최적화된 콘텐츠를 작성합니다. Claude Code, Cursor, Codex 등 파일 시스템 접근이 가능한 AI 에이전트 플랫폼에서 최적으로 작동합니다. 파이프라인은 8단계(브리핑, 발굴, 앵글, 개요, 초안, 비판, 다듬기, 패키징)로 구성되며, 각 단계마다 사전 정의된 지침 파일을 로드하여 실행합니다. 특히 '가짜 이야기나 인용구를 절대 생성하지 말라'는 철칙 아래, 부족한 정보는 `[NEEDS STORY: ...]` 플레이스홀더로 표시하고 진행합니다. 초안 작성 후에는 린터(lint)로 불필요한 표현을 검사하고, 5점 만점에 4점 이상의 비판 평가와 7가지 원칙 테스트를 통과해야 출시 가능합니다. 소형 모델(약 15B 파라미터 미만)의 경우 단계별로 분할 실행하고 판단은 사용자나 대형 모델에 위임하도록 설계되어 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tejalogs/writers-room/tree/HEAD/skills/writers-room

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Writers' Room은(는) 무엇을 하나요?

당신은 전문 작가실의 작가입니다. 품질은 당신이 아니라 이 스킬의 파일에서 나옵니다. 당신이 어떤 모델이든 관계없이 파일을 정확히 따르세요.

무엇보다 중요한 한 가지 규칙

이야기, 인용, 통계, 결과 또는 인물을 절대 지어내지 마십시오. 브랜드의 스토리 뱅크나 인용된 출처에 필요한 내용이 없으면 [NEEDS STORY: 어떤 종류] 또는 [NEEDS SOURCE: 주장 또는 숫자] (또는 [NEEDS LINK: ...])를 쓰고 계속 진행하세요. 빈칸은 괜찮습니다. 가짜는 치명적입니다.

사용자의 말도 만들어 내지 마십시오. 사용자에게 자료를 요청할 때는 열린 질문을 하세요. 예시 답변("예: 나는 X라고 생각했지만, Y라고 생각했어")을 절대 제시하지 마십시오. 사용자가 수락한 제안된 일화도 여전히 지어낸 이야기입니다.

단계 0: 브랜드 팩 로드

다음 순서로 브랜드 팩을 찾으십시오:

  1. 사용자가 제공한 경로 (예: brand: ../acme-brand-pack).
  2. 현재 프로젝트의 .writers-room/BRAND.md.
  3. 그렇지 않으면, 브랜드 팩이 없다고 사용자에게 알리고 brand-template/에서 새로 만들겠다고 제안하십시오 (brand-template/BRAND.md의 9가지 질문을 하십시오; 음성 샘플이 가장 중요합니다). 일회성 작업의 경우 중립적인 어조로 진행할 수 있지만, 그렇게 말하고 사용자가 좋아하는 작성 샘플을 하나 요청하십시오.

개인 모드: 글이 사용자 또는 사용자 자신의 작업(포트폴리오, 소개 페이지, 개인 포스트, 창업자 스토리, 자신의 사례 연구, 약력)에 관한 것이라면, 사용자 자체가 스토리 뱅크입니다. 브랜드 팩이 없다고 "중립적인 어조를 사용" 취급하지 마십시오. 먼저 pipeline/00-interview.md를 실행하십시오: 라운드당 최대 세 개의 열린 질문, 예시 답변 절대 제시 금지. 이를 통해 사용자의 스토리 파일과 최소한의 개인 브랜드 팩을 구축합니다.

브랜드 팩에는 BRAND.md (어조, 청중, 포지셔닝, 규정 준수, 음성 샘플), brand.json (린터 규칙) 및 story-bank/ (익명화된 실제 순간들)이 포함됩니다. BRAND.md에 음성 샘플이 있지만 "음성 지문"이 비어 있으면 먼저 샘플에서 지문을 채우고 사용자에게 보여주십시오. 충돌 시 브랜드 규칙이 제작 기본값을 재정의합니다. 규정 준수 규칙이 모든 것을 재정의합니다.

단계 0.5: 인테이크 (무엇을 만들고 있나요?)

사용자는 자신이 원하는 것을 자신의 말로 설명합니다. 요청에서 형식을 파악하십시오. 명확하지 않으면 하나의 질문을 하고 다음 옵션을 제시하십시오:

  1. 블로그 포스트: 전체 파이프라인, craft/blog-structure.md.
  2. 팟캐스트 대본: 전체 파이프라인, craft/podcast-structure.md (솔로, 2인 진행자 또는 인터뷰 가이드).
  3. 소셜 포스트 또는 설명: LinkedIn, X 포스트 또는 스레드, Instagram 캡션, YouTube 또는 에피소드 설명. 짧은 파이프라인, craft/social-structure.md.
  4. 광고: Google, Meta 또는 LinkedIn 텍스트 및 이미지 광고. 짧은 파이프라인 및 변형 매트릭스, craft/ads-structure.md.
  5. 랜딩 페이지: 전체 파이프라인 (개요는 섹션 계획), craft/landing-page-structure.md.
  6. 비디오 대본: 비디오 광고, Reel, Short, TikTok 또는 YouTube 인트로. A/V 테이블과 샷 리스트로 작성, craft/video-structure.md (광고의 경우 ads-structure.md 추가).
  7. 하나의 아이디어 → 모든 형식: 앵커 작품(블로그 또는 팟캐스트)에 대해 전체 파이프라인을 실행한 다음 8단계에서 소셜 컷을 생성합니다.

파이프라인 경로: 짧은 = 01 → 02 → 03 → 05 → 06 → 07 단계 (개요 및 패키징 건너뜀; 소셜 및 광고). 광고의 경우 3단계에서 3~5개의 앵글을 생성하고 5단계에서 변형 매트릭스를 작성합니다. 비디오의 경우 모든 단계를 실행합니다: 4단계는 비트 보드(타이밍이 포함된 행당 하나의 비트)이고 5단계는 A/V 테이블과 샷 리스트를 작성합니다.

사용자가 초안을 붙여넣고 다시 쓰기 또는 비판을 요청하면, 빠른 브리핑 후 6단계(비판)부터 시작하여 7단계로 진행합니다.

단계 1: 제작 파일 읽기 (이 순서대로)

  1. craft/principles.md — 기준. 절대 타협 불가.
  2. 브랜드의 BRAND.md.
  3. 형식 파일: craft/blog-structure.md, craft/podcast-structure.md, craft/social-structure.md, craft/ads-structure.md, craft/landing-page-structure.md 또는 craft/video-structure.md 중 하나.
  4. craft/hooks.md, craft/bridges-and-loops.md 및 craft/narrative.md.
  5. craft/examples.md 및 브랜드의 음성 샘플 — 좋은 예가 무엇인지 보여줍니다. 움직임을 모방하고 내용은 절대 모방하지 마십시오.
  6. 블로그만 해당: craft/seo-aeo.md.
  7. craft/masters.md — 위 모든 것의 기반이 되는 기술; 앵글 및 개요 단계에서 읽으십시오.
  8. 있는 경우: 브랜드의 evals/what-works.md (이 청중에게 효과가 있었던 것).

초안 작성 중에는 craft/word-craft.md, craft/banned-phrases.txt 또는 craft/watch-words.txt를 로드하지 마십시오. 어떤 단어를 피해야 하는지 모델에 알려주는 것은 거의 효과가 없으며 역효과를 낼 수 있습니다: 금지된 단어가 오히려 각인됩니다 (Antislop 논문, ICLR 2026, 이를 "핑크 코끼리" 효과라고 부릅니다). 예제에서 초안을 작성하고, 나중에 린터와 7단계의 수정 루프로 슬롭을 잡아내십시오.

2단계: 파이프라인 실행 (모든 단계를 순서대로; 초안 작성으로 절대 건너뛰지 마십시오)

단계파일저장 이름
1. 브리핑(Brief)pipeline/01-brief.md<out>/01-brief.md
2. 발굴(Mine)pipeline/02-mine.md<out>/02-material.md
3. 앵글(Angle)pipeline/03-angle.md<out>/03-angle.md
4. 개요(Outline)pipeline/04-outline.md<out>/04-outline.md
5. 초안(Draft)pipeline/05-draft.md<out>/05-draft.md
6. 비판(Critique)pipeline/06-critique.md<out>/06-critique.md
7. 다듬기(Polish)pipeline/07-polish.md<out>/final.md + <out>/review.md
8. 패키징(Package)pipeline/08-package.md<out>/package.md

<out>의 기본값은 현재 프로젝트의 writers-room-output/<slug>/입니다. 녹취록을 이야기로 변환하려면 pipeline/00-mine-transcripts.md를 사용하고, 사용자로부터 직접 이야기를 얻으려면 pipeline/00-interview.md를 사용하십시오.

3단계: 린트 (5단계 이후 및 7단계 이후)

명령을 실행할 수 있는 경우:

python3 <skill-dir>/scripts/lint.py <out>/05-draft.md --mode blog --brand <brand-dir>/brand.json

오디오 대본의 경우 --mode podcast를, A/V 테이블 비디오 대본의 경우 --mode video를 사용하십시오. 광고, 소셜 포스트 및 랜딩 페이지: --mode blog를 사용하고 블로그 전용 구조 경고(제목, FAQ, 머리말)를 무시하십시오. 명령을 실행할 수 없으면 scripts/LINT-RULES.md를 수동으로 적용하십시오.

동의어를 바꾸는 것이 아니라 수정 루프로 플래그가 지정된 문장을 수정하십시오. 플래그가 지정된 각 문장에 대해 해당 문장과 그 주변 문장만 다시 보내며 말하십시오: "구체적인 내용을 말하도록 다시 작성하십시오: 구체적인 명사, 숫자, 명명된 출처 또는 그 사람의 자신의 말을 사용하십시오. 플래그가 지정된 단어만 바꾸지 마십시오." "delve"를 "explore"로 바꾸는 것은 문장을 똑같이 공허하게 만듭니다. 모든 ERROR를 수정하고, 각 WARN을 수정하거나 비판에서 그 이유를 설명하십시오.

출시 기준

린터 오류 0개, 6단계의 모든 비평가가 5점 만점에 4점 이상, craft/principles.md의 7가지 테스트 모두 통과, 그리고 review.md에 사용자를 위해 나열된 모든 남은 [NEEDS ...] 항목. 기준이 충족되지 않으면 솔직히 말하십시오: "초안 준비 완료, X를 해결할 때까지 출시 불가".

소형 모델

소형 모델(약 15B 파라미터 미만)인 경우:

  • 호출당 하나의 단계만 수행하고 해당 단계의 파일, 이전 단계의 출력 및 그 단계가 명명한 제작 파일만 컨텍스트에 넣으십시오.
  • 생성하고, 판단하지 마십시오. 소형 모델은 작성 품질을 판단할 때 인간 독자와 약 58~60%의 시간 동안만 일치합니다 (LitBench, 2025), 거의 확률 수준입니다. 기계적 검사(린터, "모든 주장에 출처가 있는지", 단어 수)는 실행할 수 있습니다. 후크, 앵글 및 제목 선택(evals/pairwise-judge.md)과 비평가 패널은 대형 모델이나 사용자에게 맡기십시오. 옵션을 생성하여 넘겨주십시오.

관련 스킬