create-crush

create-crush 스킬 개요

create-crush 스킬이 실제로 하는 일

create-crush 스킬은 Claude Code용 스킬로, 개인적인 원자료를 한 사람을 위한 재사용 가능한 캐릭터 스타일 스킬로 바꿔줍니다. 채팅 내보내기 파일, 사진, 소셜 게시물, 그리고 사용자의 설명을 바탕으로 구조화된 Relationship Memory와 Persona를 만들어내는 방식입니다. 이 스킬의 핵심 목적은 단순히 “챗봇 만들기”가 아니라, “이 사람이 나에게 어떻게 느껴지고, 어떤 말투를 쓰며, 어떤 관계 방식으로 다가오는지”를 시간이 지나도 다듬어 갈 수 있는 형태로 보존하는 데 있습니다.

create-crush를 설치하면 좋은 사용자

create-crush for Skill Authoring은 긴 프롬프트 하나를 즉흥적으로 짜는 대신, 안내된 파이프라인을 원하는 사용자에게 잘 맞습니다. 특히 Claude Code를 이미 쓰고 있고, .claude/skills/에 파일을 둘 수 있으며, 원자료를 직접 제공할 의향이 있는 사람에게 적합합니다. 일회성 역할극 답변만 필요하다면 일반 프롬프트가 더 빠릅니다. 반대로 메모리 수정이 가능하고 유지·업데이트할 수 있는 페르소나가 필요하다면 create-crush skill이 훨씬 유용합니다.

일반 프롬프트와 비교해 create-crush가 돋보이는 이유

단순한 “이 사람처럼 말해줘” 프롬프트와 달리, create-crush에는 입력 수집용 프롬프트, WeChat/QQ/소셜 콘텐츠용 파서, 선택적 사진 분석, ./crushes/{slug}/ 아래 생성되는 결과 파일, 그리고 “저 사람은 원래 저렇게 말하지 않아요” 같은 수정 워크플로가 포함되어 있습니다. 이런 구조 덕분에 페르소나를 처음 만들거나 나중에 발전시킬 때 추측에 의존할 부분이 줄어듭니다.

설치 전 확인해야 할 적합성 및 경계

이 스킬은 개인적 기억과 감정 분석을 위한 도구로 명시되어 있으며, 괴롭힘, 스토킹, 사생활 침해 용도가 아닙니다. 실제 도입 장벽은 꽤 실무적입니다. Claude Code 환경이 전제되고, 보조 스크립트를 쓰려면 선택적으로 Python 3.9+가 필요하며, 포함된 도구가 파싱할 수 있는 형식의 원자료도 있어야 합니다. 개인 데이터를 로컬에서 처리할 수 없거나 처리해서는 안 되는 상황이라면 create-crush는 설치하지 않는 편이 맞습니다.

create-crush 스킬 사용 방법

Claude Code에서 올바른 위치에 create-crush 설치하기

create-crush install 기준으로는, 저장소를 create-crush라는 이름의 스킬 폴더로 클론하면 됩니다.

# project-local
mkdir -p .claude/skills
git clone https://github.com/xiaoheizi8/crush-skills .claude/skills/create-crush

# or global
git clone https://github.com/xiaoheizi8/crush-skills ~/.claude/skills/create-crush

# optional helpers
pip3 install -r .claude/skills/create-crush/requirements.txt

기본 전제 환경은 Read, Write, Edit, Bash를 사용할 수 있는 Claude Code입니다. 선택적 Python 의존성은 주로 파싱 품질을 높여주며, 핵심 프롬프트 동작 자체에 필수는 아닙니다.

먼저 봐야 할 핵심 파일부터 확인하기

빠르게 create-crush guide를 파악하려면 다음 순서로 읽는 것이 좋습니다.

1. SKILL.md — 트리거 문구, 도구 사용 규칙, 출력 위치, 업데이트 모드
2. README_EN.md — 설치 경로와 사용자용 명령어
3. prompts/intake.md — 스킬이 처음 무엇을 물어보는지
4. prompts/memory_analyzer.md 및 prompts/persona_builder.md — 어떤 정보가 추출되는지
5. prompts/correction_handler.md — 생성 후 수정이 어떻게 반영되는지

데이터를 가져올 계획이라면 tools/wechat_parser.py, tools/qq_parser.py, tools/social_parser.py, tools/photo_analyzer.py도 함께 확인해 두는 것이 좋습니다. 그래야 실제로 어떤 형식이 지원되는지, 어디까지 자동화가 가능한지 현실적으로 판단할 수 있습니다.

create-crush를 실행할 때는 입력을 더 강하게 주기

일반적인 create-crush usage는 /create-crush를 입력하거나 “Help me create a crush skill” 같은 자연어로 시작합니다. 이후 스킬은 보통 다음 정보를 필요로 합니다.

• 코드네임 또는 별칭
• 짧은 관계 요약
• 성격 설명
• 선택 파일: 채팅 로그, 스크린샷, 사진, 소셜 텍스트

약한 입력 예시: “She is nice and cute.”
더 좋은 입력 예시: “Codename: Xiaomei. We met 3 months ago at work in Shanghai. We mostly chat after 10pm. She replies briefly in text but is warmer in person. She rarely initiates, uses few emojis, and often ends with ‘hhh’.”

이처럼 입력이 구체적일수록 결과도 좋아집니다. 스킬이 사실, 상호작용 패턴, 말버릇을 구분해 정리할 수 있고, 비어 있는 부분을 멋대로 지어낼 가능성도 줄어들기 때문입니다.

create-crush 결과물은 일회성이 아니라 워크플로로 활용하기

생성 이후 이 저장소는 단발성 출력보다 수명 주기 전체를 지원합니다. 즉, 생성하고, 테스트하고, 수정하고, 발전시키는 흐름입니다. 문서에 언급된 유용한 명령어로는 /list-crushes, /{slug}, /{slug}-memory, /{slug}-persona, 그리고 /update-crush {slug} 같은 업데이트 흐름이 있습니다. 권장 방식은 다음과 같습니다.

1. 최소한의 사실과 대표 자료 몇 개로 먼저 생성하기
2. 대화 테스트하기
3. 사실 오류와 톤 오류를 분리해서 수정하기
4. 첫 실행에 모든 자료를 몰아넣기보다, 나중에 로그를 추가하기

이 단계적 워크플로가 바로 create-crush를 단일 프롬프트 대신 선택할 가장 큰 이유입니다.

create-crush 스킬 FAQ

create-crush는 일반 프롬프팅보다 더 나은가요?

반복해서 사용할 계획이라면 그렇습니다. 빠르게 흉내 내는 용도라면 일반 프롬프트도 충분하지만, create-crush는 구조화된 메모리, 페르소나 레이어, 가져오기 보조 도구, 그리고 명시적인 수정 처리 흐름을 제공합니다. 여러 세션에서 일관성을 유지하거나 결과를 계속 개선하고 싶을 때 이 차이가 크게 드러납니다.

create-crush 스킬은 초보자도 쓰기 쉬운 편인가요?

중간 정도입니다. 상호작용 흐름 자체는 안내형이지만, 설치는 노코드 수준이 아닙니다. Claude Code의 스킬 폴더 구조를 이해해야 하고, 파서를 쓰려면 Python이 필요할 수도 있습니다. Skill Authoring이 처음인 사람도 사용할 수는 있지만, 프롬프트·로컬 파일·민감한 개인 자료가 함께 얽히기 때문에 가장 쉬운 입문용 스킬이라고 보기는 어렵습니다.

create-crush usage의 주요 한계는 무엇인가요?

품질은 제공하는 자료에 크게 좌우됩니다. 자료가 적거나, 이상화되어 있거나, 서로 모순되면 결과 페르소나도 평면적으로 나오기 쉽습니다. 또 이 저장소는 Claude Code 스타일의 도구 사용에 최적화되어 있어, 범용 웹앱이나 호스팅 서비스처럼 쓰는 구조는 아닙니다. 증거에서 드러나는 패턴을 보존하는 데는 강하지만, 숨은 감정을 안정적으로 추론하거나 큰 공백을 안전하게 메워주는 도구는 아닙니다.

어떤 경우에는 create-crush를 쓰지 말아야 하나요?

공개용 캐릭터 봇이 필요하거나, 컴플라이언스에 안전한 엔터프라이즈 워크플로가 필요하거나, 동의 문제 또는 침습적 데이터 수집이 얽힌 경우라면 create-crush는 건너뛰는 편이 맞습니다. 목표가 실제 한 사람의 기억 기반, 증거 기반 표현이 아니라 넓은 범위의 가상 페르소나 생성이라면 이 스킬은 적합하지 않습니다.

create-crush 스킬 개선 방법

자료는 한꺼번에 덤프하지 말고 층위별로 제공하기

create-crush를 더 잘 쓰려면, 저장소 구조에 자연스럽게 매핑되는 형태로 입력을 주는 것이 좋습니다.

• facts: 어떻게 만났는지, 타임라인, 현재 상태
• behavior: 누가 먼저 연락하는지, 답장 속도, 자주 나오는 주제
• language: 반복되는 표현, 이모지 습관, 메시지 길이
• moments: 맥락이 있는 기억에 남는 상호작용 몇 가지

아무 설명 없이 모든 자료를 한 번에 올리는 것보다 이 방식이 훨씬 낫습니다. 분석기는 “무슨 일이 있었는지”와 “어떤 말투인지”를 분리할 수 있을 때 가장 잘 작동합니다.

create-crush의 흔한 실패 패턴은 초기에 바로 잡기

가장 자주 보이는 오류는 대체로 다음과 같습니다.

• 지나치게 로맨틱하거나 과하게 확신하는 톤
• 너무 일반적인 말투
• 관찰된 행동과 사용자의 투사를 혼동함
• 일회성 사건을 고정 성향처럼 섞어버림

이럴 때는 수정 흐름을 구체적으로 쓰는 것이 중요합니다. 예를 들어 “She would not send long emotional paragraphs,” 또는 “We did not meet alone; update the relationship timeline.”처럼 바로잡아야 합니다. 포함된 correction handler는 create-crush skill에서 가장 가치가 큰 요소 중 하나입니다.

대표성 있는 샘플로 반복 개선하기

첫 결과가 감정적으로 맞아 보이는지만으로 판단하지 마세요. 구체적인 상황으로 테스트해야 합니다.

• 가벼운 잡담
• 늦은 밤 답장 스타일
• 어색한 거리감
• 함께 겪은 순간에 대한 기억 회상

그다음 실패하는 모드의 대표 데이터를 추가하세요. 밋밋한 예문 50개보다 현실적인 대화 5개가 보통 더 도움이 됩니다.

Skill Authoring 재사용 관점에서 create-crush 개선하기

create-crush for Skill Authoring을 다른 용도로 응용하고 싶다면, SKILL.md가 어떻게 전문 작업을 프롬프트 파일과 Python 도구로 분기하는지 살펴보는 것이 좋습니다. 재사용 가능한 패턴은 다음과 같습니다. intake → parse sources → build memory/persona → write a target skill → support corrections/versioning. 이 아키텍처는 대상이 crush가 아니라 멘토, 가상 캐릭터, 고객 페르소나이더라도 충분히 참고할 가치가 있습니다.