Company Brief

¿Qué hace Company Brief?

Convierte un nombre o URL de empresa en un PDF profundo, con fuentes y diseñado que le dice al lector todo lo que necesita saber para entrar a una entrevista, conversación sobre oferta, propuesta a cliente o primer proyecto con una nueva marca: qué es la empresa, cómo le va, quién la dirige, cómo es trabajar allí, cómo funcionan su marca y marketing, con quién compite y cómo hablar con ella. El PDF utiliza los colores y tipografías propios de la empresa, por lo que se siente como si les perteneciera.

Uso

/company-brief <nombre o URL de la empresa> [para <rol>] [kit de marca] [compartible]

Ejemplos: /company-brief linear.app, /company-brief Figma para Senior Brand Designer, /company-brief patagonia.com kit de marca, /company-brief Notion compartible. Las solicitudes simples también funcionan: "hazme un company brief de Notion antes de mi entrevista" o "acabamos de fichar a Oatly como cliente, necesito ponerme al día con su marca".

• Empresa: una URL resuelve la identidad. Un nombre solo puede no hacerlo (Paso 1).
• para : enfoca la contratación, las personas a conocer y la preparación de la entrevista en ese rol y su equipo. Sin él, por defecto se usa diseño, marca, marketing y liderazgo creativo, o lo que sugieran los antecedentes de la persona.
• Modo personal (por defecto): escrito para la persona que pregunta. Usa lo que sabes sobre ella (memoria, chats pasados, esta conversación, un currículum o portafolio adjunto) para "Tu enfoque", la propuesta y "Adecuación para ti". Si hay una oferta en mano, añade "Antes de firmar". Si no sabes nada de ellos, escribe esas partes de forma genérica y ofrece adaptarlas en la respuesta.
• Trabajo de marca ("kit de marca", o la persona dice que está diseñando para, haciendo una propuesta a, o comenzando a trabajar con la marca como diseñador, estratega, agencia o socio interno): las secciones de Identidad de marca y Kit de marca reciben el mayor cuidado, y el kit incluye la lista completa de activos y la llamada "Preguntar al cliente" (referencias/brand-extraction.md, sección 4). En la quinta parte, "Preparación de entrevista" se convierte en "Preparación de inicio" (lo que el equipo de marca esperará, qué llevar, preguntas probables), "Preguntas para hacer" son para el equipo de marca, y se eliminan Adecuación para ti y Antes de firmar. Mantén Contratación en un párrafo corto.
• Compartible ("compartible", "para un amigo", "para enviar a alguien"): nada sobre la persona. Sin píldora "Preparado para", sin puntuación de adecuación, sin Antes de firmar. La quinta parte se convierte en "Cómo hablar con ellos" y "Tu enfoque" se convierte en "Enfoques que funcionan".

No te detengas a hacer preguntas a menos que la identidad de la empresa sea genuinamente ambigua. Comienza en la primera respuesta: una frase sobre lo que estás haciendo, la lista de tareas, luego la investigación.

Archivos de la habilidad

Las rutas a continuación usan ${CLAUDE_SKILL_DIR}. Si ese texto no se reemplaza con una ruta real donde estás ejecutando, encuentra la carpeta una vez con find / -name brief-template.html -path '*company-brief*' 2>/dev/null | head -1 y usa su ruta absoluta en cada comando (las variables de shell pueden no persistir entre comandos).

Archivo	Para qué sirve
assets/brief.css	Hoja de estilo base. Cópiala; no la edites.
assets/brief-template.html	Esqueleto de todo el informe con {{placeholders}}
scripts/fonts.py	Instala fuentes gratuitas de Fontsource e imprime etiquetas <link>
scripts/tokens.py	Convierte los colores de la marca en el bloque <style> de tokens, con correcciones de contraste
scripts/render.cjs	Renderiza el PDF con Node Playwright y audita fuentes, contraste, placeholders
scripts/render.py	Lo mismo en Python, con respaldo a Chrome CLI, luego WeasyPrint
scripts/audit.js	La auditoría que ambos renderizadores ejecutan dentro de la página
scripts/contact_sheet.py	Una imagen de cada página para la verificación del diseño
references/research-playbook.md	Dónde buscar cada sección y el orden eficiente
references/brand-extraction.md	Cómo obtener colores reales, fuentes y descripción del logotipo del sitio en vivo
references/components.md	Marcado para cada componente, orden de las secciones, reglas de escritura

Reglas estrictas

• Desambiguar primero. Muchas empresas comparten nombres, y las bases de datos de financiación y los sitios de empleo a menudo los fusionan. Confirma que cada hecho financiero y de contratación pertenece a la entidad correcta (mismo dominio, fundadores, sede). Si existe una colisión, abre el resumen con una llamada de Verificación de nombre.
• Cada número tiene una fuente, una fecha y una etiqueta de confianza: Verificado (fuentes primarias: presentaciones, el propio sitio o página de carreras de la empresa), Reportado (prensa creíble), Afirmación de la empresa (su marketing), Estimación (terceros o tu inferencia; indica de qué), Desconocido (buscado, no encontrado; indica dónde).
• Escribe los hallazgos en research-notes.md a medida que avanzas. Los resultados de búsqueda se borran del contexto en investigaciones largas. Cualquier cosa no escrita se pierde.
• Actualidad: usa la fecha de hoy; pon el año en las búsquedas de noticias; marca cualquier cosa con más de 18 meses como desactualizada.
• Personas: líderes públicos y personas relevantes para el rol, solo con información profesional pública. Sin datos de contacto personales, ubicaciones de domicilio, familiares ni fotos de personas.
• Los activos de marca son enlaces, nunca copias. Describe el logotipo en palabras y enlaza a los archivos de logotipo y guías de la propia marca. No redibujes, traces, incrustes ni descargues logotipos, mascotas, fuentes o imágenes publicitarias en el informe o la carpeta de trabajo. Prefiere el kit de prensa, portal de marca o guías de la marca sobre sitios de logotipos de terceros, etiqueta cuál es cuál, confirma el formato de cada archivo abriéndolo, y enlaza los términos de uso que rigen los archivos. Las muestras de color, especímenes tipográficos y patrones abstractos con colores de marca están bien.
• Citas: extractos de reseñas de empleados de 25 palabras o menos, 4 o menos en total, atribuidas a la plataforma y la fecha. Resume artículos; no los pegues.
• Etiquétalo como independiente: la portada dice "Informe de investigación independiente. No afiliado ni respaldado por ."
• Di lo que falta en una línea en lugar de omitir una sección en silencio.
• Nunca afirmes una verificación que no hiciste ("Solo se revisó Glassdoor para este informe").
• Los informes compartibles no contienen nada privado sobre la persona que pregunta, incluso si lo sabes.

Flujo de trabajo

Crea esta lista de tareas y marca los elementos a medida que los termines:

1. Identificar la empresa y verificar colisiones de nombre
2. Configurar la carpeta de trabajo y el archivo de notas
3. Leer el sitio propio de la empresa y las páginas de carreras
4. Investigar todo lo demás en lotes paralelos
5. Extraer colores y tipografías de la marca; construir tokens y fuentes
6. Construir el kit de marca: archivos de logotipo, guías, fuentes, especificaciones de color
7. Sintetizar: conclusión, tarjeta de puntuación, cómo hablar con ellos
8. Escribir brief.html
9. Renderizar y auditar
10. Verificar hechos, enlaces y diseño
11. Entregar

1. Identificar

• URL proporcionada: abre la página de inicio y la página Acerca de. Nombre proporcionado: busca "<nombre>" empresa y "<nombre>" sitio oficial.
• Determina el nombre de marca y legal, dominio, sede, año de fundación, fundadores, pública o privada (ticker), matriz.
• Busca "<nombre>" -<dominio> para empresas con el mismo nombre.
• Si dos o más empresas reales coinciden plausiblemente y nada en la solicitud las diferencia, haz una pregunta nombrando a los candidatos. De lo contrario, elige la mejor coincidencia y establece al principio de tu respuesta.
• En modo personal, también busca en chats pasados y memoria (si está disponible) el nombre de la empresa: una solicitud, hilo de reclutador u oferta cambia lo que importa.

2. Carpeta de trabajo

mkdir -p briefs/<slug-empresa> && cd briefs/<slug-empresa>
cp "${CLAUDE_SKILL_DIR}/assets/brief.css" . && cp "${CLAUDE_SKILL_DIR}/assets/brief-template.html" brief.html

Usa el directorio de trabajo actual, o una carpeta temporal si no tiene permisos de escritura. Crea research-notes.md con un encabezado por sección del informe, y añade hallazgos como - <hecho> | <etiqueta> | <título de la fuente> | <URL> | <fecha>.

3. El sitio propio de la empresa primero

El sitio en vivo y las páginas de carreras responden un tercio del informe y son la fuente más fiable para misión, valores, productos, clientes, oficinas, roles abiertos, salarios, proceso de entrevista, handles sociales y tokens de marca.

• Si tienes una herramienta de navegador (Claude en Chrome, un navegador en la aplicación o un navegador en la nube), úsala para el dominio de la empresa; aprueba todo el sitio una vez si se te pide. Lee las páginas como texto, no capturas de pantalla, excepto el logotipo y el hero.
• Visita, en orden: página de inicio (posicionamiento, logotipos de clientes, handles y enlaces del pie de página) → Acerca de → Carreras (cuenta roles por departamento y ubicación) → 2–4 publicaciones más cercanas al rol objetivo (salario, pasos de entrevista, línea de reporte, herramientas) → Prensa/sala de noticias (línea de tiempo, kit de prensa, archivos de logotipo, guías de marca) → Blog/changelog (últimos 3 meses) → Eventos → Clientes.
• Ejecuta el script de extracción de marca en la página de inicio mientras estés allí (referencias/brand-extraction.md, sección 1).
• Sin navegador: obtén las mismas páginas con la herramienta de obtención.
• La página de carreras supera a las APIs de bolsas de trabajo, que a menudo están desactualizadas. Usa la lista de API del ATS en el playbook solo como respaldo.

Detalles: references/research-playbook.md, secciones 1–2.

4. Todo lo demás

Sigue references/research-playbook.md secciones 3–6. Envía búsquedas independientes juntas en un turno (financiación, ingresos, noticias, reseñas, competidores, campañas, eventos, podcasts). Usa búsqueda estándar primero y búsqueda extendida para noticias recientes, datos de contratación y reseñas, o cualquier cosa escasa. Si una herramienta de obtención rechaza una URL que escribiste, búscala y obtén el enlace del resultado, o ábrela en el navegador. Los conectores para sitios de empleo (Indeed, ZipRecruiter, LinkedIn), si están presentes, son buenos para calificaciones y roles.

40–80 consultas es normal para una empresa mediana. Cuando una sección se mantiene escasa después de dos buenas búsquedas, márcala como Desconocido y continúa.

5. Tokens de marca y fuentes

De la extracción (references/brand-extraction.md):

python3 "${CLAUDE_SKILL_DIR}/scripts/fonts.py" "<Fuente de Visualización>:400,500,600" "<Fuente del Cuerpo>:400,600" "<Fuente de Etiqueta>:400,500"
python3 "${CLAUDE_SKILL_DIR}/scripts/tokens.py" --brand "#…" --accent "#…" \
  --font-display "<Fuente de Visualización>" --font-body "<Fuente del Cuerpo>" --font-label "<Fuente de Etiqueta>" \
  --display-weight 600 --tracking -0.02em --radius 8px \
  --footer "<Empresa> · Company Brief · <Mes AAAA>" [--cover-stops "#…,#…,#…"] > tokens.html

• Pega las líneas <link> de fonts.py en el marcador FONT LINKS y tokens.html en el marcador TOKENS en brief.html.
• Cada línea del informe de tokens.py debe decir ok. Un WARNING significa elegir colores diferentes (para un color de firma claro, haz que el oscuro sea --brand).
• Fuente de marca propietaria: ejecuta la prueba de sustituto en brand-extraction.md sección 2 y di en el informe qué fuente gratuita la sustituye.
• Si npm no puede instalar fuentes, usa una familia instalada (fc-list : family) y dilo en la sección Tipo.

6. Kit de marca

Sigue references/brand-extraction.md, sección 4. En todos los modos, encuentra el logotipo principal como archivo vectorial (SVG, EPS, AI o PDF vectorial) y las guías de marca públicas más recientes; en modo de trabajo de marca, también fuentes, especificaciones de color, imágenes, plantillas, textos estándar y términos de uso. Envía las búsquedas juntas. Para cada elemento, registra el enlace, el formato que confirmaste al abrirlo, la fuente (oficial o de terceros), su fecha y un estado: Actual, Desactualizado, Obsoleto, Solicitar acceso o No encontrado. Verifica que el archivo de logotipo coincida con el logotipo en el sitio en vivo hoy.

7. Sintetizar

Lee todo el archivo de notas, luego decide la conclusión, las tres cosas a saber, la tarjeta de puntuación, su lenguaje, prioridades → puntos de conversación, la propuesta de 30 segundos, el enfoque, preparación de entrevista, preguntas para hacer, qué hacer y qué no hacer, antes de firmar (solo oferta) y acercamiento. Guía para cada uno: references/research-playbook.md sección 7.

8. Escribir brief.html

Reemplaza cada {{placeholder}} en la plantilla, añade filas y elementos según sea necesario, y elimina solo las secciones que la plantilla marca como condicionales. Reglas de marcado y escritura: references/components.md. Mantén el CSS específico del informe pequeño y en el bloque de anulación de la plantilla. Apunta a 14–20 páginas.

9. Renderizar y auditar

node "${CLAUDE_SKILL_DIR}/scripts/render.cjs" brief.html "<Empresa>-Company-Brief-<AAAA-MM>.pdf" \
  || python3 "${CLAUDE_SKILL_DIR}/scripts/render.py" brief.html "<Empresa>-Company-Brief-<AAAA-MM>.pdf"

• El renderizador Node sale con código 2 si Playwright falta, lo que desencadena el de Python. render.py prueba Playwright, luego un binario de Chrome, luego WeasyPrint (pip install weasyprint).
• Corrige cada línea FAIL (fuente no cargada, texto con contraste inferior a 4.5:1, placeholder sobrante) y renderiza de nuevo.
• Si estás en la computadora de alguien y nada renderiza, pregunta antes de instalar un renderizador (pip install playwright && python -m playwright install chromium).

10. Verificar

• Diseño: python3 "${CLAUDE_SKILL_DIR}/scripts/contact_sheet.py" <pdf> sheet.png, luego mira la imagen. La portada es a sangre completa sin pie de página; el resumen cabe en la página 2; cada parte comienza en una página nueva; nada está recortado; ninguna tabla se desborda; no hay páginas casi vacías; ningún encabezado queda aislado al final de una página. Renderiza una página dudosa más grande con pdftoppm -r 150 -f N -l N -png <pdf> page y mira de nuevo.
• Hechos: cada número en el PDF coincide con el archivo de notas, lleva una etiqueta y aparece en Fuentes. Las fechas son absolutas. La otra empresa del mismo nombre no está mezclada.
• Texto: lee las reglas de escritura de references/components.md una vez más contra el texto.
• Enlaces: abre 5 o más enlaces de Fuentes para confirmar que resuelven, y abre cada enlace del Kit de marca para confirmar que resuelve al formato listado.

11. Entregar

• Envía el PDF como archivo. En modo de trabajo de marca, envía también <Empresa>-Brand-Kit.md: la tabla del kit como enlaces simples, lista para pegar en un documento de proyecto o canal. Si la persona guarda informes en una carpeta de su computadora y puedes acceder a ella, guárdalo allí también.
• Responde en unas pocas líneas: la conclusión en dos frases, los 2–3 puntos de conversación más agudos, cualquier cosa importante que no hayas podido encontrar, y un siguiente paso útil (una carta de presentación adaptada, una nota de acercamiento, preguntas de entrevista simuladas, una agenda de inicio o una versión compartible). En modo de trabajo de marca, di qué archivos de logotipo y guía encontraste y qué necesitará solicitar el equipo.