Skills

Las nueve skills existen porque las partes mecánicas (crear estructura, frontmatter, regeneración de índices, validación) son tediosas, y hacerlas por ti deja el tiempo para la parte que solo puedes hacer tú: decidir qué es la cosa.

Las skills son opcionales. El Framework no.

Puedes escribir cada archivo a mano; nada en el estándar depende del tooling. Pero mantén _eidos/ en disco de todas formas. El Framework (el marco) es lo que te mantiene fiel al estándar: sin él, la forma con la que escribes vive en tu cabeza, se desvía un poco con cada Blueprint y deja de ser un estándar en el momento en que otra persona escribe uno.

Una skill es una carpeta con un SKILL.md dentro, así que cualquier agente que lea ese formato puede ejecutarlas. El estándar sobre el que operan es neutral respecto al agente por diseño.

El camino de escritura

Tres skills se solapan, y elegir la equivocada es la fuente habitual de una mala sesión:

Tienes	Usa	Produce
Una idea, a medio formar	iterate	Una comprensión. Ningún archivo.
Algo que ya has decidido	eidos	El Blueprint
Un borrador ya escrito	format	Las mismas palabras, con forma

Las nueve

iterateCuestiona una idea en bruto hasta que se queda quieta. No escribe nada.

eidosEscribe y valida Blueprints. La skill principal.

formatRemodela un borrador en bruto, preservando tus palabras.

installLevanta una raíz donde no la hay.

configureAñade una colección, flavor o propiedad; la rellena retroactivamente.

indexReconstruye el listado generado de cada colección.

canvasDibuja los Blueprints como un canvas de Obsidian.

whoamiDefine quién está en el asiento: rol y calibración.

migratePasa a otra versión del estándar.

Instalación

Claude Desktop / Web

Customize → Plugins → + → Add marketplace from repository, y dale el repositorio:

https://github.com/BuildableWorks/Eidos

Luego instala eidos desde ese marketplace. Cualquier plan de pago.

Desktop ejecuta cada skill acotada a su propia carpeta, y todas las skills son autocontenidas, así que esto se comporta exactamente igual que en Claude Code.

Si prefieres subir un archivo antes que añadir un repositorio, o estás compartiendo un Framework privado, construye el zip desde un clon y elige upload a custom plugin file:

./scripts/package-plugin.sh   # → dist/eidos-plugin.zip

Claude Code

El repositorio es un marketplace público de plugins:

/plugin marketplace add BuildableWorks/Eidos
/plugin install eidos@eidos

Para desarrollo contra un clon local:

claude --plugin-dir /path/to/eidos     # ephemeral, one session

O coloca una carpeta directamente, sin plugin de por medio: <repo>/.claude/skills/<name>/ para un proyecto, ~/.claude/skills/<name>/ para todas partes. Una copia de proyecto gana sobre una global.

Codex

Codex busca skills en .agents/skills/, empezando por la más cercana: la raíz del repositorio, y luego ~/.agents/skills/ para todos los repositorios. Copia las carpetas dentro:

git clone https://github.com/BuildableWorks/Eidos.git
mkdir -p .agents/skills && cp -r Eidos/skills/* .agents/skills/

Nada que configurar. Codex recoge cualquier carpeta cuyo SKILL.md lleve name y description, que es el caso de todas las skills de Eidos. Para desactivar una sin borrarla, añádela a ~/.codex/config.toml:

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Cualquier otro agente

No hay empaquetado para ello, pero tampoco hay nada que empaquetar: cada skill es una carpeta autocontenida con un SKILL.md, y el formato es un estándar abierto.

Copia las carpetas allí donde tu agente lea instrucciones, y apúntalo hacia ellas como espere. Las tres que necesitan parte del estándar llevan una copia versionada, así que nada se rompe al moverlas.

Por qué tres skills llevan una copia del estándar

Notarás que EIDOS.md, seeds/ y versions/ aparecen dos veces en el repositorio: una en la raíz y otra dentro de unas pocas carpetas de skill. Es deliberado.

Las copias de nivel superior son la fuente de verdad y la superficie pública de revisión. Pero una skill a menudo no puede alcanzarlas una vez instalada:

• Claude Desktop aísla cada skill en su propia carpeta: sin archivos hermanos.
• Una instalación desde un marketplace de git envía solo lo versionado: nada que esté en gitignore llega jamás.

Así que las tres que necesitan parte del estándar la llevan, versionada: eidos (el conjunto de reglas), install (las semillas) y migrate (el historial de versiones). Las otras seis leen el Framework de tu raíz en tiempo de ejecución y no necesitan nada.

scripts/sync-skills.sh regenera esas copias desde las fuentes de nivel superior, y --check falla si alguna se ha desviado.

Nota

El compromiso se eligió a propósito. Poner las copias en gitignore rompe las instalaciones de Desktop; quitar las copias de nivel superior costaría el único hogar revisable del estándar. Así que existen las dos, y un script las mantiene unidas.

Añadir la tuya

Crea skills/<tu-skill>/SKILL.md y se distribuye con el plugin automáticamente.

Para compartir un Framework con un colega, dale el zip autocontenido que construye el script de empaquetado, o súbelo a un repositorio git privado y comparte la URL.