Skills
Las tres skills que trae vexillum para un commander de Claude Code, Pi u OpenCode, para qué sirve cada una y cómo upgrade las mantiene al día.
Qué es una skill
Una skill es un directorio con un SKILL.md (y archivos de apoyo opcionales) que Claude Code carga a pedido (un commander de Pi u OpenCode lee el mismo directorio .claude/skills, mirá Pi como commander y OpenCode como commander): al arrancar lee la descripción corta de cada skill, y carga el texto completo solo cuando la tarea coincide. Por eso vexillum saca el detalle operativo del slot de AGENTS.md, que siempre está activo, y lo pone en skills: el commander paga el detalle solo cuando despacha, aterriza, hace ship o libera.
El slot termina con una instrucción dura de cargar la skill vexillum antes de cualquiera de esos pasos, para que el detalle a pedido no quede librado al azar.
Las tres skills
| Skill | Para qué sirve |
|---|---|
vexillum | El manual de operación del commander: despachar un soldier, elegir modelo y effort desde models.json, aterrizar, hacer ship, hacer strike de un camp y atender al sentinel. Además de SKILL.md trae landing.md, shipping.md y sentinel.md, que se leen en el momento que corresponde. |
forum | El bucle de revisión en el navegador detrás de vx forum: abrir un plan, comparación, diagrama, tabla o formulario de decisión en HTML, recibir tu feedback por el inbox de forum y responder en el navegador. Trae playbooks para cada tipo de artefacto. |
muster | Un tablero con las decisiones que tenés que tomar como tarjetas respondibles, y debajo un resumen de la tropa de missions y scouts. Ver Skill muster. |
El texto completo de cada archivo está en Contenido de las skills, generado desde los archivos embebidos en el binario, así que siempre coincide con lo que se instala:
Dónde se instalan
Las skills están embebidas en el binario vx, así que instalarlas no necesita Node, ni npx, ni red. vx init las escribe en .claude/skills/<name>/ de tu proyecto.
init pregunta antes de instalarlas: después del aviso de consentimiento imprime These skills teach the commander how to use vexillum well. y pregunta Install the vexillum, forum and muster skills? [Y/n]. Las ejecuciones no interactivas deciden con --skills o --no-skills, y --yes acepta. Si decís que no, te quedás con el bloque de vexillum, el hook del sentinel y tu config. Las skills que ya están instaladas nunca se reinstalan.
Sin las skills el commander solo tiene el núcleo
El slot por sí solo le indica al commander que cargue la skill vexillum. Si no la instalaste, el commander no tiene un manual que cargar. Instalalas después con vx upgrade --skills.
Cómo las mantiene al día upgrade
vx init y vx upgrade registran un hash de contenido por skill en .vexillum/config.json, calculado sobre todos los archivos de la skill (ruta y contenido, en orden de ruta). vx upgrade compara cada skill instalada con la copia embebida en el binario nuevo y con el hash que registró:
| Skill instalada | Qué hace upgrade |
|---|---|
| vigente | nada |
| atrasada respecto de la copia del binario, y sin editar | la refresca |
| editada por vos | la deja como está y lo dice (Skill <name>: edited by hand, left as it is; rerun with --force to overwrite it (a backup is saved first)) |
| un symlink | la deja en paz: la administrás vos |
| faltante | no se reinstala sola, así que una skill que sacaste a propósito sigue sacada; vx upgrade --skills la instala. Cuando no hay ninguna skill instalada ofrece instalarlas como init |
vx upgrade --force sobrescribe una skill editada con la embebida, después de guardar tu versión en .vexillum/backups/skills/<name>/. --no-skills deja las skills como están: sin instalar ni refrescar.
vx doctor reporta cada skill como installed, current, installed, stale, installed, edited by hand o missing, y anota un symlink. Ver Actualización.
Editar una skill
Las copias instaladas son archivos comunes de tu proyecto, así que las podés leer y ajustar. upgrade marca una skill editada en vez de reemplazarla, y --force la reemplaza después de un backup. Para los valores que cambiás seguido, preferí el archivo dedicado que nunca se pisa: la tabla de modelo y effort vive en models.json, no en la skill.