CommunityImagengithub.com

font-design

Diseña, construye y entrega una tipografía display personalizada para un sitio web como una fuente variable web autoalojada — un diseño paramétrico dibujado para la marca, elegido a través de tres rondas de páginas conceptuales. Úsalo cada vez que el operador quiera dibujar, fabricar o construir una tipografía personalizada, única, a medida, propia o de marca; quiera una fuente para titulares, display, títulos o heroínas dibujada para él en lugar de elegida de un catálogo; quiera su propia fuente en lugar de una Google Font o una fuente estándar; quiera una marca de palabra o una letraforma derivada de un logotipo, una fuente variable con ejes de peso o tamaño óptico, o una itálica o un nuevo peso para dicha fuente; o pida "hacer una fuente como Bract o Driftwood", para ajustar, extender o reevaluar dicha fuente, o para ejecutar el espectro de páginas conceptuales para un nuevo aspecto.

¿Qué es font-design?

Esta habilidad permite a un agente de IA diseñar y construir una tipografía display personalizada y autoalojada para un sitio web, siguiendo un proceso de nueve fases riguroso e iterativo, desde la auditoría del sitio hasta el envío. Está diseñada para usarse en proyectos donde se necesita una fuente única y a medida en lugar de seleccionar una de un catálogo, incluyendo fuentes variables con ejes como peso o tamaño óptico. Las herramientas y reglas se basan en la experiencia de proyectos anteriores como Bract y Driftwood, y el proceso incluye rondas de revisión independiente y pruebas automatizadas. La habilidad se ejecuta en sistemas macOS y Linux (no en Windows nativo, pero sí en WSL) y requiere Node.js, Python con paquetes específicos (fonttools, brotli, etc.), y otras herramientas como Chrome. El agente guía al operador a través de cada fase, deteniéndose en las puertas de decisión para que el operador revise y apruebe el progreso antes de continuar.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/windaddict/font-design-skill/tree/HEAD

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace font-design?

Versión 0.2.0 — la única fuente de verdad es el archivo VERSION en la raíz del repositorio; esta línea, el frontmatter y la insignia del README se verifican contra él mediante tests/test_versions_and_skill.py. Di este número de versión cuando comiences, para que el operador sepa qué copia está respondiendo.

Esta habilidad crea una tipografía del mismo modo que se creó Bract (hopsafari.com, 2026-11-15): las nueve fases siguientes, ejecutadas una vez en su totalidad. El generador y muchas de las reglas provienen de una tipografía anterior, Driftwood (movingavg.com, 2026-11-14), que se construyó antes de que el proceso se documentara, mediante un pipeline de unión estática en cinco archivos CFF; sus lecciones y los tres errores encontrados posteriormente dieron forma a la habilidad, pero no pasó por estas fases. Ambas son diseños de John Knox (NOTICE.md). La forma del trabajo es: auditar el sitio, derivar pautas, elegir un diseño a través de tres rondas de páginas conceptuales, planificar la construcción y hacer que el plan sea revisado de forma independiente, construir con autocomprobaciones, revisar la fuente construida en páginas reales hasta que una ronda no encuentre nada, hacer que el cambio terminado sea revisado de forma independiente, enviar. La habilidad se ejecuta con poca supervisión entre las puertas y se detiene en cada puerta.

Contenido

  1. Antes de empezar
  2. Las nueve fases (cada una con su puerta)
  3. Trabajar con poca supervisión
  4. Bloqueadores de publicación
  5. Qué son las herramientas y qué demuestra cada una
  6. Índice de referencia

1. Antes de empezar

  1. Indica la versión (arriba) y clasifica el cambio. Una fuente display para todo el sitio es un cambio significativo: afecta a páginas públicas y es difícil de revertir una vez vinculada y en caché. Sigue el orden completo: plan → revisión independiente → construcción → revisión independiente. Un ajuste de parámetros dentro de un concepto ya revisado es rutinario: construir, probar, una ronda de diseño.
  2. Verifica las herramientas y di cuáles están presentes. Ejecuta la comprobación, no asumas:
    • node --version (≥ 20); el venv propio de la habilidad en <directorio de la habilidad>/.venv, creado con python3 -m venv .venv && .venv/bin/pip install -r requirements.txt en el directorio de la habilidad (fonttools 4.68.x, brotli, skia-pathops, pillow, uharfbuzz, unicodedata2); Chrome ($CHROME o el predeterminado por SO que scripts/shoot.py busca); la habilidad Impasse (~/.claude/skills/impasse); el plugin frontend-design; y el modelo más potente que ofrezca la herramienta Agent (llamado "Fable" en los registros de este repositorio; usa el más potente donde estés).
    • Cada comando de Python en esta habilidad se ejecuta en el intérprete de ese venv, y el comando lo escribe explícitamente. Escribe .venv/bin/python3 scripts/<herramienta>.py ..., nunca un python o python3 simple, que en un Mac con Homebrew es un intérprete diferente sin fonttools. Ningún comando puede depender de una variable o un directorio establecido en una llamada anterior de Bash: en la mayoría de los hosts, una llamada no recuerda la anterior. "Encontrar la carpeta de la habilidad" a continuación explica cómo convertir la forma abreviada en un comando que se ejecute desde cualquier directorio.
    • Ejecuta .venv/bin/python3 scripts/check-env.py primero. Enumera la plataforma, Python ≥ 3.10, los cuatro requisitos con sus versiones fijadas, Node ≥ 20, Chrome y bash según se encuentren o falten, imprime el comando de corrección exacto para cada falta y sale con 1 si falta alguno. (Antes de que exista el venv, ejecuta el mismo script con cualquier Python 3: solo usa la biblioteca estándar e imprime el comando del venv). macOS y Linux son compatibles; Windows nativo no lo es (scripts bash, rutas POSIX del venv); en Windows ejecuta toda la habilidad dentro de WSL.
    • Ejecuta bash scripts/smoke.sh antes del primer uso de la habilidad en una máquina y después de cada actualización de la habilidad, antes de comenzar un proyecto: construye los tres fixtures, ejecuta la suite y las mutaciones, ejecuta la puerta de FontBakery (omitida, y así se indica, cuando FontBakery no está instalado) y construye las páginas conceptuales (--full agrega los pasos del navegador y la verificación del entorno).
    • Para cualquier elemento faltante, lee references/fallbacks.md antes de continuar; nunca omitas una puerta en silencio, y nunca permitas que el propio contexto del constructor sea el revisor.
  3. Haz las preguntas iniciales, en un solo mensaje, y registra las respuestas textualmente en el plan: el objetivo en palabras del operador (esta frase se cita a cada revisor); qué sitio y qué páginas; la fuente de texto que debe acompañar; fuentes de la marca (marca, colores, materiales, historia); pesos y si se desea una itálica; candidatos a nombre; el propietario y la licencia de la tabla de nombres (sin valor predeterminado: pregunta cada vez) y el permiso de incrustación de la fuente, names.fs_type (sin valor predeterminado: 4, Vista previa e impresión, es la configuración habitual para una fuente propietaria y 0, Instalable, para una abierta; 2, Restringida, hace que algunas herramientas rechacen la fuente; los navegadores ignoran el campo para fuentes web); el presupuesto de tamaño; si las páginas conceptuales pueden publicarse como artefactos de claude.ai; el consentimiento para enviar artefactos a Impasse (un proveedor externo); quién despliega y cuándo. Decide dónde residirán los archivos del proyecto (la convención es tools/<fuente>/ en el repositorio del sitio), pero no crees nada todavía: cada archivo se crea en la fase que produce sus entradas: requirements.json en la fase 2, concepts.js en la fase 3, font.json y la copia de scripts/ en la fase 7, una vez que el plan de la fase 6 haya definido los maestros y ejes. Durante un proyecto, no se escribe nada en la carpeta de la habilidad instalada: los archivos temporales (la exportación del plan, la verificación previa del conjunto de caracteres, las mediciones) van a tools/<fuente>/work/ del proyecto, que el .gitignore del sitio nombra.

Encontrar la carpeta de la habilidad

Cada ruta scripts/, references/ y templates/ en este archivo es relativa a la carpeta que contiene este SKILL.md, la carpeta de la habilidad. Encuentra su ruta absoluta una vez por llamada de Bash, según el host:

  • Claude Code: ${CLAUDE_SKILL_DIR}, que Claude Code proporciona para la habilidad que se está ejecutando. Cuando está vacío, la carpeta de instalación ~/.claude/skills/font-design.
  • Codex: la ruta absoluta que Codex muestra en su lista de habilidades disponibles. Usa esa ruta, no una carpeta de instalación adivinada.
  • Cualquier otro host: la ruta absoluta del directorio que contiene el SKILL.md que se cargó. Léela desde donde el host cargó el archivo; no elijas entre carpetas de instalación por cuál existe.

Cada comando en este archivo está escrito en la forma abreviada escrita desde la carpeta de la habilidad, .venv/bin/python3 scripts/<herramienta>.py .... Para ejecutar uno desde otro directorio, antepone la ruta absoluta de la carpeta de la habilidad tanto a .venv/bin/python3 como a scripts/, o comienza la llamada de Bash con cd "<carpeta de la habilidad>" &&; proporciona los archivos propios del proyecto (font.json, la raíz del sitio) como rutas absolutas. Una copia de los scripts del proyecto, tools/<fuente>/scripts/, se ejecuta de la misma manera, con el intérprete de la habilidad: <carpeta de la habilidad>/.venv/bin/python3 tools/<fuente>/scripts/....

2. Las nueve fases

Cada fase nombra su archivo de referencia, lo que produce y la puerta en la que el operador decide. No pases una puerta por tu cuenta.

Fase 1 — Auditar primero el sitio (references/site-audit.md)

Una fuente dibujada para páginas que están a punto de cambiar se dibuja para las páginas equivocadas. Fotografía el sitio construido con .venv/bin/python3 scripts/shoot.py SALIDA --serve <directorio estático> --pages index.html <página>.html --widths 500 1280 1600 --scales 1 2. Chrome headless diseña a un mínimo de 500 px, así que para la lectura de 360 px fotografía scripts/narrow.html, que shoot.py sirve en __fd/ y que informa del scrollWidth de la página interna contra su clientWidth dentro de un iframe: .venv/bin/python3 scripts/shoot.py SALIDA --serve <directorio estático> --pages __fd/narrow.html --widths 500 --scales 1 --dump-dom --no-sentinel --query url=/<página>.html --query width=360. Lee el .dom.html volcado: la página pasa solo cuando <html> lleva data-fd-overflow="false" y data-fd-narrow-stage="fonts" (la lectura tomada después de que las fuentes web se hayan estabilizado; una lectura de etapa "load" se tomó antes de ellas y no cuenta). Ejecuta el pase estético con el plugin frontend-design cuando esté instalado; de lo contrario, usa la lista de calibración en site-audit.md. Enumera las "señales de IA" (etiquetas que repiten el encabezado debajo de ellas, tarjetas en caja que se elevan al pasar el ratón, reglas como decoración, dos navegaciones o dos formatos de fecha, copia repetida o enigmática, chrome más fuerte que el contenido), di para cada una qué cambia para la fuente y propón cuáles corregir antes de que la fuente sea dibujada. Registra la auditoría con templates/reviewer-brief-audit.md. La fase 1 audita y propone; no se corrige nada antes de la puerta.

Puerta: el operador selecciona qué elementos se corrigen antes de la fuente y cuáles esperan. Luego implementa las correcciones seleccionadas en una rama, cada una vigilada por una prueba que se espera que falle, y confírmalas en su propio commit antes de la fase 2 (Bract: hop-safari 2daac34, antes del 90a085c de la fuente): son cambios de diseño del sitio que el operador juzgó en esta puerta, y los conceptos se juzgan en esas páginas. El cambio de fuente en sí comienza después de ellos y permanece sin confirmar hasta la fase 9; "no confirmar nada" en la fase 7 significa el cambio de fuente.

Fase 2 — Pautas del sitio (references/guidelines.md)

Encuentra cada elemento que la fuente display establece antes de la extracción. Proporciona a ambas herramientas --family <la familia display en uso hoy> (mine-sizes.py <css> --family 'Bodoni Moda'; mine-charset.py --html <directorio de páginas construidas> --css <css> --family 'Bodoni Moda'): cada regla cuyo font-family la nombra primero da sus selectores, incluidos los bloques @media, y la lista se imprime. Un h1,h2,.plate-title escrito a mano en el sitio fixture omitió .frontis-title, .wordmark y un .num de 15.2 px, lo que movió el suelo de 44.6 a 49.3 unidades. El límite: no se encuentra un selector que hereda la fuente de body (un sitio cuyos encabezados y cuerpo comparten una familia), y no se lee una familia establecida a través de la abreviatura font: o una propiedad personalizada; entonces nombra los selectores a mano a partir de las plantillas y agrega --selectors para cualquier elemento que la regla de la familia no detecte. Ejecuta .venv/bin/python3 scripts/mine-sizes.py <css> --family <familia display actual> --root 100 150 para los tamaños que la fuente debe soportar con una raíz de 16 px y una raíz ampliada por el lector, y el suelo de línea fina (un píxel CSS en el tamaño más pequeño es 1000/unidades de tamaño; una línea fina debe permanecer en aproximadamente 0.75 px, --floor-px), y .venv/bin/python3 scripts/mine-charset.py --html <directorio de páginas construidas> --css <css> --family <familia display actual> para el conjunto de caracteres del texto que esos selectores establecen en las páginas construidas y sus trampas (espacios de no separación en títulos, apóstrofos escritos como ASCII ', #, +, *, letras acentuadas y las mayúsculas que una regla text-transform hace que el navegador dibuje, en el selector, en un descendiente o en una clase dentro del texto, que solo --css puede ver). Lo que no ve, por lo que el conjunto no es exacto: texto establecido en la fuente mediante un estilo en línea, mediante script o mediante un selector que no puede leer (la sección 6 de references/guidelines.md los enumera); nómbralos manualmente. --titles <archivo> lee un título por línea en lugar de páginas construidas, y --json en cualquiera de ellos da la forma legible por máquina. Escribe las pautas: tamaños, suelo, los dos ejes de contraste con la fuente de texto, pesos, mayúsculas/minúsculas, conjunto de caracteres, lecciones de precedentes.

Crea requirements.json ahora a partir de templates/requirements.example.json. Es la expectativa revisada contra la que las pruebas comparan la fuente, y solo cambia con el operador (encontrar F002 en docs/plan.md). De dónde viene cada campo y cuándo:

CampoFuenteCuándo
required_characters, titlesmine-charset.py --json: required_characters textualmente; los títulos de su informe de título más largo y los títulos reales del sitioahora
cmapel valor de la plantilla: el conjunto de glifos del generador más los glifos de espacio y comilla del constructor, que es el mismo para cada proyecto; un glifo agregado en extra-glyphs.js se agrega aquí tambiénahora, editado solo cuando se agrega un glifo
nameslas preguntas iniciales (sección 1, elemento 3): propietario, licencia, proveedorahora; si el operador no ha respondido, el campo permanece como el marcador de posición de la plantilla y la fase 7 no puede comenzar (font.json names se completa a partir de las mismas respuestas)
groups.*.axes, masters, instances, avar, interpolated_checkel plan de la fase 6fase 6, antes de que exista font.json
groups.*.hairline_floorsla primera ejecución de export.js de la fase 7 (minStrokeWidth por maestro, redondeado hacia abajo), y cada maestro que sirve al tamaño display más pequeño debe medir igual o por encima del objetivo que mine-sizes.py imprimió (1000 × 0.75 / px más pequeño); un mínimo medido por debajo de ese objetivo es un hallazgo de diseño (engrosar thin, o mover los elementos más pequeños a la fuente de texto, decisión de puerta 3), no un suelo para registrar. Los numerales de 15.2 px de Bract midieron 0.70 px contra el objetivo de 0.75 y su registro lleva eso como un elemento abierto, no un aprobado. Los números de la plantilla son los de la fuente de ejemplo ficticiafase 7, la primera exportación
groups.*.word_space, hand_kernsla misma primera exportación (su espacio de palabra por maestro) y los pares manuales del planfase 7
size_budget_bytes, fold_units, gasplas preguntas iniciales (presupuesto) y los valores de la plantillaahora
names.fs_type, tables (code_page_range1, prep_hex, mac_names)las preguntas iniciales (el permiso de incrustación) y los valores de la plantillaahora
groups.*.vertical_metrics (ascender, descender, line_gap)la línea de autocomprobación vertical metrics written de la primera construcción, luego revisada: es el line-height: normal de la fuente donde una plataforma lee hhea o typo (las métricas de win no están cubiertas)fase 7, la primera construcción
accepted_qa_findings ([{id, reason, codes?}]; codes limita los códigos de mensaje aceptados)la primera ejecución de la puerta de FontBakery, cada entrada leída antes de ser aceptada; [] hasta entoncesfase 7

No hay una clave sizes: los tamaños residen en las pautas y en font.json review.sizes.

Puerta: pautas escritas y mostradas, y tres decisiones preguntadas explícitamente, una pregunta cada una, y registradas en las pautas y requirements.json antes de que se dibuje cualquier concepto:

  1. Cada carácter que el generador

...

Skills relacionados