goromal/agent-skills

Úselo cuando esté a punto de editar, crear o eliminar una habilidad de agente. Las habilidades compartidas provienen del repositorio agent-skills; las habilidades locales posteriores permanecen en su repositorio propietario.

¿Qué es agent-skills?

Este conjunto de habilidades gestiona el ciclo de vida completo de las habilidades de agentes de IA (como Claude Code, Cursor, Codex) dentro de un espacio de trabajo de Nix. Permite a los desarrolladores crear, editar y eliminar tanto habilidades compartidas (almacenadas en un repositorio central `agent-skills`) como habilidades locales (que residen en el repositorio de un proyecto consumidor). La habilidad se encarga de orquestar las dependencias entre el repositorio fuente de habilidades y los repositorios consumidores, utilizando ramas de características, flake inputs de Nix y mecanismos de bloqueo para garantizar la consistencia. Es especialmente útil en entornos donde múltiples máquinas o proyectos comparten un catálogo de habilidades, permitiendo exclusiones y reemplazos por máquina mediante configuraciones declarativas. La habilidad está diseñada para plataformas como Claude, Codex y home-manager, y su funcionamiento se basa en la manipulación de archivos SKILL.md, catálogos Nix y overlays de configuración.

Compatible con✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/editing-skills

Documentación

De dónde vienen las habilidades instaladas

Las habilidades de agente se instalan mediante home-manager en ~/.claude/skills/, ~/.agents/skills/ y ~/.codex/skills/. Estas rutas gestionadas enlazan al directorio fuente de la habilidad. Edite el repositorio propietario en lugar de un enlace instalado.

Las fuentes y recursos de habilidades compartidas residen en el directorio agent-skills/skills/<name>/ del espacio de trabajo. El catálogo Nix en agent-skills/catalog.nix selecciona las habilidades compartidas para los consumidores. Los overlays posteriores pueden agregar rutas de habilidades locales a través de su propia configuración machines.claude.skills y machines.codex.skills; mantenga esos archivos en el repositorio posterior.

Editar una habilidad compartida

Edite su directorio en el checkout de agent-skills del espacio de trabajo.
Si el cambio también actualiza a un consumidor, use la misma rama de características en ambos repositorios. Agregue agent-skills al espacio de trabajo con addsrc agent-skills [email protected]:goromal/agent-skills.git si no está presente.
Pruebe una integración de anixpkgs utilizando una entrada flake local temporal si es necesario. Antes de enviar, restaure la URL de la rama de características remota y bloquéela con nix flake update agent-skills.
Abra el PR de agent-skills y enlácelo desde el PR del consumidor. Fusione primero el PR fuente de la habilidad, luego vuelva a fijar los consumidores a la revisión main fusionada.

Crear una habilidad compartida

Agregue skills/<skill-name>/SKILL.md en agent-skills; mantenga referencias, ejemplos, scripts y activos junto a él.
Agregue { name = "<skill-name>"; file = ./skills/<skill-name>/SKILL.md; } a catalog.nix. Las entradas se aplican a Claude y Codex por defecto; establezca frameworks cuando sea necesario.
Enlace los recursos de apoyo de forma relativa a la carpeta de la habilidad y actualice los bloqueos posteriores.

Editar una habilidad local posterior

Cámbiela en el repositorio que posee el overlay o módulo que contribuye con la ruta de la habilidad. Mantenga el directorio autocontenido, incluyendo las referencias. Su configuración puede agregar una entrada { name, file } a la opción de habilidades del framework.

Eliminar o reemplazar una habilidad compartida

Elimine su entrada de catalog.nix y borre su carpeta fuente, luego actualice los bloqueos posteriores. Para reemplazar una habilidad compartida en una máquina, enumere su nombre en machines.agents.excludedSkills y agregue la ruta de la habilidad local con ese nombre en el módulo posterior.