设计与创意 · SKILL.md

create-glyph

create-glyph

【设计与创意】Crear pictogramas (glyphs) basados en R para iconos de habilidades, agentes o equipos en la capa de visualizacion. Cubre el boceto del concepto, la composicion de capas con ggplot2 usando la biblioteca de primitivas, la estrategia de color, el registro en el archivo de mapeo de glyphs y manifiesto correspondiente, el renderizado mediante el pipeline …

独立 GitHub 快照 · 自动分类 · 以原作者文档为准

Ppjt222 / agent-almanacMIT

技能说明

GitHub

name: create-glyph locale: es source_locale: en source_commit: 33b561c9 fence_basis_commit: 33b561c9 translator: claude translation_date: "2026-03-18" description: > Crear pictogramas (glyphs) basados en R para iconos de habilidades, agentes o equipos en la capa de visualizacion. Cubre el boceto del concepto, la composicion de capas con ggplot2 usando la biblioteca de primitivas, la estrategia de color, el registro en el archivo de mapeo de glyphs y manifiesto correspondiente, el renderizado mediante el pipeline de construccion y la verificacion visual de la salida con efecto neon. Usar cuando se ha agregado una nueva entidad y necesita un icono visual para la visualizacion de grafo de fuerzas, cuando un glyph existente necesita reemplazo, o al crear glyphs en lote para un nuevo dominio. license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "2.0" domain: design complexity: intermediate language: R tags: design, glyph, pictogram, icon, ggplot2, visualization, neon

Crear Glyph

Crear pictogramas (glyphs) basados en R para iconos de habilidades, agentes o equipos en la capa de visualizacion viz/. Cada glyph es una funcion pura de ggplot2 que dibuja una forma reconocible en un lienzo de 100x100, renderizada con un efecto de resplandor neon sobre fondo transparente en formato WebP.

Cuando Usar

Se ha agregado una nueva habilidad, agente o equipo y necesita un icono visual
Un glyph existente necesita reemplazo o rediseno
Creacion en lote de glyphs para un nuevo dominio de habilidades
Prototipado de metaforas visuales para conceptos de entidades

Entradas

Requerido: Tipo de entidad — skill, agent o team
Requerido: ID de la entidad (p. ej., create-glyph, mystic, r-package-review) y dominio (para habilidades)
Requerido: Concepto visual — lo que el glyph debe representar
Opcional: Glyph de referencia para estudiar el nivel de complejidad
Opcional: Valor personalizado de --glow-sigma (predeterminado: 4)

Procedimiento

Paso 1: Concepto — Disenar la Metafora Visual

Identificar la entidad a iconificar y elegir una metafora visual.

Leer el archivo fuente de la entidad para comprender su concepto central:
- Habilidades: skills/<id>/SKILL.md
- Agentes: agents/<id>.md
- Equipos: teams/<id>.md
Elegir un tipo de metafora:
- Objeto literal: un matraz para experimentos, un escudo para seguridad
- Simbolo abstracto: flechas para fusion, espirales para iteracion
- Compuesto: combinar 2-3 formas simples (p. ej., documento + pluma)
Consultar glyphs existentes para calibrar la complejidad:

Complexity Tiers:
+----------+--------+-------------------------------------------+
| Tier     | Layers | Examples                                  |
+----------+--------+-------------------------------------------+
| Simple   | 2      | glyph_flame, glyph_heartbeat              |
| Moderate | 3-5    | glyph_document, glyph_experiment_flask    |
| Complex  | 6+     | glyph_ship_wheel, glyph_bridge_cpp        |
+----------+--------+-------------------------------------------+

Decidir un nombre de funcion: glyph_<nombre_descriptivo> (snake_case, unico)

Esperado: Un boceto mental claro de la forma con 2-6 capas planificadas.

En caso de fallo: Si el concepto es demasiado abstracto, recurrir a un objeto concreto relacionado. Revisar glyphs existentes del mismo dominio para inspiracion.

Paso 2: Componer — Escribir la Funcion del Glyph

Escribir la funcion R que produce capas de ggplot2.

Firma de la funcion (contrato inmutable):

glyph_<name> <- function(cx, cy, s, col, bright) {
  # cx, cy = center coordinates (50, 50 on 100x100 canvas)
  # s = scale factor (1.0 = fill ~70% of canvas)
  # col = domain color hex (e.g., "#ff88dd" for design)
  # bright = brightened variant of col (auto-computed by renderer)
  # Returns: list() of ggplot2 layers
}

Aplicar el factor de escala * s a TODAS las dimensiones para un escalado consistente:

r <- 20 * s        # radius
hw <- 15 * s       # half-width
lw <- .lw(s)       # line width (default base 2.5)
lw_thin <- .lw(s, 1.2)  # thinner line width

Construir la geometria usando las primitivas disponibles:

Geometria	Uso
`ggplot2::geom_polygon(data, .aes(x, y), ...)`	Formas rellenas
`ggplot2::geom_path(data, .aes(x, y), ...)`	Lineas/curvas abiertas
`ggplot2::geom_segment(data, .aes(x, xend, y, yend), ...)`	Segmentos de linea, flechas
`ggplot2::geom_rect(data, .aes(xmin, xmax, ymin, ymax), ...)`	Rectangulos
`ggforce::geom_circle(data, .aes(x0, y0, r), ...)`	Circulos

Aplicar la estrategia de color:

Alpha Guide:
+----------------------+------------+--------------------------+
| Purpose              | Alpha      | Example                  |
+----------------------+------------+--------------------------+
| Large fill (body)    | 0.08-0.15  | hex_with_alpha(col, 0.1) |
| Medium fill (accent) | 0.15-0.25  | hex_with_alpha(col, 0.2) |
| Small fill (detail)  | 0.25-0.35  | hex_with_alpha(bright, 0.3) |
| Outline stroke       | 1.0        | color = bright           |
| Secondary stroke     | 1.0        | color = col              |
| No fill              | ---        | fill = NA                |
+----------------------+------------+--------------------------+

Devolver una list() plana de capas (el renderizador itera y envuelve cada una con resplandor)
Colocar la funcion en el archivo de primitivas correspondiente segun el tipo de entidad:
- Habilidades: agrupadas por dominio en 19 archivos de primitivas:
  - primitives.R — bushcraft, compliance, containerization, data-serialization, defensive
  - primitives_2.R — devops, general, git, mcp-integration
  - primitives_3.R — mlops, observability, PM, r-packages, reporting, review, web-dev, esoteric, design
  - Archivos adicionales primitives_4.R hasta primitives_19.R para dominios mas recientes
- Agentes: viz/R/agent_primitives.R
- Equipos: viz/R/team_primitives.R

Esperado: Una funcion R funcional que devuelve una lista de 2-6 capas de ggplot2.

En caso de fallo: Si ggforce::geom_circle causa errores, asegurarse de que ggforce esta instalado. Si las coordenadas estan mal, recordar que el lienzo es de 100x100 con (0,0) en la esquina inferior izquierda. Probar la funcion interactivamente:

source("viz/R/utils.R"); source("viz/R/primitives.R")  # etc.
layers <- glyph_<name>(50, 50, 1.0, "#ff88dd", "#ffa8f0")
p <- ggplot2::ggplot() + ggplot2::coord_fixed(xlim=c(0,100), ylim=c(0,100)) +
     ggplot2::theme_void()
for (l in layers) p <- p + l
print(p)

Paso 3: Registrar — Mapear Entidad al Glyph

Agregar el mapeo entidad-glyph en el archivo de mapeo correspondiente.

Para habilidades:

Abrir viz/R/glyphs.R
Encontrar la seccion de comentarios del dominio objetivo (p. ej., # -- design (3))
Agregar la entrada en orden alfabetico dentro del bloque del dominio:
```
"skill-id" = "glyph_function_name",
```
Actualizar el conteo del dominio en el comentario si aplica

Para agentes:

Abrir viz/R/agent_glyphs.R
Encontrar la posicion alfabetica en AGENT_GLYPHS
Agregar la entrada:
```
"agent-id" = "glyph_function_name",
```

Para equipos:

Abrir viz/R/team_glyphs.R
Encontrar la posicion alfabetica en TEAM_GLYPHS
Agregar la entrada:
```
"team-id" = "glyph_function_name",
```
Verificar que no exista un ID duplicado en la lista objetivo

Esperado: La lista *_GLYPHS correspondiente contiene el nuevo mapeo.

En caso de fallo: Si la construccion reporta "No glyph mapped", verificar que el ID de la entidad coincide exactamente con el del manifiesto y el registro.

Paso 4: Manifiesto — Agregar Entrada de Icono

Registrar el icono en el archivo de manifiesto correspondiente.

Para habilidades: viz/data/icon-manifest.json

{
  "skillId": "skill-id",
  "domain": "domain-name",
  "prompt": "<domain basePrompt>, <descriptors>, dark background, vector art",
  "seed": <next_seed>,
  "path": "public/icons/cyberpunk/<domain>/<skill-id>.webp",
  "status": "pending"
}

Para agentes: viz/data/agent-icon-manifest.json

{
  "agentId": "agent-id",
  "prompt": "<agent-specific descriptors>, dark background, vector art",
  "seed": <next_seed>,
  "path": "public/icons/cyberpunk/agents/<agent-id>.webp",
  "status": "pending"
}

Para equipos: viz/data/team-icon-manifest.json

{
  "teamId": "team-id",
  "prompt": "<team-specific descriptors>, dark background, vector art",
  "seed": <next_seed>,
  "path": "public/icons/cyberpunk/teams/<team-id>.webp",
  "status": "pending"
}

Esperado: JSON valido con la nueva entrada colocada entre sus entidades del mismo tipo.

En caso de fallo: Validar la sintaxis JSON. Errores comunes: coma final despues del ultimo elemento del arreglo, comillas faltantes.

Paso 5: Renderizar — Generar el Icono

Ejecutar el pipeline de iconos para renderizar el nuevo glifo. Usar siempre build.sh como punto de entrada — se encarga de la deteccion de plataforma y de la seleccion del binario de R. Ver render-icon-pipeline para la referencia completa de opciones y la arquitectura del pipeline.

# From project root — renders all palettes, standard + HD, skips existing icons
bash viz/build.sh --only <domain> --skip-existing          # skills
bash viz/build.sh --type agent --only <id> --skip-existing # agents
bash viz/build.sh --type team --only <id> --skip-existing  # teams

# Dry run first:
bash viz/build.sh --only <domain> --dry-run

build.sh ejecuta el pipeline completo (paleta → datos → manifiesto → renderizado → glifos de terminal). Los pasos que no son de renderizado agregan unos 10 segundos, pero garantizan que todos los datos esten actualizados.

Ubicaciones de salida:

Habilidades: viz/public/icons/<palette>/<domain>/<skill-id>.webp
Agentes: viz/public/icons/<palette>/agents/<agent-id>.webp
Equipos: viz/public/icons/<palette>/teams/<team-id>.webp

Esperado: El registro muestra OK: <entity> (seed=XXXXX, XX.XKB) y el archivo WebP existe.

En caso de fallo:

"No glyph mapped" — Falta el mapeo del Paso 3 o tiene un error tipografico
"Unknown domain" — El dominio no esta en get_palette_colors() en palettes.R
Errores de paquetes R — Ejecutar install.packages(c("ggplot2", "ggforce", "ggfx", "ragg", "magick")) primero
Si el renderizado falla, probar la funcion del glyph interactivamente (ver alternativa del Paso 2)

Paso 6: Verificar — Inspeccion Visual

Comprobar que la salida renderizada cumple los estandares de calidad.

Verificar que el archivo existe y tiene un tamano razonable:

ls -la viz/public/icons/cyberpunk/<type-path>/<entity-id>.webp
# Expected: 15-80 KB typical range

Abrir el WebP en un visor de imagenes para comprobar:
- La forma se lee claramente a tamano completo (1024x1024)
- El resplandor neon esta presente pero no es excesivo
- El fondo es transparente (sin rectangulo negro/blanco)
- No hay recorte en los bordes del lienzo
Comprobar a tamanos pequenos (el icono se renderiza a ~40-160px en el grafo de fuerzas):
- La forma sigue siendo reconocible
- Los detalles no se convierten en ruido
- El resplandor no abruma la forma

Esperado: Un pictograma claro y reconocible con resplandor neon uniforme sobre fondo transparente.

En caso de fallo:

Resplandor demasiado fuerte: re-renderizar con --glow-sigma 2 (el predeterminado es 4)
Resplandor demasiado debil: re-renderizar con --glow-sigma 8
Forma ilegible a tamanos pequenos: simplificar el glyph (menos capas, trazos mas gruesos, aumentar el valor base de .lw(s, base))
Recorte en los bordes: reducir las dimensiones de la forma o desplazar el centro

Paso 7: Iterar — Refinar si es Necesario

Realizar ajustes y re-renderizar.

Ajustes comunes:
- Trazos mas gruesos: aumentar .lw(s, base) — probar base = 3.0 o 3.5
- Relleno mas visible: aumentar el alpha de 0.10 a 0.15-0.20
- Proporciones de la forma: ajustar los multiplicadores de s (p. ej., 20 * s -> 24 * s)
- Agregar/eliminar capas de detalle: mantener el total de capas entre 2-6 para mejores resultados

Para re-renderizar despues de cambios:

# Delete the existing icon first, then re-render
rm viz/public/icons/cyberpunk/<type-path>/<entity-id>.webp
# Use the appropriate build command from Step 5

Cuando se este satisfecho, verificar que el estado del manifiesto muestra "done" (el script de construccion lo actualiza automaticamente al completarse con exito)

Esperado: El icono final pasa todas las verificaciones del Paso 6.

En caso de fallo: Si despues de 3+ iteraciones el glyph aun no se lee bien, considerar usar una metafora visual completamente diferente (volver al Paso 1).

Referencia

Paletas de Color por Dominio y Entidad

Los colores de dominio (para habilidades) estan definidos en viz/R/palettes.R (la unica fuente de verdad). Los colores de agentes y equipos tambien se gestionan en palettes.R. La paleta cyberpunk (colores neon ajustados manualmente) esta en get_cyberpunk_colors(). Las paletas de la familia viridis se generan automaticamente via viridisLite.

Para buscar un color:

source("viz/R/palettes.R")
get_palette_colors("cyberpunk")$domains[["design"]]   # skill domain
get_palette_colors("cyberpunk")$agents[["mystic"]]     # agent
get_palette_colors("cyberpunk")$teams[["tending"]]     # team

Al agregar un nuevo dominio, agregarlo en tres lugares de palettes.R:

PALETTE_DOMAIN_ORDER (alfabeticamente)
Lista de dominios en get_cyberpunk_colors()
Ejecutar bash viz/build.sh para regenerar paletas, datos y manifiestos

Catalogo de Funciones de Glyph

Consultar el catalogo completo de funciones de glyph disponibles en los archivos fuente de primitivas:

Habilidades: viz/R/primitives.R hasta viz/R/primitives_19.R (agrupados por dominio)
Agentes: viz/R/agent_primitives.R
Equipos: viz/R/team_primitives.R

Funciones Auxiliares

Funcion	Firma	Proposito
`.lw(s, base)`	`(scale, base=2.5)`	Ancho de linea consciente de la escala
`.aes(...)`	alias de `ggplot2::aes`	Atajo para mapeo estetico
`hex_with_alpha(hex, alpha)`	`(string, 0-1)`	Agregar alfa a color hexadecimal
`brighten_hex(hex, factor)`	`(string, factor=1.3)`	Aclarar un color hexadecimal
`dim_hex(hex, factor)`	`(string, factor=0.4)`	Oscurecer un color hexadecimal

Lista de Validacion

Errores Comunes

Olvidar * s: Los valores de pixeles codificados directamente se rompen cuando la escala cambia. Siempre multiplicar por s.
Confusion del origen del lienzo: (0,0) esta en la esquina inferior izquierda, no la superior izquierda. Valores de y mas altos mueven ARRIBA.
Doble resplandor: El renderizador ya aplica ggfx::with_outer_glow() a cada capa. NO agregar resplandor dentro de la funcion del glyph.
Demasiadas capas: Cada capa recibe su propio envoltorio de resplandor. Mas de 8 capas hace el renderizado lento y visualmente ruidoso.
IDs no coincidentes: El ID de la entidad en el mapeo del glyph, el manifiesto y el registro deben coincidir exactamente.
Comas finales en JSON: El manifiesto es JSON estricto. Sin coma final despues del ultimo elemento del arreglo.
Color de dominio faltante: Si el dominio no esta en get_cyberpunk_colors() en palettes.R, el renderizado fallara. Agregar el color primero y luego regenerar.
Archivo de primitivas incorrecto: Las habilidades van en primitives*.R agrupados por dominio, los agentes en agent_primitives.R, los equipos en team_primitives.R.

Habilidades Relacionadas

enhance-glyph — mejorar la calidad visual de un glyph existente, corregir problemas de renderizado o agregar capas de detalle
audit-icon-pipeline — detectar glyphs e iconos faltantes para saber que necesita crearse
render-icon-pipeline — ejecutar el pipeline de renderizado completo de principio a fin
ornament-style-mono — generacion de imagenes complementaria basada en IA (Z-Image vs glyphs codificados en R)
ornament-style-color — teoria del color aplicable a decisiones de relleno con acento en glyphs
create-skill — el flujo de trabajo padre que activa la creacion de glyphs al agregar nuevas habilidades

MAKE IT PART OF YOUR WORKFLOW

安装技能

TERMINAL

npx skills add pjt222/agent-almanac --skill create-glyph

复制命令到本地终端执行；安装前请先审查源代码和许可证。

ZIP · 完整技能目录，含资源与许可证

SKILL.md · 仅技能说明原文

仓库 Star: 未同步
许可证: MIT
版本 / 分支: HEAD · 57c07e1d
仓库更新时间: 未同步

安装前，请检查技能脚本与权限。

源代码