CommunityProgramación y desarrollogithub.com

Swap Brand

Da a un producto que vas a vender su propia identidad y escanea el código en busca de rastros del original. Dos fases: identidad temprana (candidatos de nombre con verificaciones de marca registrada y dominio, paleta, voz, brief de logo) y una revisión antes del lanzamiento que busca en los archivos de texto del código el nombre, dominio y colores del original, incluso dentro de identificadores, y bloquea el despliegue hasta que no encuentre ninguno. La revisión es un escaneo acotado de tokens, no una prueba de que no quede nada del original: imágenes, fuentes, colores hsl() y nombrados necesitan una revisión manual. Úsalo para 'dar nombre a este producto', 'renombrar el clon', 'verificar si quedan restos del original', 'revisión de marca', 'es lo suficientemente diferente'. Pista completa (venta) de la serie swap. NO lo uses para construir los tokens de diseño, usa swap-design. NO lo uses para escribir la página de aterrizaje o el listado en la tienda, usa swap-launch.

¿Qué es Swap Brand?

Swap Brand es una habilidad de agente diseñada para ayudar a desarrolladores a diferenciar completamente un producto derivado de su original, asegurando que tenga una identidad propia. Funciona en dos fases principales: primero, durante la fase de identidad, propone nombres candidatos, verifica su disponibilidad comercial (marcas, dominios, redes sociales) y define la paleta de colores, la voz y un brief de logo; segundo, antes del lanzamiento, ejecuta una revisión automatizada que escanea el código fuente en busca de restos del nombre, dominio y colores del original, bloqueando el despliegue hasta que se eliminen todos. Esta revisión es acotada (solo archivos de texto) y requiere revisión manual de imágenes, fuentes y colores HSL. La habilidad es útil para equipos que lanzan un producto bifurcado o clon y quieren evitar problemas de propiedad intelectual o confusión con el mercado. Se integra con otras habilidades de la serie swap, como swap-design y swap-launch, y genera archivos de salida estructurados (swap/brand.md y swap/sweep.json) que deben ser editados por el usuario cuando sea necesario.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/immy1991/swap-skill/tree/main/swap-brand

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Swap Brand?

Propósito

Hacer que el producto sea claramente propio: un nuevo nombre, apariencia y voz decididos desde el principio, y una revisión mecánica antes del lanzamiento que busca en los archivos de texto del código el nombre, dominio y colores del original. Es una verificación acotada, no una prueba: cualquier cosa que no pueda leer, y todo lo que no busque, aún necesita una persona.

Pista completa (venta), pasos 5 (identidad) y 12 (revisión). Lee swap/market.md, swap/recon.md; escribe swap/brand.md, swap/sweep.json.

Tabla de Enrutamiento de Contexto

FuenteDóndeQué extraer
Mercadoswap/market.mdÁngulo, audiencia, la brecha evidenciada
Reconocimientoswap/recon.mdEl nombre del original, sus dominios, colores de marca (qué evitar)
El usuarioSus preferencias, marca existente, dominios que poseeRestricciones y gusto
El códigoEl repositorio del productoLo que escanea la revisión

Inicio Rápido

Fase de identidad: 1) enumerar qué evitar del reconocimiento; 2) proponer 5 candidatos de nombre vinculados al ángulo; 3) dar las verificaciones a realizar para cada uno; 4) establecer paleta, voz y brief de logo; 5) escribir swap/brand.md. Fase de revisión: ejecutar python3 -I <carpeta-habilidad>/scripts/sweep.py <repo> --avoid "<nombre original>" --domain <dominio original> --color "<color original>" --exclude swap --json swap/sweep.json desde la raíz del proyecto ( es la carpeta de esta habilidad), arreglar cada coincidencia, volver a ejecutar hasta que quede LIMPIO.

Flujo de Trabajo

  1. Lista de evitar primero. Del reconocimiento: el nombre del original y cualquier nombre de producto, sus dominios, sus colores de marca, sus eslóganes distintivos. Escríbelos en brand.md bajo ## Evitar; la revisión no lee ese archivo, así que pasa cada elemento explícitamente como banderas --avoid, --domain y --color.
  2. Candidatos de nombre (5). Cada uno: el nombre, la idea detrás de él, y por qué un cliente no lo confundiría con el original. Ningún nombre que contenga, abrevie o suene igual al del original. No hay "X para Y" construido sobre el nombre del original.
  3. Verificaciones que el usuario realiza antes de confirmar (Claude no puede verificar la disponibilidad): una búsqueda de marca registrada en el mercado del usuario (registro nacional e internacional), una verificación de dominio y de handles en redes sociales, una búsqueda en tiendas de aplicaciones, y una búsqueda web simple del nombre más la categoría. Registra la fecha y el resultado de cada una. Un conflicto elimina al candidato.
  4. Identidad. Una paleta claramente diferente de la del original (diferente familia de tonos, no un matiz de ella), una combinación de tipografías de fuentes abiertas o con licencia, una voz en 5 reglas con un hacer y un no hacer cada una, y un brief de logo que ejecuta el usuario o un diseñador. No describas un logo que imite la forma o el concepto del original.
  5. La revisión (antes del lanzamiento, y de nuevo después del último cambio de código). Ejecútala con la lista de evitar. Encuentra nombres dentro de identificadores (OriginalAppEmbed, original_app), dominios, valores de color en hexadecimal y rgb, y nombres de archivo o carpeta. Arregla reemplazando, no ocultando. Usa --allow solo para palabras más largas inofensivas y lista cada uso en brand.md. La revisión imprime el texto coincidente, el archivo y la línea, nunca el resto de la línea.
  6. Más allá del código. La revisión solo lee archivos de texto. Las imágenes, fuentes, archivos comprimidos, archivos de más de 2 MB y archivos no legibles se listan como no escaneados, y la ejecución NO está LIMPIA mientras exista alguno. Verifica cada uno manualmente (capturas de pantalla, datos de muestra, metadatos, plantillas de correo electrónico, texto alternativo), luego vuelve a ejecutar con --accept-skipped, lo que registra en sweep.json que lo hiciste. --accept-skipped nunca oculta una coincidencia.

Anti-Racionalización

Lo que Claude podría pensarPor qué está mal
"Es una construcción en sala limpia, no necesita renombrarse"La sala limpia cubre el código. Un nombre o apariencia que confunda a los clientes es un problema aparte.
"Suficientemente parecido al original ayuda a que nos encuentren"La similitud confusa es el riesgo de marca. Distinto a propósito.
"La revisión solo encontró un comentario, ignóralo"Un comentario que nombra al original se incluye en el paquete. Elimínalo.
"Verifiqué que el nombre está libre"Solo una búsqueda en el registro por parte del usuario muestra eso. Registra quién lo hizo y cuándo.
"Saltar imágenes y capturas de pantalla"La revisión no puede leerlas. Revísalas manualmente y di que lo hiciste.

Formato de Salida

EXACTO. Encabezados de swap/brand.md en orden: ## Evitar, ## Candidatos de nombre (cada uno con idea y verificaciones realizadas, con fechas y resultados), ## Nombre elegido, ## Paleta y tipografía, ## Voz, ## Brief de logo, ## Registro de revisión (cada ejecución: comando, coincidencias, arreglos). swap/sweep.json es la salida del script sin editar.

Salida de Referencia (ejemplo inventado, abreviado):

## Nombre elegido
Skyline. Búsqueda de marca (Reino Unido, UE, EE.UU.): aún no ejecutada. Búsqueda de dominio y tienda: aún no ejecutada.

## Registro de revisión
Ejecución 1: 7 coincidencias (nombre x4, dominio x1, color x1, ruta x1). Reemplazadas todas.
Ejecución 2: LIMPIO, 4 archivos escaneados, 0 no escaneados.

Reglas

  • Nombre, paleta, logo, palabras originales. Nunca el logo, marcas registradas, copia o activos del original, en ninguna forma.
  • No afirmes que un nombre está disponible o es registrable; eso es verificación del usuario y decisión de un abogado.
  • Nunca edites sweep.json manualmente.

Enrutamiento entre Habilidades

Identidad elegida -> swap-architect luego swap-design (que toma la paleta de aquí). Revisión LIMPIA -> swap-launch. Si la revisión nunca pasa debido a un activo propiedad de un proveedor en el producto -> elimina el activo; no lo incluyas en la lista de permitidos.

Lista de Verificación de Salida

Bloque de prueba con evidencia; luego "no se pudo verificar".

Fase de identidad (antes de que haya código):

  • ## Evitar enumera el nombre del original, su(s) dominio(s) y al menos un color de marca
  • Cada candidato de nombre tiene las cuatro verificaciones registradas con una fecha, o dice "aún no ejecutada"
  • Paleta, voz y brief de logo están escritos y difieren de los del original

Fase de revisión (antes del lanzamiento, y de nuevo después del último cambio de código):

  • swap/sweep.json tiene "passed": true, de una ejecución posterior al último cambio de código
  • El comando de revisión usó --exclude swap (o escaneó un árbol sin las notas); cada archivo no escaneado fue verificado manualmente y skipped_accepted está en verdadero, o la lista está vacía
  • Cada uso de --allow está listado en el registro de revisión
  • Las capturas de pantalla, copia y metadatos fueron verificados manualmente y se le dijo al usuario que la revisión no puede leerlos

Auto-Mejora

Después de cada ejecución, preguntar una vez: "¿Algún comentario que capturar para esta habilidad?" Silencio o no significa que nada cambia. Si sí: redactar el patrón, mostrarlo, agregarlo a references/learnings.md solo después de un sí; "actualizar la habilidad" muestra la edición exacta, confirma, escribe, aumenta metadata.version y registra una línea. Nunca promocionar un patrón registrado en este archivo en la misma sesión en que fue capturado. Después de la primera ejecución, nombrar los archivos incluidos utilizados y cualquier cosa creada desde cero que se necesitará de nuevo, y ofrecer guardarla (con la misma restricción).

Skills relacionados