Communitygithub.com

카피 작성 (후크 · 스크립트 · 캡션)

스크롤을 멈추게 하는 후크, 프레임워크 기반 스크립트, 플랫폼에 최적화된 캡션과 해시태그를 작성합니다. 사용자가 후크 아이디어, 영상/광고 스크립트, 광고 카피, 게시물 캡션을 필요로 하거나 "뭐 올리지?", "스크립트 써줘", "후크 알려줘", "캡션 써줘"라고 말할 때 사용하세요.

카피 작성 (후크 · 스크립트 · 캡션)란 무엇인가요?

이 스킬은 검증된 다이렉트 리스폰스 프레임워크를 사용하여 후크(hook), 스크립트(script), 캡션(caption)을 생성하는 전문 마케팅 카피라이팅 도구입니다. 사용자는 먼저 다양한 앵글의 후크 옵션을 살펴보고 1-2개를 선택한 후, PAS, AIDA, BAB 등 목적에 맞는 프레임워크로 전체 스크립트를 작성합니다. 마지막으로 각 플랫폼(TikTok, Instagram, YouTube, Facebook)별 규격에 맞는 게시용 캡션과 해시태그를 생성합니다. 프로젝트의 `project.md`와 `brand.md`에서 브랜드 톤, 제약 사항을 자동으로 참고하며, 기존 잘 된 예시가 있다면 등록해두고 스타일을 일관되게 유지합니다. CLI 기반 워크플로우(`node workflows/cli.cjs generateHooks/generateScript/generateCaption`)로 모든 기능을 명령형으로 호출할 수 있으며, 생성된 voiceover 텍스트는 음성 생성 스킬로, visual 큐는 스토리보드/영상 생성 스킬로 연결되어 확장 가능한 파이프라인을 구성합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/minkhant1996/soemind-forge/tree/HEAD/skills/write-copy

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

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

문서

카피 작성 (후크 · 스크립트 · 캡션)은(는) 무엇을 하나요?

창작의 병목은 미디어를 생성하는 것이 아니라 무엇을 말할지 아는 데 있습니다. 이 스킬은 검증된 다이렉트 리스폰스 프레임워크를 사용하여 후크, 스크립트, 캡션을 생성하고 사용자가 선택하고 다듬을 수 있도록 합니다. 워크플로 명령어로 구동됩니다 — 스크립트를 작성하지 말고 CLI를 호출하세요:

node workflows/cli.cjs generateHooks '<json-args>'     # generateScript, generateCaption도 동일

아래에 표시된 TypeScript 호출 시그니처는 각 명령어의 인수를 문서화합니다 — 이를 node workflows/cli.cjs <command> '<json-args>'로 변환하고 새 파일에 붙여넣지 마세요.

프로젝트 컨텍스트가 있을 때 먼저 가져와서(project.md의 대상 고객/페인 포인트/제안; brand.md의 톤/제한 사항) 카피가 브랜드에 맞고 restrictions를 위반하지 않도록 하세요.


STEP 0: 카피를 작성하기 전에 참조 예시를 확인하세요

목소리 일관성은 형용사가 아닌 예시에서 비롯됩니다. 후크, 스크립트 또는 캡션을 생성하기 전에:

  1. 레지스트리에서 저장된 카피 예시를 확인하세요:
    node workflows/cli.cjs resolveAsset '["{name}","style-copy"]'   # 카피 예시를 보관하는 style_references ID
    cat projects/{name}/assets/style/copy-examples.md 2>/dev/null
    cat projects/{name}/style-samples/caption-examples/*.md 2>/dev/null   # 사용자의 드롭 인박스
    
    찾은 경우 → 패턴(문장 길이, 이모지 사용, 해시태그 스타일, CTA 표현, 격식 수준)을 추출하여 아래에서 작성하는 모든 항목에 반영하세요.
  2. 저장된 것이 없으면 → 한 번만 물어보세요:

    "과거에 잘 반응했던 게시물, 캡션 또는 스크립트가 있나요? 아니면 카피 스타일이 마음에 드는 계정이 있나요? 1-3개의 예시를 붙여넣어 주세요(또는 '없음' — brand.md를 참고하겠습니다)."

    • 예시를 제공하면 → projects/{name}/assets/style/copy-examples.md에 저장하고 등록하세요(registerAsset '["{name}","style_references",...]'). 향후 작업이 이를 재사용합니다.
    • "없음" → brand.md의 톤을 따라 진행하고 어떤 톤 가정을 했는지 명시하세요.
  3. 예시가 있는 경우, 카피가 어떤 참조와 일치하는지 prompts.txt에 기록하세요.

STEP 1: 후크 (전체를 작성하기 전에 앵글을 선택하세요)

다양한 앵글의 후크 스프레드를 생성하고 사용자가 1-2개를 선택하여 구축할 수 있도록 하세요.

node workflows/cli.cjs generateHooks '{"topic":"AI 학습 플래너 앱","audience":"기말고사를 준비하는 대학생","painPoint":"복습을 어디서 시작할지 모름","platform":"tiktok","count":8}'
# h.data.hooks: [{ text, angle }]  — angles: problem | curiosity | result | contrarian | question | stat | story

앵글별로 그룹화하여 보여주고 어떤 것을 사용할지 물어보세요. 자동 선택하지 마세요 — 후크가 전체 내용을 결정합니다.


STEP 2: 스크립트 (프레임워크 기반, 시간에 맞춤)

후크가 선택되면 목표에 맞는 프레임워크로 스크립트를 작성합니다:

프레임워크가장 적합한 용도
hook-retain-reward숏폼 비디오 (TikTok/Reels/Shorts) — 기본값
PAS (Problem-Agitate-Solution)페인 리드 광고
AIDA (Attention-Interest-Desire-Action)클래식 다이렉트 리스폰스
BAB (Before-After-Bridge)변화 / 결과
star-story-solution사용후기 / 창업자 스토리
# hook: generateHooks에서 선택한 후크 텍스트 전달
node workflows/cli.cjs generateScript '{"brief":"60초 안에 복습 일정을 만드는 AI 학습 플래너","framework":"PAS","platform":"tiktok","durationSeconds":30,"hook":"<선택한 후크 텍스트>","cta":"무료로 체험하기 — 링크 인 바이오"}'
# s.data: { framework, sections:[{label, voiceover, visual}], wordCount, estimatedDurationSeconds }

스크립트를 레이블이 지정된 섹션(음성 해설 + 시각적 큐)과 예상 시간으로 보여주세요. estimatedDurationSeconds가 목표와 크게 차이가 나면 사용자가 다듬거나 확장할 수 있도록 알리세요. 이 voiceover 텍스트는 generateVoiceover()에 직접 전달되고, 장면별 visual 큐는 generateStoryboard() / 비디오 스킬에 전달됩니다.


STEP 3: 캡션 (게시 준비 완료, 플랫폼별)

마지막 단계 — 비디오/이미지와 함께 실제로 게시되는 포스트 카피 + 해시태그입니다.

node workflows/cli.cjs generateCaption '{"topic":"AI 학습 플래너 앱","platform":"instagram","tone":"친근하고 자신감 있는","cta":"링크 인 바이오","count":3}'   # platform: tiktok | instagram | youtube | facebook
# c.data.captions: [{ text, hashtags:[] }]

콘텐츠가 여러 플랫폼에 교차 게시되는 경우 플랫폼별 변형을 생성하세요(각 플랫폼마다 길이 및 해시태그 규범이 다릅니다). 선택한 캡션을 출력물 옆에 저장하세요(예: projects/{name}/output-contents/.../caption.md).


연결 방식

generateHooks → pick → generateScript → { voiceover → generateVoiceover,
                                          visual cues → generateStoryboard → video }
                                       → generateCaption → caption.md

항상 제안하고 확인하세요 — 옵션을 제시하고, 이유와 함께 하나를 추천하며, 사용자가 편집할 수 있도록 하세요. 통계/사용후기를 만들어내지 마세요(실제 것만 project.md에서 가져오세요).

관련 스킬