Higgsfield Brandkit

¿Qué hace Higgsfield Brandkit?

Construye una identidad coherente y sus aplicaciones solicitadas. Trata los hechos de marca proporcionados y los activos oficiales como restricciones fijas.

Inicialización

1. Resuelve SKILL_ROOT al directorio instalado de esta skill y crea un directorio de proyecto duradero:

   BRANDKIT_WORKDIR="${PWD}/brandkit"
   BRANDKIT_STATE="${BRANDKIT_WORKDIR}/state.json"
   mkdir -p "${BRANDKIT_WORKDIR}"
   

2. Lee prerrequisitos. Verifica las herramientas antes de la etapa que las necesite. Nunca instales paquetes del sistema sin el permiso del usuario.

3. Si falta higgsfield, instálalo solo después de obtener permiso:

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

4. Si higgsfield account status falla con un error de autenticación o espacio de trabajo, pide al usuario que ejecute higgsfield auth login o seleccione un espacio de trabajo, y luego espera.

5. Inspecciona los contratos de modelo activos antes de la generación de pago:

   higgsfield model get recraft_v4_1 --json
   higgsfield model get seedream_v5_pro --json
   higgsfield model get gpt_image_2 --json
   

Mapeo de CLI

Operación	Comando
Descubrir un modelo	higgsfield model get <model> --json
Generar y sondear	higgsfield generate create <model> ... --wait --json
Reanudar un trabajo	higgsfield generate wait <job_id> --json
Subir un activo local	higgsfield upload create <path> --json
Importar metadatos de sitio web	higgsfield marketing-studio brand-kits fetch --url <url> --wait --json
Leer/escribir estado de aprobación	python3 "$SKILL_ROOT/scripts/brandkit.py" state ...
Renderizar paneles de revisión	python3 "$SKILL_ROOT/scripts/brandkit.py" preview ...
Inspeccionar logo seleccionado	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ...
Exportar archivos de logo	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ...
Construir un Brandbook	python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ...

Las rutas de imagen locales pasadas con --image se suben automáticamente. Mantén los entregables HTML, SVG, PPTX y PDF como archivos de proyecto locales a menos que el usuario necesite explícitamente una copia alojada.

Comportamiento frente al usuario

• Adáptate al idioma del usuario. Mantén privados el razonamiento de Design Brain, las indicaciones, la mecánica de estado, los scripts, la búsqueda de modelos y los detalles internos de QA.
• Envía como máximo una oración de estado breve por lote de generación visible, luego permanece en silencio hasta que el resultado esté listo.
• Haz un conjunto compacto de solo las preguntas bloqueantes no resueltas. Nunca repitas hechos ni fuerces un cuestionario de identidad completo para una tarea parcial.
• Después de cada revisión de paleta, logo, tipografía o aplicación derivada, detente y espera la retroalimentación normal del usuario.
• Nunca infieras aprobación a partir del silencio, la generación exitosa o tu propia preferencia.
• Preserva el texto exacto del usuario. Nunca inventes posicionamiento, valores, afirmaciones, ingredientes, precios, certificaciones, estadísticas o contenido regulatorio.

Flujo de trabajo principal

1. Clasifica la solicitud.

   • apply-existing: usa los activos oficiales proporcionados sin rediseñarlos.
   • extend-partial: crea solo las piezas faltantes requeridas por la salida solicitada.
   • create-identity: crea un nuevo logo o identidad solo cuando se solicite explícitamente.

2. Lee el estado. Ejecuta:

   python3 "$SKILL_ROOT/scripts/brandkit.py" state \
     --state-file "$BRANDKIT_STATE" --action get_status
   

   El estado local es duradero. Nunca pegues, edites a mano ni recrees aprobaciones cuando el archivo de estado exista.

3. Realiza la ingesta y el análisis de activos. Lee ingesta, análisis de activos, enrutamiento de estado y cargas de estado exactas. Bloquea inmediatamente cada logo, paleta y ranura de tipografía declarados por el usuario como oficiales.

4. Crea el Brand Lock. Lee Brand Lock. Registra la ortografía exacta, los activos oficiales, los colores, las fuentes, las reglas de diseño/formas, las salidas solicitadas y los tratamientos prohibidos.

5. Requiere solo las ranuras que utiliza la salida.

   • solo-logo → paleta + logo para una marca nueva; solo logo oficial para una marca existente
   • solo-paleta → paleta
   • solo-tipografía → tipografía
   • maqueta/merchandising sin texto → logo; añade paleta solo cuando el color/aplicación lo requiera
   • social/empaque/póster/señalética con texto → logo + paleta + tipografía
   • Brandbook/presentación → logo + paleta + tipografía

6. Construye las ranuras base faltantes. Lee Design Brain, tableros conceptuales, revisiones en línea, y solo los módulos necesarios de paleta, logo o tipografía.

7. Continúa la solicitud original tan pronto como sus ranuras requeridas estén aprobadas. Nunca le pidas al usuario que elija el alcance nuevamente.

8. Carga solo el módulo de producción solicitado:

   • maquetas
   • gráficos sociales
   • pósters/banners
   • empaques
   • señalética
   • merchandising
   • presentaciones
   • Brandbooks

9. QA y aprobación. Lee QA e iteración. Repara solo la salida fallida. Guarda un elemento derivado solo después de la aprobación explícita con sus dependencias base exactas.

Secuencia de nueva identidad

1. Paleta

Renderiza 2–3 opciones de paleta exactas como HTML determinista usando cargas de vista previa. Muestra capturas de pantalla PNG más archivos HTML editables y espera. Persiste la paleta seleccionada con approve_palette antes de la generación del logo.

2. Marcas SVG

Lee mejorador de indicaciones de logo. Produce exactamente tres mecanismos distintos de solo símbolo y una indicación de Recraft para cada uno. Escribe cada indicación larga en un archivo y envíala por separado:

higgsfield generate create recraft_v4_1 \
  --model_type vector \
  --colors @"${BRANDKIT_WORKDIR}/logo-colors.json" \
  --background_color '#F7F7F5' \
  --aspect_ratio 1:1 \
  --resolution 2k \
  --wait --json < "${BRANDKIT_WORKDIR}/logo-candidate-1.txt"

Usa las URLs SVG devueltas directamente para la revisión. Después de la selección, inspecciona el SVG exacto sin alterarlo:

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
  --source "<URL SVG de Recraft seleccionada o ruta local absoluta>"

Persiste el ID de trabajo exacto, la URL SVG, el nombre, la revisión de la paleta y la huella de geometría canónica devuelta con approve_logo.

3. Tipografía

Propón 2–3 pares únicos de visual/texto usando fuentes proporcionadas o Google Fonts verificadas. Renderiza el nombre de la marca real y una copia de muestra a través del script de vista previa. Persiste solo el par seleccionado con approve_typography.

Los flujos interactivos siempre se detienen para las selecciones de paleta, logo y tipografía. El modo explícito sin preguntas puede elegir y persistir una paleta, pero aún muestra los tres candidatos de logo SVG y se detiene para la selección del usuario; las marcas exactas nunca se autoaprueban.

Invariantes de consistencia

• Reutiliza la misma fuente de logo aprobada en todas partes. Nunca redibujes un SVG oficial o seleccionado cuando sea posible la colocación/exportación determinista.
• Un logo generado depende de la revisión de la paleta utilizada para crearlo. Cambiar esa paleta invalida el logo generado y sus dependientes; cambiar la tipografía no invalida la marca de símbolo.
• Cambiar una ranura base invalida solo los elementos derivados que enumeran esa ranura en required_slots.
• Copia los mismos valores de Brand Lock en cada indicación de generación relacionada: hexadecimal exacto, roles de fuente, lenguaje de forma, colocación, espacio libre, composición y tratamientos prohibidos.
• Usa el modo vectorial de Recraft V4.1 solo para nuevas marcas de logo.
• Utiliza Seedream como el generador principal de maquetas fotorrealistas. Usa GPT Image 2 solo para la etapa controlada que agrega texto legible o detalles gráficos exactos.
• Utiliza construcción local determinista SVG/PPTX/HTML para copia exacta y diseños editables. No le pidas a un modelo de imagen que falsifique archivos editables.
• No prometas archivos nativos de Figma, Canva, PSD, AI o EPS.

Scripts deterministas

Crea archivos de entrada JSON bajo "$BRANDKIT_WORKDIR"; nunca interpoles texto de usuario directamente en argumentos de shell.

python3 "$SKILL_ROOT/scripts/brandkit.py" preview \
  --input "$BRANDKIT_WORKDIR/reviews.json" \
  --output-dir "$BRANDKIT_WORKDIR/reviews"

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export \
  --input "$BRANDKIT_WORKDIR/logo-export.json" \
  --output-dir "$BRANDKIT_WORKDIR/logo"

python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build \
  --state-file "$BRANDKIT_STATE" \
  --input "$BRANDKIT_WORKDIR/brandbook.json" \
  --output-dir "$BRANDKIT_WORKDIR/brandbook"

Para la exportación de logo, carga cargas de exportación de logo. Para Brandbooks, usa solo el constructor incluido; nunca sustituyas un generador improvisado de PowerPoint o PDF después de una falla de contrato determinista.

Política de fallos

• Reintenta una solicitud fallida de Recraft o generación de imágenes una vez con el mismo concepto bloqueado y contrato corregido. Detente después del segundo fallo equivalente.
• Si la vista previa o la exportación de logo falla dos veces, reporta el error concreto; nunca lo reemplaces con una reescritura SVG ad-hoc.
• Si la plantilla, fuente o contrato de conversión del Brandbook falla, detente inmediatamente. No produzcas una alternativa visualmente diferente y la llames canónica.
• Si no se puede preservar la tipografía exacta o la fidelidad del logo oficial, divulga la limitación en lugar de reclamar finalización.
• Nunca expongas tokens de autenticación o credenciales en bruto en archivos, registros o chat.

Entrega

Para Brandbooks, sigue el estricto contrato de respuesta en brandbook: solo enlace/ruta PPTX, enlace/ruta PDF y advertencia de instalación de fuentes.

Para otras salidas, devuelve:

1. Los archivos visuales solicitados y las vistas previas.
2. Un resumen compacto de Brand Lock.
3. Etiquetas de formato editable versus aplanado.
4. Limitaciones de fuentes/importaciones requeridas.
5. Nombres de variantes estables para revisiones específicas.

Índice de referencias

• Prerrequisitos — dependencias locales específicas de la etapa y comandos de instalación.
• Ingesta — preguntas mínimas y enrutamiento de entrada.
• Análisis de activos — clasificación y medición de oficial/referencia.
• Enrutamiento de estado y cargas de estado — aprobaciones persistentes.
• Brand Lock — restricciones visuales canónicas.
• Design Brain — dirección artística privada.
• Tableros conceptuales, cargas de vista previa y revisiones en línea — etapas de selección.
• Logo, mejorador de indicaciones de logo y cargas de exportación de logo — generación SVG y variantes deterministas.
• Paleta y tipografía — ranuras base.
• Maquetas, gráficos sociales, pósters/banners, empaques, señalética y merchandising — aplicaciones.
• Presentaciones y Brandbooks — documentos editables.
• QA e iteración — verificación previa, reparación, aprobación y manifiesto de entrega.