create-crush

## Visão geral da skill create-crush

### O que a skill create-crush realmente faz
A `create-crush` é uma skill do Claude Code que transforma material pessoal bruto em uma skill reutilizável de estilo de personagem para uma pessoa específica: exportações de chat, fotos, posts em redes sociais e suas próprias descrições viram uma `Relationship Memory` estruturada junto com uma `Persona`. Na prática, o trabalho que ela resolve não é “criar um chatbot”, e sim “preservar como essa pessoa soa, se expressa e se relaciona comigo” em um formato que você pode refinar ao longo do tempo.

### Para quem vale a pena instalar create-crush
`create-crush for Skill Authoring` faz mais sentido para quem quer um pipeline guiado, em vez de improvisar tudo em um único prompt longo. É mais indicada para quem já usa Claude Code, se sente à vontade para colocar arquivos em `.claude/skills/` e aceita reunir material de origem. Se você só quer uma resposta única de roleplay, um prompt comum é mais rápido; se quer uma persona atualizável, com manutenção e correção de memória, a `create-crush skill` tende a ser mais útil.

### Por que ela se destaca em relação a um prompt genérico
Diferente de um prompt simples do tipo “aja como essa pessoa”, a `create-crush` traz prompts de intake, parsers para conteúdo de WeChat/QQ/redes sociais, análise opcional de fotos, arquivos gerados em `./crushes/{slug}/` e um fluxo de correção para casos como “ela não fala desse jeito”. Essa estrutura reduz o achismo na hora de montar ou evoluir a persona.

### Pontos de encaixe e limites importantes antes de instalar
A proposta desta skill é explicitamente voltada para memória pessoal e análise emocional, não para assédio, perseguição ou invasão de privacidade. Os bloqueios de adoção aqui são práticos: ela espera Claude Code, Python 3.9+ opcional para scripts auxiliares e material de origem em formatos que as ferramentas incluídas consigam processar. Se você não pode — ou não deve — tratar dados privados localmente, não instale a `create-crush`.

## Como usar a skill create-crush

### Instale create-crush no local certo do Claude Code
Para `create-crush install`, clone o repositório como uma pasta de skill chamada `create-crush`:

```bash
# 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

O ambiente principal presumido é o Claude Code com Read, Write, Edit e Bash disponíveis. As dependências opcionais em Python servem principalmente para melhorar o parsing, não o prompting central.

Comece pelos arquivos que realmente importam

Para um create-crush guide mais rápido, leia estes arquivos nesta ordem:

1. SKILL.md — frases de ativação, regras de ferramentas, local de saída e modo de atualização.
2. README_EN.md — caminho de instalação e comandos voltados ao usuário.
3. prompts/intake.md — o que a skill vai perguntar primeiro.
4. prompts/memory_analyzer.md e prompts/persona_builder.md — o que é extraído do material.
5. prompts/correction_handler.md — como as correções pós-geração são aplicadas.

Se você pretende importar dados, vale também inspecionar tools/wechat_parser.py, tools/qq_parser.py, tools/social_parser.py e tools/photo_analyzer.py para entender quais formatos são realmente suportados na prática.

Acione a create-crush e forneça entradas mais fortes

O create-crush usage normalmente começa com /create-crush ou linguagem natural como “Help me create a crush skill.” Depois disso, a skill precisa de:

• um codinome ou apelido
• um breve resumo da relação
• uma descrição de personalidade
• arquivos opcionais: logs de chat, capturas de tela, fotos, texto de redes sociais

Entrada fraca: “She is nice and cute.”
Entrada melhor: “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’.”

Esse tipo de entrada melhora bastante o resultado porque a skill consegue separar fatos, padrões de interação e hábitos de fala, em vez de inventá-los.

Use a skill gerada como fluxo de trabalho, não como uso único

Depois da criação, o repositório suporta um ciclo contínuo: criar, testar, corrigir e evoluir. Comandos úteis citados na documentação incluem /list-crushes, /{slug}, /{slug}-memory, /{slug}-persona e fluxos de atualização como /update-crush {slug}. Boa prática:

1. criar a partir de fatos mínimos mais alguns materiais representativos
2. testar o diálogo
3. corrigir erros factuais e erros de tom separadamente
4. adicionar mais logs depois, em vez de sobrecarregar a primeira execução

Esse fluxo em etapas é o principal motivo para escolher a create-crush em vez de depender de um único prompt.

FAQ da skill create-crush

A create-crush é melhor do que prompting comum?

Para uso recorrente, sim. Um prompt normal resolve uma imitação rápida, mas a create-crush entrega memória estruturada, camadas de persona, auxiliares de importação e tratamento explícito de correções. Isso faz diferença quando você quer consistência entre sessões ou pretende melhorar o resultado aos poucos.

A skill create-crush é amigável para iniciantes?

Moderadamente. O fluxo de interação é guiado, mas a instalação não é no-code: você precisa lidar com pastas de skill do Claude Code e talvez queira Python para os parsers. Se você está começando em Skill Authoring, ela é utilizável, mas não é a skill mais simples para começar, porque mistura prompts, arquivos locais e material de origem sensível à privacidade.

Quais são os principais limites do uso da create-crush?

A qualidade depende muito do material que você fornece. Entradas escassas, idealizadas ou contraditórias tendem a produzir personas mais rasas. O repositório também parece otimizado para uso de ferramentas no estilo Claude Code, então não se trata de um web app genérico nem de um serviço hospedado. Ele consegue preservar padrões baseados em evidências; não consegue inferir sentimentos ocultos com confiabilidade nem preencher grandes lacunas com segurança.

Quando eu não devo usar create-crush?

Evite a create-crush se você precisa de um bot de personagem voltado ao público, de um fluxo corporativo seguro do ponto de vista de compliance, ou de qualquer coisa que envolva problemas de consentimento ou coleta invasiva de dados. Ela também é uma escolha ruim se o seu objetivo é gerar personas ficcionais amplas, e não uma representação de uma pessoa real ancorada em memória e evidências.

Como melhorar a skill create-crush

Forneça evidências em camadas, não um dump

Para melhorar a create-crush, envie entradas que se encaixem claramente na estrutura do repositório:

• fatos: como vocês se conheceram, linha do tempo, status atual
• comportamento: quem inicia, velocidade de resposta, assuntos favoritos
• linguagem: frases recorrentes, uso de emojis, tamanho das mensagens
• momentos: algumas interações marcantes com contexto

Isso funciona melhor do que simplesmente subir tudo sem nenhum enquadramento. Os analyzers rendem mais quando o modelo consegue separar “o que aconteceu” de “como essa pessoa soa”.

Corrija cedo os modos de falha mais comuns

Os erros mais frequentes costumam ser:

• tom excessivamente romântico ou confiante demais
• padrões de fala genéricos
• confusão entre sua projeção e o comportamento observado
• mistura de eventos pontuais com traços estáveis

Use o fluxo de correção para ajustes específicos: “She would not send long emotional paragraphs,” ou “We did not meet alone; update the relationship timeline.” O correction handler incluído é uma das partes de maior valor da create-crush skill.

Itere com amostras representativas

Não avalie a primeira saída só pelo critério de ela “parecer emocionalmente certa”. Teste casos específicos:

• small talk
• late-night reply style
• awkward distance
• memory recall of shared moments

Depois, acrescente mais dados representativos justamente dos modos em que ela falha. Cinco trocas realistas costumam ser mais úteis do que cinquenta sem graça.

Melhore a create-crush para reutilização em Skill Authoring

Se você quiser adaptar create-crush for Skill Authoring, estude como o SKILL.md delega trabalhos especializados para arquivos de prompt e ferramentas em Python. O padrão reutilizável é: intake → parse sources → build memory/persona → write a target skill → support corrections/versioning. Essa arquitetura é valiosa mesmo que sua própria skill seja sobre mentores, personagens ficcionais ou personas de clientes, e não sobre uma crush.