CommunityRedacción y edicióngithub.com

noppu-labs/ai-toolkit

Kit de herramientas para desarrollo agéntico de aplicaciones Laravel y React

¿Qué es ai-toolkit?

El toolkit `noppu-labs/ai-toolkit` es un conjunto de habilidades y utilidades diseñado para entornos de desarrollo agéntico, es decir, para asistentes de IA como Claude Code, Cursor o Codex que trabajan sobre proyectos Laravel y React. Su funcionalidad principal es la sincronización de habilidades (skills) alojadas localmente con sus fuentes upstream (repositorios remotos). Esto permite a los desarrolladores mantener actualizadas las habilidades de IA que utiliza su proyecto sin perder las personalizaciones locales. El flujo de trabajo se basa en un script Node.js (`scripts/skills-sync.mjs`) que analiza el estado de cada skill (actualizada, modificada localmente, divergida, etc.) y ofrece comandos para sincronizar de forma segura, realizar fusiones manuales en caso de conflictos y verificar la integridad. Está pensado para equipos que gestionan múltiples habilidades de IA como parte de su código base y necesitan un proceso controlado y reproducible para actualizarlas desde sus repositorios origen.

Compatible con~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add noppu-labs/ai-toolkit

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Sincronizar habilidades empaquetadas con upstream

Requisitos: gh CLI autenticado. Ejecuta todo desde la raíz del repositorio.

Flujo de trabajo

  1. Ejecuta node scripts/skills-sync.mjs status. Estados y qué hacer:

    • up-to-date — no hay nada que hacer.
    • local — habilidad propia, sin upstream; no hay nada que sincronizar.
    • upstream-updated — avance rápido seguro: node scripts/skills-sync.mjs pull <plugin>/<skill>.
    • locally-modified — hemos editado desde la última línea base. Si las ediciones son intencionadas, node scripts/skills-sync.mjs accept <plugin>/<skill>.
    • diverged — ambos lados cambiaron: fusionar manualmente (sección a continuación).
    • fetch-error (...) — upstream inalcanzable o movido; verifica source/skillPath en el archivo skills-lock.json del plugin contra el repositorio upstream.
  2. Después de todos los cambios: node scripts/skills-sync.mjs verify, luego confirma con un mensaje que enumere qué habilidades se extrajeron o fusionaron y de qué commits upstream.

Fusión manual para habilidades divergidas

Nunca sobrescribas a ciegas una habilidad divergida: pull --force descarta nuestras personalizaciones.

  1. node scripts/skills-sync.mjs diff <plugin>/<skill> — diff completo, empaquetado → upstream.
  2. Identifica qué diferencias son NUESTRAS personalizaciones deliberadas (git log -p -- <plugin>/skills/<skill> muestra cómo evolucionó la copia empaquetada) frente a mejoras genuinas del upstream.
  3. Edita los archivos empaquetados para incorporar las mejoras del upstream mientras preservas cada personalización local. Lee ambas versiones por completo antes de editar.
  4. Re-baselinea AMBOS lados: node scripts/skills-sync.mjs seed <plugin>/<skill> (accept solo re-baselinea el hash empaquetado y dejaría la habilidad marcada permanentemente como upstream-actualizada).

Skills relacionados