reseed: Administrador de Habilidades para Agentes
reseed gestiona una biblioteca personal de habilidades e instala habilidades en proyectos. Las habilidades son directorios que contienen un archivo SKILL.md, siguiendo la especificación de Agent Skills. Viven en el directorio de habilidades de cada proyecto (.agents/skills/ por defecto, o .claude/skills/ para Claude Code) y son leídas por más de 30 agentes (Claude Code, Cursor, Copilot, Codex, Gemini CLI, etc.).
Tu trabajo se centra principalmente en el lado del proyecto: verificar qué está instalado, agregar lo necesario y mantener la sincronización. También puedes ejecutar reseed install cuando el usuario quiera descargar habilidades desde GitHub a su biblioteca, pero deja la estructura y el contenido de la biblioteca en manos del usuario.
Nota: reseed sin argumentos abre una TUI interactiva. Eso es para que el usuario lo ejecute en su propia terminal, no para ti. Si quieren explorar su biblioteca visualmente, diles que ejecuten reseed ellos mismos. Para todo lo demás, usa los comandos CLI a continuación.
Referencia rápida
reseed # TUI interactiva (para el usuario, no para ti)
reseed init <ruta> # crear una nueva biblioteca (configuración inicial)
reseed status # qué está instalado en este proyecto
reseed list -l # qué hay en la biblioteca del usuario (con descripciones)
reseed add <habilidades-o-paquetes...> # copiar habilidades/paquetes de la biblioteca al proyecto
reseed add --all # agregar todas las habilidades de la biblioteca
reseed remove <habilidades...> # eliminar habilidades del proyecto
reseed sync # volver a copiar habilidades instaladas desde la biblioteca (obtener actualizaciones)
reseed install <usuario/repo> # descargar habilidades desde GitHub a la biblioteca
Cómo funciona
- El usuario tiene una biblioteca: un directorio en su máquina que contiene todas sus habilidades. Puede incluir paquetes (grupos con nombre de habilidades relacionadas).
reseed addcopia habilidades de la biblioteca al directorio de habilidades del proyecto. Son copias reales de archivos, no enlaces simbólicos, por lo que aparecen en git y cada miembro del equipo las recibe.reseed syncvuelve a copiar las habilidades que existen tanto en el proyecto como en la biblioteca, incorporando cualquier actualización. Las habilidades que no están en la biblioteca se dejan intactas, incluidos los huérfanos: si una habilidad se eliminó de la biblioteca después de agregarse al proyecto,syncno eliminará la copia obsoleta. Usareseed removepara eso.- No hay manifiesto del proyecto. La sincronización se realiza por nombre de carpeta.
Flujo de trabajo típico
0. Confirmar el directorio de destino
Antes de ejecutar comandos del lado del proyecto, verifica a qué directorio apunta reseed:
reseed config dir
Si esto imprime .agents/skills (default) pero el usuario está en Claude Code (que lee desde .claude/skills/), sugiere ejecutar reseed config dir .claude/skills una vez para cambiar el valor predeterminado global. Pregunta antes de ejecutarlo, ya que cambia la configuración de todo el usuario. Si prefieren no cambiar el valor predeterminado, pasa --dir .claude/skills en cada comando:
reseed --dir .claude/skills add commit
Si reseed config dir ya imprime la ruta correcta, no se necesita anulación. Ejecuta los comandos a continuación tal como están.
1. Verificar qué hay ya
reseed status
Si el directorio de habilidades aún no existe, no importa. reseed lo crea automáticamente cuando agregas habilidades.
2. Ver qué está disponible
reseed list -l
Esto muestra todas las habilidades y paquetes en la biblioteca del usuario con descripciones. Úsalo para entender qué está disponible antes de sugerir qué agregar.
3. Agregar habilidades al proyecto
reseed add commit review python-base # mezclar habilidades y paquetes en un solo comando
reseed add --all # o simplemente agregar todo
Puedes pasar cualquier cantidad de habilidades y paquetes en un solo comando reseed add. reseed expande automáticamente los paquetes en sus habilidades individuales. Elige lo que coincida con la pila y necesidades del proyecto.
4. Mantener las habilidades actualizadas
reseed sync
Ejecuta esto cuando el usuario quiera obtener las últimas versiones de sus habilidades en el proyecto.
Instalación de habilidades desde GitHub
install y add hacen cosas diferentes:
reseed installdescarga desde GitHub a la biblioteca del usuario. Toma una referenciausuario/repo[/ruta][@version], no una URL.reseed addcopia desde la biblioteca al proyecto. Toma nombres de habilidades o paquetes locales.
reseed install user/repo # todas las habilidades del repositorio
reseed install user/repo/ruta/a/habilidades # habilidades bajo un directorio específico
reseed install user/[email protected] # fijar a una etiqueta de versión
reseed install user/repo --pack mipaquete # agruparlas en un paquete
Después de instalar, usa reseed add para llevarlas al proyecto.
La API pública de GitHub permite solo unas ~60 solicitudes no autenticadas por hora, por lo que ejecutar varias instalaciones en sucesión rápida puede alcanzar el límite de velocidad. Si reseed install falla con un error de límite de velocidad, sugiere configurar GITHUB_TOKEN en el entorno para autenticarse.
Cuando reseed no está instalado
Si reseed no se encuentra, dirige al usuario al comando de instalación:
curl -fsSL https://raw.githubusercontent.com/nattergabriel/reseed/main/install.sh | sh
En Windows, pueden descargar el binario desde la última versión.
Cuando aún no hay biblioteca
Si reseed está instalado pero los comandos fallan con "library not initialized", el usuario necesita crear una biblioteca una vez:
reseed init ~/skills # o cualquier ruta que prefieran
Después de eso, los comandos CLI comienzan a funcionar con la nueva biblioteca.