Communitygithub.com

sociilabs/claude-content-writer

블로그 게시글, LinkedIn 게시물, 이메일 뉴스레터를 AI가 생성한 것이 아닌 인간처럼 들리는 방식으로 작성하는 Claude Code 스킬입니다.

claude-content-writer란 무엇인가요?

sociilabs/claude-content-writer는 Claude Code를 위해 설계된 전문 스킬로, 고품질의 자연스러운 어조의 텍스트 콘텐츠를 생성하는 데 중점을 둡니다. 이 스킬을 사용하면 블로그 게시글, LinkedIn 게시물, 이메일 뉴스레터를 작성할 수 있으며, 주요 장점은 AI 생성의 기계적인 느낌을 피하고 인간이 쓴 것 같은 결과물을 만들어낸다는 점입니다. Claude Code를 지원하는 모든 플랫폼에서 사용 가능하며, 프롬프트와 출력 스타일을 최적화하여 어조, 어휘, 리듬을 인간 작가의 표현에 가깝게 만듭니다. 콘텐츠 제작자, 마케터, 또는 진정성 있는 콘텐츠를 대량으로 생산해야 하는 모든 사람에게 이 스킬은 브랜드 목소리의 일관성과 친근함을 유지하면서도 글쓰기 효율성을 크게 향상시킵니다. 작동 방식은 Claude의 기본 언어 모델을 기반으로 하지만, 특수 명령어 세트를 통해 조정되어 정형화되지 않은 개인적인 스타일의 글을 강제로 생성합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add sociilabs/claude-content-writer

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

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

문서

콘텐츠 라이터 v2.0

전문 콘텐츠 생성 시스템입니다. 블로그 기사, 소셜 미디어 게시물, 이메일 콘텐츠, 웹 페이지, 랜딩 페이지, 세일즈 퍼널, 사례 연구, 제품 설명, SEO 메타데이터를 생성하며, 사람이 직접 작성한 것처럼 들리도록 합니다. — AI가 아닌.

통합:

  • ASD-STE100 Simplified Technical English — 실행 단계에서 적용되고, 검증 단계에서 린터 게이트에 의해 강제되는 문장 구성 규칙입니다. references/ste-writing-rules.md를 참조하세요.
  • claude-seo — 검증 단계에서 SEO 최적화
  • humanizer — 검증 단계에서 안티-AI 패턴 감사

참조 파일

콘텐츠를 생성하기 전에 요청된 콘텐츠 유형 및 플랫폼에 대한 관련 참조 파일을 로드하세요. 이 파일들은 최신의 연구 기반 규칙을 포함합니다.

파일로드 시점
references/content-frameworks.md계획 단계 — 프레임워크 선택
references/ste-writing-rules.md실행 단계 — 항상 (작성 규칙); 검증 단계 — 항상 (게이트 계약)
references/anti-ai-checklist.md검증 단계 — 항상
references/seo-meta-conventions.mdSEO 요구사항이 있는 모든 콘텐츠
references/web-content-conventions.md랜딩 페이지, 제품 페이지, 웹 페이지
references/email-content-conventions.md뉴스레터, 캠페인, 시퀀스
references/twitter-conventions.mdTwitter/X 트윗 및 스레드
references/facebook-conventions.mdFacebook 게시물 및 페이지
references/instagram-conventions.mdInstagram 캡션
references/sales-content-conventions.md세일즈 페이지, 퍼널, 사례 연구, 사용 후기, 제안서

현재 작업에 필요한 것만 로드하세요. 한 번에 모든 파일을 로드하지 마세요.


프로필 우선 적용

중요: 작성자 프로필 없이는 콘텐츠가 생성되지 않습니다.

사용자가 콘텐츠를 요청했지만 메모리에 프로필이 없는 경우:

"작성자 프로필을 찾을 수 없습니다. 먼저 프로필을 만들어 보세요 — 약 5분이 소요되며,
모든 콘텐츠가 AI가 아닌 사용자처럼 들리도록 만듭니다."

→ 프로필 생성 흐름 실행 (아래 프로필 생성 섹션 참조)
→ 완료 후, 원래 콘텐츠 요청으로 돌아가기

프로필이 있으면, 모든 단계를 시작하기 전에 메모리에서 로드하세요.


다섯 단계

모든 콘텐츠 요청은 이 순서를 따릅니다. 자동 진행하려면 /writer:next를 사용하세요.

논의 → 계획 → 실행 → 검증 → 출시

1단계: 논의 (/writer:discuss [topic])

목표: 키보드를 입력하기 전에 무엇을, 왜 쓸지 이해합니다.

대화식으로(딱딱한 형식이 아닌) 정보를 수집하세요:

  1. 주제 및 관점 — 핵심 요점은 무엇인가요? 특정 관점은 무엇인가요?
  2. 플랫폼 / 콘텐츠 유형 — 블로그, LinkedIn, 이메일, 세일즈 페이지 등
  3. 대상 — 구체적으로 누구인가요? 이 주제에 대해 이미 무엇을 믿고 있나요?
  4. 인식 단계 — 인지하지 못함 / 문제 인지 / 솔루션 인지 / 제품 인지
  5. 목표 — 읽은 후 독자가 무엇을 다르게 하거나 생각하기를 원하나요?
  6. 프레임워크 — 유형 + 목표에 따라 하나를 제안하고 사용자 확인
  7. 길이 및 형식 — 또는 프로필 기본값 사용
  8. 연구 입력 — 포함할 URL, 데이터 또는 출처가 있나요?
  9. CTA — 여기 적용되는 프로필의 CTA는 무엇인가요?

프레임워크 선택 가이드 (references/content-frameworks.md 참조):

  • 세일즈 페이지, 랜딩 페이지 → AIDA 또는 PASTOR
  • 문제 중심 콘텐츠, 콜드 아웃리치 → PAS
  • 변화 이야기, 사례 연구 → BAB
  • 싱크 리더십 → LEMA 또는 SCQA
  • 장문 기사 → 4-Point (Hook → Effortless → Flow → Polish)
  • 전환 중심 페이지 → CONVERT

한 문단 분량의 콘텐츠 브리핑을 출력하고 진행하기 전에 확인하세요.

상태를 메모리에 [Content Writer] Current Project - Discussion으로 저장합니다.


2단계: 계획 (/writer:plan)

목표: 쓰기 전에 상세한 개요 및 SEO 전략을 수립합니다.

  1. 메모리에서 논의 상태 로드
  2. references/content-frameworks.md 로드
  3. 이 콘텐츠 유형에 대한 플랫폼별 규칙 파일 로드
  4. URL이 제공된 경우, 가져와서 핵심 통찰력 추출
  5. 상세 개요 작성: 섹션 제목, 섹션별 핵심 요점, 예시, 데이터, 사회적 증거, CTA 배치
  6. 해당되는 경우 SEO 전략 정의: 기본 키워드, 보조 키워드, 메타 제목, 메타 설명, URL 슬러그
  7. 개요를 제시하고 진행하기 전에 확인

상태를 메모리에 [Content Writer] Current Project - Plan으로 저장합니다.


3단계: 실행 (/writer:execute)

목표: 계획과 브랜드 보이스에 따라 콘텐츠를 작성합니다.

  1. 메모리에서 계획 및 작성자 프로필 로드
  2. 관련 플랫폼 규칙 참조 파일 로드
  3. 프로필에 블로그 URL이 있는 경우, 최근 게시물 1~2개를 가져와 보이스 조정
  4. 계획 개요에 따라 섹션별로 작성

문장 구성은 STE 법칙을 따릅니다 (references/ste-writing-rules.md). 쓰기 전에 로드하세요. 핵심 규칙:

  • 능동태. 문장당 하나의 아이디어. 25단어 미만 목표 (SEO 메타데이터 및 운영 이메일의 경우 20/25단어 상한선).
  • 평이한 단어 사용: use (utilize/leverage 대신), help (facilitate 대신), make sure (ensure 대신), start (commence/initiate 대신).
  • 명사화 대신 동사 사용: "analyze the log" ("perform an analysis" 대신).
  • 구동사, 세미콜론, 축약형 사용 금지.
  • 마케팅 형용사 및 금칙어 제로 — 모든 콘텐츠 유형에 대해 검증 게이트에서 실패합니다.

핵심 작성 원칙 (법칙 위에 더해지는 보이스):

  • 구체적 > 모호함 — 구체적인 숫자, 이름, 예시 사용
  • 말로 설명하지 말고 보여주세요 — 시나리오와 이야기 사용
  • 문장 길이에 변화를 주어 버스트성 확보 — 단어 상한선은 목표치가 아닌 최대치입니다.
  • 자연스러운 키워드 배치 — 키워드 스터핑 없는 SEO
  • 모든 CTA는 1인칭: "Start my project" ("Start your project" 대신)

플랫폼 서식은 규칙 참조 파일에 따릅니다. 로드하여 따르세요.

작성 중 피해야 할 안티-AI 패턴 (전체 목록은 references/anti-ai-checklist.md 참조):

  • 남용되는 단어: leverage, seamless, robust, pivotal, delve, realm, foster, crucial
  • Em dash 과도 사용 (—)
  • 삼단 구조의 남용
  • 서두를 늘이는 표현 ("In today's digital landscape...")
  • 일반적인 결론 ("In conclusion, it's clear that...")
  • 모호한 출처 표시 ("Studies show...")
  • 동일한 문장 시작을 가진 병렬 목록 구조
  • 부정 병렬 구조 ("It's not just X — it's Y")

초안을 제시하고 진행하기 전에 확인하세요.

상태를 메모리에 [Content Writer] Current Project - Draft로 저장합니다.


4단계: 검증 (/writer:verify)

목표: STE 준수 게이트 + SEO 확인 + 출시 전 안티-AI 감사.

이 단계에서는 항상 references/ste-writing-rules.md 및 references/anti-ai-checklist.md를 로드하세요.

STE 준수 게이트 (필수 — 차단):

  • 초안에 대해 node scripts/ste-lint.js --gate=<platform> <draft-file>을 실행하세요.
  • 린터는 플랫폼/형식에서 등급을 결정하고 임계값을 적용합니다. PASS 시 0, FAIL 시 1을 반환합니다.
  • 모든 등급에서 하드 제로: marketing_adjective == 0 및 banned_word == 0.
  • 임계값: strict (total == 0), prose (total_per100w <= 3.0), social (total_per100w <= 4.0); em 대시는 등급별로 제한됩니다.
  • FAIL인 경우: references/ste-writing-rules.md에 따라 초안을 수정하고, 다시 실행하고, PASS가 될 때까지 반복하세요. 임계값을 낮추거나, 게이트를 건너뛰거나, 실패한 초안을 출시하지 마세요.
  • 프로젝트 상태에 ste_gate: pass 및 ste_per100w를 기록하세요. ste_gate가 pass가 아니면 출시가 실행되지 않습니다.

SEO 확인 (claude-seo):

  • claude-seo 사용 가능 여부 확인
  • 가능한 경우: 분석 실행, 결과 제시, 권장 사항 적용
  • 불가능한 경우: 경고 메시지와 함께 건너뛰고 수동 SEO 체크리스트 제공

안티-AI 감사 (humanizer):

  • humanizer 사용 가능 여부 확인
  • 가능한 경우: 감사 실행, AI 패턴 개수 제시, 수정 적용
  • 불가능한 경우: 수동 감사를 위해 references/anti-ai-checklist.md 사용

수동 품질 체크리스트:

  • 논의 단계에서 명시된 목표 달성
  • 선택한 프레임워크 구조 준수
  • 프로필의 브랜드 보이스와 일치
  • 모든 주장이 구체적임 (모호한 최상급 표현 없음)
  • 사회적 증거가 이름과 직함으로 표시됨
  • CTA가 1인칭이고 행동에 특화됨
  • AI 작성 패턴이 남아 있지 않음

결과를 제시하고 진행하기 전에 수정을 적용하세요.

검증된 상태를 메모리에 [Content Writer] Current Project - Verified로 저장합니다.


5단계: 출시 (/writer:ship)

목표: 파일로 저장하고 게시 노트와 함께 제공합니다.

출력 경로: content-writer-output/[type]/[NNN]-[slug].md

디렉토리 구조:

content-writer-output/
├── profile/           (PROFILE.md, PRODUCTS.md, CTAS.md, CASE-STUDIES.md)
├── blog/
├── linkedin/
├── facebook/
├── instagram/
├── twitter/
├── email/
├── sales/
├── seo/
└── packages/[name]/   (multi-platform packages)

포함할 프론트매터:

---
title: [Title]
platform: [Platform]
framework: [Framework used]
word_count: [Count]
created: [Date]
author: [From profile]
status: draft
seo:
  meta_title: [Meta title]
  meta_description: [Meta description]
  keywords: [Keywords]
---

게시 노트는 플랫폼별로 다릅니다. 주요 알림:

  • 블로그: CMS에 업로드, 추천 이미지 추가, 태그 설정
  • LinkedIn: 링크는 첫 번째 댓글에, 화목 오후 126시에 게시, 첫 1시간 내 댓글에 답변
  • Twitter/X: 스레드로 게시, 링크는 마지막 트윗 또는 첫 번째 답글에 (본문에는 절대 넣지 않음), 첫 1시간 내 답변
  • Facebook: 링크는 첫 번째 댓글에, 화수 오후 128시에 게시, 첫 1시간 내 모든 댓글에 답변
  • 이메일: 수신 거부 링크 확인, 보내기 전에 모바일에서 렌더링 테스트

출시 후 메모리에서 프로젝트 상태를 지웁니다. 프로필은 메모리에 유지합니다.


자동 진행 (/writer:next)

메모리에서 현재 단계를 감지하고 다음 단계를 자동으로 실행합니다:

  • 프로젝트 없음 → "/writer:discuss를 사용하여 시작하세요"
  • 논의 있음, 계획 없음 → /writer:plan 실행
  • 계획 있음, 초안 없음 → /writer:execute 실행
  • 초안 있음, 검증 없음 → /writer:verify 실행
  • 검증 있음 → /writer:ship 실행

프로필 생성 (/writer:profile-create)

완전한 프로필은 약 5분이 소요되며 10가지 주제를 다룹니다. 대화식으로 실행하세요 — 딱딱한 번호 형식이 아닙니다. 관련 질문을 그룹화하고 빠르게 진행하세요.

1단계: URL 스캔 (선택 사항)

톤 감지를 위해 기존 콘텐츠 분석을 제안합니다:

"분석할 URL이 있나요? — 블로그 게시물, LinkedIn 기사, 작성한 모든 것.
예시가 많을수록 톤 매칭이 더 좋아집니다."

각 URL을 가져와서 다음을 분석합니다: 문장 길이 패턴, 어휘 수준, 성격 표시, 서식 선호도. 감지된 톤 프로필을 제시하고 확인합니다.

2단계: 10가지 주제 설문지 (대화식, 주제별 그룹화)

다음 주제에 걸쳐 수집합니다 — 사용자가 제공하는 내용에 따라 흐름을 조정하세요:

  1. 브랜드 아이덴티티 — 이름/직함, 회사, 도메인, 회사가 하는 일 (1~2문장)
  2. 산업 및 시장 — 산업/틈새, 2~3개 경쟁사, 고유 포지셔닝
  3. 대상 청중 — 주요 청중 (구체적으로), 그들의 고충, 목표, 반론
  4. 보이스 및 톤 — 3~5개 형용사, 존경하는 작가/블로그, 피해야 할 것
  5. 콘텐츠 전략 — 콘텐츠 유형, 3~5개 콘텐츠 기둥, 주요 목표 (인지도/리드/전환/싱크 리더십)
  6. 제품 및 서비스 — 각 항목: 이름, 1문장 설명, 대상 고객, 주요 이점, 가격 범위 (선택 사항)
  7. 사례 연구 — 각 항목: 클라이언트/프로젝트, 과제, 솔루션, 지표가 있는 결과, 공개적으로 언급 가능?
  8. CTA — 각 항목: 플랫폼, CTA 텍스트, URL
  9. 게시 워크플로우 — 게시 위치, 승인 프로세스, 선호하는 출력 형식
  10. SEO 전략 — 타겟 키워드 (5~10개), SEO 우선 순위 수준, 모든 제약 조건

3단계: 확인 및 저장

전체 프로필 요약을 제시합니다. 확인 시:

  • 메모리에 저장: [Content Writer] Writer Profile
  • 파일에 저장: content-writer-output/profile/PROFILE.md, PRODUCTS.md, CTAS.md, CASE-STUDIES.md

기타 명령어

/writer:profile-view — 메모리 또는 프로필 파일에서 현재 프로필 표시

/writer:profile-edit — 특정 필드 편집 (제품, CTA, 사례 연구, 톤)

/writer:profile-delete — 메모리 및 파일에서 프로필 삭제 (삭제 전 확인)

/writer:status — 현재 단계, 프로필 상태, 종속성 가용성, 다음 단계 표시

/writer:help — 모든 명령어 및 빠른 시작 안내 표시

/writer:update — npm 레지스트리에서 업데이트 확인, 변경 로그 미리보기 표시, 업그레이드 전 확인


업데이트 확인

각 세션의 첫 번째 명령어 시 (한 번만):

  1. ~/.claude/skills/content-writer/.version 읽기
  2. npm view claude-content-writer version 확인
  3. 최신 버전이 존재하고 이 세션에 표시되지 않은 경우, 다음을 표시:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  📦 콘텐츠 라이터 업데이트 가능
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  현재: v{current}  →  최신: v{latest}
  업그레이드하려면 /writer:update를 실행하세요.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

세션 메모리에 표시됨으로 표시합니다. 그런 다음 사용자의 명령어를 계속 진행합니다.


우아한 성능 저하

claude-seo 또는 humanizer를 사용할 수 없는 경우:

⚠ 참고: [dependency]를 사용할 수 없습니다. [Check]를 건너뜁니다.
콘텐츠는 계속 생성됩니다. 전체 품질 보증을 위해 종속성을 설치하세요.

humanizer 확인을 위한 수동 대체로 references/anti-ai-checklist.md를 사용하세요. claude-seo를 위한 대체로 기본 SEO 체크리스트(제목에 키워드, 메타 설명 존재, H1 존재)를 사용하세요.


저장 패턴

메모리 — 런타임 빠른 액세스. 저장: 작성자 프로필, 현재 프로젝트 상태(... [번역을 위해 축약됨]

[마크다운 구조 유지, 전체 내용 번역 완료]

관련 스킬