🌱 Empieza aquí · Validador de voz de marca
¿Alguna vez leíste un post o un email de tu marca y pensaste "esto no suena a nosotros", pero no supiste explicar por qué? Esta semilla le da a tu asistente el ojo de un editor de voz: le pegas cualquier texto y te devuelve un puntaje del 0 al 10 diciéndote qué tan fiel es a tu marca, dónde falla exactamente, y cómo arreglarlo. No reescribe por ti; te da el diagnóstico para que decidas si publicar, ajustar o tirar el borrador.
Para instalarla
Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:
"Siembra esta semilla 🌱"
Con eso basta de tu parte. Tu asistente hace el resto y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te va guiando.
¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el validador de voz", "haz el setup de esto". Te entiende igual.
Para el asistente que siembra 🤖
Este componente es una skill (una habilidad que se auto-activa por su descripción). No
es un programa ejecutable, ni un hook: no lleva chmod, no toca settings.json y no
corre ningún script. Se "siembra" colocando el archivo del método donde la plataforma
carga sus habilidades, y armando (idealmente) el perfil de voz de la persona.
1. Copia la skill donde la plataforma la cargue
El kernel trae dos archivos:
kernel/SKILL.md— el método del validador (las 8 dimensiones, el scoring, el veredicto).kernel/perfil-de-voz.ejemplo.md— la plantilla para definir la voz concreta de la marca.
Claude Code (macOS / Linux / Windows con Git Bash):
mkdir -p "$HOME/.claude/skills/voice-validator"
cp kernel/SKILL.md "$HOME/.claude/skills/voice-validator/SKILL.md"
cp kernel/perfil-de-voz.ejemplo.md "$HOME/.claude/skills/voice-validator/perfil-de-voz.ejemplo.md"
Las skills en
~/.claude/skills/<nombre>/SKILL.mdse descubren solas y se activan cuando la conversación coincide con su descripción. El perfil de voz vive en la misma carpeta para que el validador lo encuentre.
Cowork: si tu proyecto soporta la carpeta de skills, usa la misma ruta relativa
(.claude/skills/voice-validator/SKILL.md). Si no, coloca SKILL.md dentro del proyecto y
agrega en el archivo de instrucciones del proyecto (el CLAUDE.md) una línea que apunte a
él, por ejemplo: "Para validar copy contra la voz de la marca, aplica el método de
SKILL.md del validador de voz."
Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de
SKILL.md dentro de AGENTS.md (o agrégale un puntero si lo guardas aparte en el
proyecto), para que el método se cargue con el resto de tus instrucciones.
2. Arma el perfil de voz (muy recomendado)
El validador NO trae ninguna voz cableada: puntúa contra el perfil de voz de esta
marca. Abre kernel/perfil-de-voz.ejemplo.md y, con la persona (o detectándolo tú de sus
materiales), llena al menos las secciones 1, 2 y 4: cómo se nombra a las cosas, el
vocabulario de firma, y la lista de lo que la marca JAMÁS diría. Guarda el archivo lleno
como perfil-de-voz.md junto a la skill.
Si la persona todavía no tiene su voz definida, no pasa nada: el método corre con los defaults y da un puntaje orientativo. Pero avísale que el resultado se afina muchísimo en cuanto llene su perfil.
3. Verificación post-siembra (obligatoria)
Como es un método (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que el validador dictamina de verdad.
a) El archivo quedó colocado (ejemplo Claude Code):
ls -la "$HOME/.claude/skills/voice-validator/SKILL.md"; echo "exit=$?"
Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale
No such file or directory, la copia no se hizo; repite el paso 1.
b) El validador dictamina (prueba de comportamiento, en una conversación nueva):
Pídele a la persona que abra una sesión nueva y te diga: "valida esta copia contra mi
voz: [pega un párrafo]". La conducta correcta es que devuelvas un reporte con puntaje
final, la tabla de las 8 dimensiones, las banderas rojas ubicadas y tres arreglos —y que
NO reescribas el texto por tu cuenta. Si en vez de eso reescribes la pieza o das un "se ve
bien" sin tabla, la skill no se cargó: revisa que SKILL.md esté en la carpeta de skills
(o dentro de AGENTS.md en Codex).
Cuando ambas partes pasen, dile a la persona en una línea qué gana con esto.
✅ ¿Cómo sé que funcionó?
De ahora en adelante, antes de publicar cualquier pieza puedes pedirle a tu asistente "valida esto contra mi voz" y, en vez de un "me late / no me late", vas a recibir un dictamen con número: un puntaje del 0 al 10, la lista exacta de lo que suena fuera de marca, y tres arreglos concretos. Publicas con más confianza y con menos idas y venidas.
El truco fino: mientras más completo tengas tu perfil de voz, más filoso es el dictamen. Pero incluso sin él, ya tienes un juez que atrapa lo obvio. 🌱
