Communitygithub.com

nattergabriel/reseed

Una herramienta CLI para gestionar y distribuir habilidades de agentes entre proyectos

¿Qué es reseed?

reseed es un administrador de habilidades para agentes de IA, como Claude Code, Cursor, Copilot y otros. Permite a un desarrollador mantener una biblioteca personal de habilidades (directorios con un archivo `SKILL.md`) y copiarlas fácilmente en diferentes proyectos. Con comandos como `reseed add` se instalan habilidades desde la biblioteca local al proyecto, `reseed sync` actualiza las ya instaladas, y `reseed install` descarga nuevas habilidades desde GitHub. Es compatible con más de 30 agentes y trabaja con directorios estándar como `.agents/skills/` o `.claude/skills/`.

Compatible con✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add nattergabriel/reseed

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 add copia 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 sync vuelve 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, sync no eliminará la copia obsoleta. Usa reseed remove para 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 install descarga desde GitHub a la biblioteca del usuario. Toma una referencia usuario/repo[/ruta][@version], no una URL.
  • reseed add copia 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.

Skills relacionados