ai-first-toolkit MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Auditoría de preparación para IA — evalúa un repositorio en estructura, documentación, pruebas, facilidad para agentes
Recetas de rediseño para mejorar la ergonomía AI del código heredado
Habilidad de inicialización para proyectos greenfield con valores predeterminados sensatos
Multiagente: funciona en Claude Code y Codex
Herramientas basadas en TypeScript

Demo en vivo

Cómo se ve en la práctica

ai-first-toolkit-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ai-first-toolkit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "ai-first-toolkit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "ai-first-toolkit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ai-first-toolkit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "ai-first-toolkit-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "ai-first-toolkit-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/techwolf-ai/ai-first-toolkit",
          "~/.claude/skills/ai-first-toolkit"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add ai-first-toolkit-skill -- git clone https://github.com/techwolf-ai/ai-first-toolkit ~/.claude/skills/ai-first-toolkit

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: ai-first-toolkit

Cómo auditar una base de código para la preparación de agentes IA

👤 Líderes técnicos que preparan una base de código para trabajo intensivo asistido por IA ⏱ ~45 min intermediate

Cuándo usarlo: Antes de que el equipo se comprometa a hacer mucho trabajo de características a través de Claude o Codex.

Requisitos previos

Habilidad clonada — git clone https://github.com/techwolf-ai/ai-first-toolkit ~/.claude/skills/ai-first-toolkit

Flujo

Ejecuta la auditoría

Audita este repositorio para la preparación de agentes IA. Califica cada dimensión y lista los 5 principales puntos de fricción.✓ Copiado

→ Puntuaciones de dimensiones + archivos específicos a corregir
Prioriza las correcciones

¿Cuál de esas correcciones daría el mayor aumento de efectividad del agente por hora de trabajo?✓ Copiado

→ Lista clasificada por esfuerzo/impacto
Aplica la corrección principal

Aplica la corrección #1 de extremo a extremo — edita archivos, actualiza documentación, agrega pruebas.✓ Copiado

→ Diff + confirmación

Resultado: Un plan de mejora concreto y al menos una corrección aplicada que haga el repositorio más amigable para agentes IA.

Errores comunes

La auditoría se convierte en un lío genérico de 'mejorar documentación' — Solicita hallazgos a nivel de archivo:línea, no consejos abstractos

Combinar con: filesystem · github

Inicializa un nuevo proyecto amigable para IA

👤 Fundadores o contribuyentes individuales que inician un nuevo repositorio ⏱ ~30 min beginner

Cuándo usarlo: Día cero de un nuevo proyecto, antes de que elijas valores predeterminados malos que te perseguirán.

Flujo

Declara el proyecto

Inicializa un nuevo proyecto TypeScript API usando los valores predeterminados de ai-first-toolkit. Propósito: API de facturación interna.✓ Copiado

→ Estructura de carpetas propuesta, tsconfig, scripts, esqueleto de README
Crea el andamiaje de archivos

Crea los archivos. Incluye AGENTS.md y CLAUDE.md con las notas relevantes de la base de código.✓ Copiado

→ Archivos del repositorio materializados
Primer commit

Inicializa git y haz el primer commit con un mensaje limpio.✓ Copiado

→ Repositorio inicial limpio

Resultado: Un nuevo repositorio que es amigable tanto para humanos como para agentes IA desde el commit 0.

Errores comunes

El andamiaje importa dependencias que no quieres — Pide a Claude que liste las dependencias antes de instalar — acepta cada una

Combinar con: github · filesystem

Rediseña un módulo desordenado para legibilidad de IA

👤 Ingenieros que pagan deuda técnica un módulo a la vez ⏱ ~60 min advanced

Cuándo usarlo: Has aislado un módulo que Claude sigue interpretando mal — generalmente una señal de que su estructura no es legible para agentes.

Flujo

Diagnostica el módulo

Mira src/billing/. ¿Qué hace que sea difícil para un agente editar este código de forma segura?✓ Copiado

→ Señales rojas específicas: indirección, estado oculto, funciones largas
Planifica el refactor

Propón un refactor de 3 pasos que mejore la legibilidad del agente sin cambiar la API pública.✓ Copiado

→ Plan paso a paso con esbozos de diff
Ejecuta el paso 1

Aplica el paso 1. Mantén las pruebas en verde.✓ Copiado

→ Diff de tamaño de PR

Resultado: Un módulo sobre el cual Claude puede razonar realmente en la siguiente iteración.

Errores comunes

Over-refactorizar y romper comportamientos que no intentabas — Insiste en la estabilidad de la API pública y ejecuta pruebas después de cada paso

Combinar con: filesystem · github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

ai-first-toolkit-skill + filesystem

La auditoría escanea el repositorio; se necesita filesystem para realmente leerlo

Recorre el repositorio y califica la preparación para IA; reporta hallazgos archivo por archivo.✓ Copiado

ai-first-toolkit-skill + github

Abre un PR con las adiciones propuestas de AGENTS.md / CLAUDE.md

Aplica las 3 principales correcciones de la auditoría y abre un PR titulado 'Mejoras AI-first'.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
ai-readiness-audit	raíz del repositorio	Antes de la inversión en flujos de trabajo intensivos de IA
ai-first-bootstrap	especificación del proyecto (idioma, propósito, stack)	Proyectos greenfield
re-engineer-module	ruta del módulo + objetivos	Cuando un módulo resiste ediciones de agentes

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: ninguno más allá de tu proveedor de LLM
Tokens por llamada: 5–20k para una auditoría de un repositorio mediano
Monetario: gratuito, código abierto
Consejo: Limita las auditorías a un subárbol en lugar del monorepo completo

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: ninguno

Salida de datos: ninguno más allá de lo que hacen las herramientas filesystem/github

Resolución de problemas

Errores comunes y soluciones

La auditoría es demasiado abstracta

Re-pregunta con una dimensión concreta: 'evalúa solo la estructura de pruebas' o 'solo los límites del módulo'.

Bootstrap elige el idioma equivocado

Siempre declara idioma+runtime+herramienta de compilación en el primer prompt.

Alternativas

ai-first-toolkit vs otros

Alternativa	Cuándo usarla	Contrapartida
init (built-in)	Solo necesitas un CLAUDE.md y no te importa el resto	Alcance más estrecho
antivibe-skill	Quieres la óptica opuesta — crítica de lodo moldeado por IA	Diagnóstico, no prescriptivo

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills