Communitygithub.com

음성 빌더

사용자와의 인터뷰와 샘플 분석을 통해 개인화된 작문 목소리 프로필을 구축하는 스킬입니다.

음성 빌더란 무엇인가요?

Voice Builder는 사용자 인터뷰와 작성 샘플 분석을 통해 개인화된 작문 목소리 프로필을 만드는 AI 에이전트 스킬입니다. Codex 및 Claude 런타임을 지원하며, 사용자 선택 프로젝트 내에서 'about-me.md'와 'voice.md' 파일을 생성합니다. 이 스킬은 사용자가 자신만의 독특한 작문 스타일을 체계화하고 일관된 브랜드 음성을 유지할 수 있도록 돕습니다. 작동 방식은 6단계로 구성되며, 자동 시작되어 첫 메시지로 인터뷰를 진행하고, 샘플 분석을 통해 어조, 문장 리듬, 훅 패턴, 서명 표현 등을 추출합니다. 특히 사용자가 제공한 샘플에서만 패턴을 학습하고, 없는 패턴을 만들어내지 않으며, 최소 3개의 샘플이 필요합니다. 생성된 프로필은 추후 게시물 작성, 그래픽 디자인, 프로필 최적화 등 다른 스킬에서 참조됩니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlie947/social-media-skills/tree/main/skills/voice-builder

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

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

문서

Voice Builder

Codex 및 Claude 런타임

  • Codex 또는 Claude에서 이 스킬을 사용할 때는 현재 태스크에서 실제로 사용 가능한 도구를 사용하십시오. AskUserQuestion 예제는 질문을 설명하며 필수 API가 아닙니다. 사용 가능한 질문 도구를 한도 내에서 사용하거나 채팅으로 질문하십시오. 이미 제공된 답변과 소스 자료를 재사용하십시오.
  • 사용자가 선택한 프로젝트에서 작업하십시오. 개인화 작업 전에 about-me.md, voice.md 및 관련 브랜드 파일을 읽으십시오. 파일에 충돌이 있거나 기본값이 포함된 경우 의도된 작성자를 확인하십시오. 누락된 사실을 묻거나 voice-builder를 실행하십시오. 유지관리자의 신원, 계정 또는 개인 파일을 절대 상속하지 마십시오.
  • 번들된 references/는 이 스킬 폴더를 기준으로 해석하십시오. 명시적으로 요청된 프로필 새로고침의 경우, 정식 about-me.md, voice.md 또는 newsletter-voice.md를 제자리에서 읽고 업데이트하며, 관련 없는 사용자 사실과 규칙은 보존하십시오. 소비자는 해당 정식 파일을 다시 읽어야 합니다. 기존의 관련 없는 파일과 충돌할 수 있는 새 결과물에만 새 파일 이름을 사용하십시오. 설치만으로는 인터뷰를 시작하거나 파일을 쓰지 않습니다. 요청되지 않은 지속적 학습 내용을 작성하지 마십시오.
  • 먼저 제공된 증거를 사용하십시오. 필요할 때 사용 가능한 검색/소스 도구를 통해 외부 주장을 검증하십시오. 소스 또는 통합을 사용할 수 없는 경우, 누락된 기능의 이름을 지정하고 제공된 텍스트/내보내기 입력을 제안하십시오. 사실, 1인칭 경험, 지표 또는 성공적인 도구 실행을 절대 만들어내지 마십시오.
  • 선택한 경로에 필요한 서비스만 사용자의 기존 계정을 통해 연결하십시오. 자격 증명을 절대 출력하거나 연결을 덮어쓰지 마십시오. 초안 작성, 저장 및 검토는 게시, 메시지 전송 또는 계정 변경을 승인하지 않습니다.

중요: 로드 시 자동 시작

사용자가 이 워크플로우를 요청하면 1단계를 시작하십시오. 즉, 사용자에게 보내는 다음 메시지는 인터뷰 질문이어야 합니다. 다른 것은 안 됩니다.

하지 말아야 할 것:

  • 이 스킬 요약
  • 생성하는 파일 설명
  • 작동 방식 설명
  • "이 스킬이 포함하는 내용은 다음과 같습니다"라고 말하기
  • 사용자가 실행할지 묻기
  • 설치 확인
  • "지금 실행하시겠습니까?"와 같은 옵션 제공

해야 할 것:

  • 바로 1단계로 이동
  • 인터뷰 질문을 첫 번째이자 유일한 응답으로 보내기

이는 사용자가 자신의 음성을 구축하거나 해당 목적을 위한 샘플을 제공할 때 적용됩니다. 서문 없음. 요약 없음. 먼저 인터뷰.

1단계. About Me 인터뷰 실행

위의 런타임 지침을 사용하여 질문하십시오. 질문 도구를 사용할 수 있는 경우 해당 스키마 및 배치 제한을 준수하십시오. 그렇지 않으면 채팅에서 동일한 질문을 하십시오.

AskUserQuestion은 호출당 최대 4개의 질문을 지원하므로 두 번의 호출로 보냅니다: 먼저 배치 1, 답변을 기다린 다음 배치 2.

배치 1 (가장 첫 번째 작업, 앞에 텍스트 없음)

다음 질문을 사용하고 필요에 따라 도구 스키마를 조정하십시오:

[
  {
    "question": "이름과 하는 일은 무엇인가요?",
    "header": "About you",
    "multiSelect": false,
    "options": [
      {"label": "창업자", "description": "자신의 회사나 컨설팅을 운영합니다"},
      {"label": "마케팅 책임자", "description": "회사에서 마케팅을 이끕니다"},
      {"label": "크리에이터", "description": "콘텐츠 제작이 주업입니다"},
      {"label": "영업 리더", "description": "영업팀을 이끌거나 비즈니스 개발을 담당합니다"}
    ]
  },
  {
    "question": "누구를 위해 글을 쓰시나요?",
    "header": "Audience",
    "multiSelect": false,
    "options": [
      {"label": "창업자 및 CEO", "description": "회사를 운영하는 의사 결정권자"},
      {"label": "마케터", "description": "모든 수준의 마케팅 전문가"},
      {"label": "구직자", "description": "다음 역할을 찾는 사람들"},
      {"label": "기타 전문가", "description": "완전히 다른 그룹"}
    ]
  },
  {
    "question": "본인을 알리고 싶은 3~5가지 주제는 무엇인가요?",
    "header": "Topics",
    "multiSelect": true,
    "options": [
      {"label": "AI 및 자동화", "description": "AI 도구가 업무를 어떻게 변화시키는가"},
      {"label": "마케팅", "description": "전략, 콘텐츠, 성장"},
      {"label": "리더십", "description": "관리, 채용, 문화"},
      {"label": "개인 브랜드", "description": "청중 구축 및 평판"}
    ]
  },
  {
    "question": "업계에 대한 본인의 관점, 즉 다른 사람들은 믿지 않지만 본인이 믿는 것은 무엇인가요?",
    "header": "Hot take",
    "multiSelect": false,
    "options": [
      {"label": "대부분의 조언은 틀렸다", "description": "업계의 합의가 깨졌습니다"},
      {"label": "사람들이 너무 복잡하게 생각한다", "description": "답은 사람들이 생각하는 것보다 더 간단합니다"},
      {"label": "큰 변화가 다가오고 있다", "description": "무언가 곧 바뀔 것이며 대부분의 사람들이 준비되지 않았습니다"}
    ]
  }
]

배치 2 (배치 1 답변이 돌아오면 즉시, 사이에 논평 없이 보내기)

AskUserQuestion을 다시 호출합니다:

[
  {
    "question": "사람들이 당신의 이름을 볼 때 생각했으면 하는 한 가지는 무엇인가요?",
    "header": "Brand promise",
    "multiSelect": false,
    "options": [
      {"label": "이 사람은 실용적이다", "description": "즉시 사용할 수 있는 것을 제공합니다"},
      {"label": "이 사람은 정직하다", "description": "다른 사람이 말하지 않을 것을 알려줍니다"},
      {"label": "이 사람은 앞서 있다", "description": "다른 사람보다 먼저 다가올 것을 봅니다"}
    ]
  },
  {
    "question": "절대 쓰지 않을 한 가지 주제는 무엇인가요?",
    "header": "Off limits",
    "multiSelect": false,
    "options": [
      {"label": "정치", "description": "정치적 논평은 절대 하지 않습니다"},
      {"label": "개인 생활", "description": "전문적인 내용만 유지합니다"},
      {"label": "경쟁사", "description": "다른 사람이나 브랜드의 이름을 언급하거나 비난하지 않습니다"}
    ]
  }
]

두 배치 모두 답변된 후 2단계로 이동하십시오. 답변이 비어 있거나 건너뛰어진 경우, 해당 질문을 채팅에서 한 번 더 물어본 후 진행하십시오.

2단계. about-me.md 작성

프로젝트 루트에 about-me.md를 만드십시오. 다음 구조를 사용하십시오:

# About Me

## 이름 및 역할
[질문 1에서]

## 청중
[질문 2에서, 독자가 누구인지 2~3문장으로 확장]

## 주제 기둥
[질문 3의 3~5개 주제, 각각 한 줄]

## 관점
[질문 4에서, 반대적이거나 독특한 신념을 명확한 문장으로 작성]

## 브랜드 약속
[질문 5에서, 작성자가 독자의 머릿속에 각인시키고 싶은 한 가지 생각]

## 금지 사항
[질문 6에서, 절대 쓰지 않을 주제나 관점]

300단어 미만으로 유지하십시오. 모든 줄은 어시스턴트가 글을 쓸 때 참조할 수 있는 내용이어야 합니다.

3단계. 샘플 요청

다음과 같이 말하십시오:

이제 배우고 싶은 글 3~5개를 붙여넣어 주세요. LinkedIn 게시물, 뉴스레터 호, 에세이, 블로그 게시물, 이메일, 트윗 또는 게시한 다른 어떤 글이든 가능합니다. 본인의 글이거나 음성을 존경하는 다른 사람의 글일 수 있습니다. 한 번에 하나씩 또는 한꺼번에 보내주세요. 준비된 샘플이 없으면 "use samples"를 입력하시면 나중에 교체할 수 있는 시작 세트를 불러오겠습니다.

사용자가 붙여넣을 때까지 기다리십시오. 분석으로 이동하기 전에 최소 3개의 샘플이 필요합니다. 3개 미만으로 붙여넣으면 더 요청하십시오.

사용자가 "use samples"를 입력하면 이 스킬 폴더 내의 references/sample-content.md에서 글을 불러오십시오. 사용자에게 샘플이 어떤 작성자의 것인지 알려주어 어떤 음성을 빌리는지 알 수 있게 하십시오. 나중에 자신의 글로 교체할 수 있음을 상기시키십시오.

4단계. 샘플 분석

모든 샘플을 읽으십시오. 한 작품의 개별적인 특성이 아닌, 모든 샘플에 걸친 패턴을 찾으십시오. 다음을 추출하십시오:

음성 신호

  • 평균 문장 길이
  • 단락 리듬 (한 줄 바꿈, 빈 줄, 단문 대 유려함)
  • 훅 또는 도입부 스타일 (반대적, 질문, 데이터 포인트, 이야기, 고백, 관찰)
  • 관점 (1인칭, 2인칭, 관찰적)
  • 어조 (무표정, 따뜻함, 직설적, 장난기, 냉철함)
  • 특징적인 구문 또는 반복 단어
  • CTA 또는 마무리 스타일

구조적 신호

  • 길이 범위
  • 목록 대 산문
  • 시작 방식, 마무리 방식
  • 전환 처리 방식

주제 신호

  • 여러 샘플에 걸쳐 등장하는 주제
  • 청중이 누구인지
  • 작성자가 지지하는 것

부재 신호

  • 일관되게 없는 단어 및 구두점 (예: 5개 샘플 중 0개에서 em 대시 사용)
  • 작성자가 절대 사용하지 않는 훅 유형
  • 작성자가 절대 사용하지 않는 어조
  • 작성자가 피하는 구조

5단계. voice.md 작성

프로젝트 루트에 voice.md를 만드십시오. 이는 음성이 어떻게 쓰는지와 음성이 피하는 것을 모두 다루는 통합 프로필입니다. 별도의 음성 파일은 없습니다.

# Voice Profile

## 내가 어떤 사람처럼 들리는지
[전체적인 음성을 평이한 언어로 2~3문장으로 설명]

## 어조
[음성이 일관되게 사용하는 3~5가지 속성, 그 다음 샘플의 간격에서 도출된 음성이 절대 사용하지 않는 1~2가지 어조]

## 문장 리듬
[평균 길이, 속도, 단락 구조. 회피 패턴 포함: 예: never staccato fragments, never tricolons, no sentences over 25 words]

## 훅 패턴
[관찰된 3~5가지 훅 유형, 각각 샘플에서 하나의 예시 포함. 모든 샘플에서 없는 훅 유형 기록, 예: never rhetorical questions, never "imagine a world where"]

## 시작 방식
[1~2문장. 샘플 전반에 명확한 회피 패턴이 있는 경우 음성이 피하는 시작 동작 기록]

## 마무리 방식
[1~2문장, CTA 스타일 포함. 음성이 피하는 마무리 동작 기록, 예: never motivational summaries, never "in conclusion"]

## 특징적인 구문
[샘플에서 반복되는 단어 또는 구문]

## 금지 사항
[모든 샘플에 없는 단어, 구두점 또는 구성. 샘플이 명확히 피하는 항목만 나열하십시오. 예: no em dashes (0 of 5 samples), no hashtags, no corporate jargon by name]

## 이 음성이 절대 하지 않는 것
[샘플의 간격에서 도출된 3~5가지 특정 행동. 구체적으로 작성하십시오. 샘플이 "not X, but Y" 구성을 절대 사용하지 않으면 나열하십시오. 특정 어휘 세트를 피하는 경우 단어 이름을 지정하십시오]

실제 샘플에서 모든 섹션을 채우십시오. 일반적인 내용을 채우지 마십시오. 패턴이 없으면 그렇게 말하십시오. about-me.md의 청중이나 주제 기둥을 중복하지 마십시오.

명시적인 사용자 금지 사항과 이 작은 샘플에서 단순히 없는 패턴을 구분하십시오. 후자는 잠정적이라고 표시하고 샘플 개수를 포함하십시오. 부재만으로는 영구적인 금지를 설정하지 않습니다. 시작 샘플은 빌린 스타일을 설명하며, 사용자의 경험이나 확립된 음성을 설명하지 않습니다.

6단계. 확인 및 인계

사용자에게 말하십시오:

음성 프로필이 구축되었습니다. 이제 프로젝트에 about-me.md와 voice.md 두 개의 파일이 있습니다. 이 프로젝트에서 이 스킬이 호출될 때 두 파일을 모두 읽습니다. 새 태스크는 스킬을 발견하고 동일한 프로젝트 컨텍스트를 사용해야 합니다. 언제든지 파일을 열고 편집할 수 있습니다.

이제 준비되었습니다. 다음을 할 수 있습니다:

  • "build my newsletter voice"라고 말하여 뉴스레터 전용 작성 지침 생성
  • "write a post"라고 말하여 LinkedIn 게시물 초안 작성
  • "design a graphic"이라고 말하여 게시물용 시각 자료 생성
  • "score my post"라고 말하여 초안에 대한 피드백 받기
  • "optimize my profile"이라고 말하여 LinkedIn 프로필 재구축

각각은 별도의 스킬입니다. 하나를 선택하고 시작하십시오.

이 스킬이 생성하는 것

프로젝트 루트에 두 개의 파일:

  1. about-me.md: 사용자가 누구인지, 청중, 주제 기둥, 관점
  2. voice.md: 통합 음성 프로필, 긍정 신호 (음성이 쓰는 방식)와 부재 신호 (음성이 피하는 것)를 하나의 문서로 포함

규칙

  • 이 스킬이 트리거되면 바로 1단계로 이동하십시오. 요약, 설명, 서문 없음.
  • 샘플 콘텐츠는 항상 코드 블록 안에 출력하여 사용자가 줄 바꿈이나 공백을 잃지 않고 정확한 형식을 복사하여 붙여넣을 수 있도록 하십시오. 언어 태그가 없는 일반 코드 블록 (삼중 백틱)을 사용하십시오.
  • 샘플에 있는 내용을 기반으로 작업하십시오. 없는 패턴을 만들어내지 마십시오.
  • 패턴 감지를 위해 최소 3개의 샘플. 3개 미만이면 더 요청하십시오.
  • 샘플이 서로 모순되는 경우, voice.md에서 모순을 매끄럽게 만들지 말고 기록하십시오.
  • about-me.md를 300단어 미만으로 유지하십시오.
  • voice.md를 500단어 미만으로 유지하십시오.
  • 샘플이 명확히 미국식이 아닌 이상 영국 영어를 사용하십시오.
  • 출력 파일이나 초안에서 em 대시를 절대 사용하지 마십시오.
  • 별도의 부재 프로필을 만들지 마십시오. 부재 신호는 voice.md 안에 있습니다.

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

관련 스킬