Agentes IA y Skills
Enseña a tu programador IA la arquitectura de Boltdocs, enrutamiento, componentes y convenciones de estilos para que te dé mejores y más relevantes sugerencias.
Cada asistente IA es tan inteligente como el contexto que le des. Ya sea que uses Cursor, Claude Code, GitHub Copilot o Gemini Code Assist, nuestra skill estructurada le enseña a tu herramienta cómo funciona Boltdocs internamente — para que deje de adivinar y empiece a generar código que encaje con tu proyecto.
La skill es un conjunto de archivos markdown que actúan como una base de conocimiento localizada. Las herramientas IA los leen para aprender sobre boltdocs.config.ts, enrutamiento por sistema de archivos, componentes MDX incorporados y el sistema de estilos Tailwind CSS v4.
Instalación
Incluimos un script de instalación automatizado install-ai-agents.sh en la raíz del proyecto. Copia los archivos de skill a la carpeta que tu entorno de IA espera.
Instalación Rápida (Independiente)
Si estás agregando la skill a un proyecto Boltdocs existente sin clonar el repositorio del framework:
curl -fsSL https://raw.githubusercontent.com/bolt-docs/boltdocs/main/install-ai-agents.sh | bash
El script detecta si existen archivos de skill locales. Si no existen, los descarga de GitHub automáticamente.
Instalación desde un Repositorio Clonado
Si tienes el repositorio de Boltdocs clonado, ejecuta el script directamente — usa los archivos locales para que la skill siempre coincida con tu checkout:
./install-ai-agents.sh
Ejecuta el instalador desde el directorio raíz de tu proyecto, no desde el directorio del framework Boltdocs. La bandera --output-dir te permite apuntar a cualquier ubicación.
Referencia del Script
El instalador soporta estas banderas para flujos automatizados o de CI:
| Bandera | Valor | Descripción |
|---|---|---|
-t, --target | cursor, claude, copilot, agents, all | Qué editor o entorno de IA configurar. |
-o, --output-dir | <path> | Directorio de instalación personalizado (sobreescribe las rutas por defecto). |
-y, --yes | — | Modo no interactivo — salta los prompts y confirma automáticamente. |
-h, --help | — | Imprime información de uso y sale. |
Directorios de Destino por Defecto
| Destino | Ruta de Instalación |
|---|---|
cursor | .cursor/skills/boltdocs/ |
claude | .claude/skills/boltdocs/ |
copilot | .copilot/skills/boltdocs/ |
agents (Gemini) | .agents/skills/boltdocs/ |
Ejemplo: Instalar para Claude en CI
./install-ai-agents.sh --target claude --yes
¿Qué Sigue?
Sistema de Plugins
Extiende tu proyecto escribiendo plugins personalizados de Remark, Rehype y Vite.
Solución de Problemas
Resuelve desajustes de configuración comunes o advertencias de bundle SSG.
