imielvisser/buildthis_Claude_Skill

¿Qué hace buildthis_Claude_Skill?

Un único archivo de skill que convierte a Claude en un gestor de proyectos completo. Un comando descompone un plan, lanza subagentes paralelos en worktrees de git aislados, ejecuta QA, rastrea costes y entrega un informe HTML con pestañas.

Cómo funciona

1. Descomposición del plan: Ejecuta buildthis seguido de una descripción del proyecto o un enlace a un plan. El skill analiza la solicitud y divide el proyecto en tareas manejables.
2. Subagentes paralelos: Cada tarea se asigna a un subagente independiente que opera dentro de su propio worktree de git aislado. Esto evita conflictos de archivos y permite que los subagentes trabajen simultáneamente.
3. QA automático: Una vez que los subagentes completan una tarea, se ejecuta un conjunto de pruebas de calidad predefinidas (como análisis de código, comprobación de pruebas unitarias, linting). Si una tarea falla el QA, el subagente puede reintentarla.
4. Rastreo de costes: El skill monitoriza el uso de tokens, tiempo de ejecución o cualquier otra métrica de coste relevante para el agente.
5. Informe HTML: Al finalizar, se genera un informe con pestañas que muestra:
   • Resumen del proyecto
   • Estado de cada tarea (completada, en progreso, fallida)
   • Resultados de QA
   • Detalle de costes

Requisitos previos

• Git instalado y configurado.
• Un agente compatible (Claude Code, Cursor, Codex, etc.) con capacidades para ejecutar comandos de shell.
• (Opcional) Acceso a una terminal que permita ejecución de scripts.

Instalación

1. Copia el archivo buildthis.skill.md (o el contenido de este archivo) en el directorio de skills de tu agente.
   • Para Claude Code: ~/.claude/skills/
   • Para Cursor: ~/.cursor/skills/
   • Para Codex: consulta la documentación del agente.
2. Asegúrate de que el agente tenga permisos para ejecutar comandos de shell y acceder a git.
3. (Opcional) Configura variables de entorno:
   • BUILDTHIS_REPORT_DIR: directorio donde se guardará el informe HTML (por defecto: ./buildthis-reports).
   • BUILDTHIS_COST_LIMIT: límite de coste en USD antes de pausar el proyecto (por defecto: ilimitado).

Uso

Ejecuta el siguiente comando en tu agente:

buildthis ["descripción del proyecto" | URL del plan]

Ejemplos

buildthis "Crea una API REST para un blog con Node.js, Express y MongoDB, incluyendo autenticación JWT y pruebas unitarias"

O con un enlace a un plan detallado:

buildthis https://ejemplo.com/mi-plan-de-proyecto.md

Estructura del informe HTML

El informe generado tiene las siguientes pestañas:

• Resumen: visión general del proyecto, tiempo total, coste total, número de tareas.
• Tareas: lista de todas las tareas con su estado (✅ completada, 🔄 en progreso, ❌ fallida).
• QA: resultados detallados de QA por tarea.
• Costes: desglose de costes por tarea y total.

Limitaciones

• El skill requiere que el agente tenga acceso a git y que el proyecto esté en un repositorio git.
• Los subagentes funcionan dentro del mismo entorno del agente principal; no se comunican entre sí directamente.
• El informe HTML se genera al finalizar todas las tareas; no hay actualizaciones en tiempo real.

Soporte

Para reportar problemas o sugerir mejoras, abre un issue en el repositorio: imielvisser/buildthis_Claude_Skill