Skills de Agentes de IA
Dale a Claude Code, Cursor, Codex y otros asistentes de codificación con IA un conocimiento profundo y estructurado de bx-sites - instala el paquete oficial de skills mediante npx, la CLI de ColdBox, o el propio verbo skills:install de bxSites.
En esta página
Skills de Agentes de IA
Un Agent Skill es un archivo
SKILL.md pequeño y autocontenido que enseña a un asistente de codificación
con IA a hacer bien una cosa concreta - el asistente lo carga
automáticamente, cuando lo necesita, siempre que una tarea coincida con lo
que describe el skill. En lugar de volver a explicarle a tu asistente las
propias convenciones de bx-sites en cada conversación (cómo funcionan los
bloques ::: card :::, qué espera la clave redirects de bxsites.yaml,
en qué se diferencia page:new de un archivo escrito a mano), un skill le
entrega ese conocimiento de antemano, escrito tal como funciona bx-sites
mismo.
ortus-boxlang/bx-sites-skills
es el paquete oficial de skills para este proyecto - trece skills que
cubren desde el andamiaje de un proyecto nuevo hasta la resolución de
problemas de los propios GitHub Actions de este repositorio. Funcionan con
cualquier asistente que admita el formato Agent Skills (Claude Code,
Cursor, Codex y otros).
Instalación
Tres formas de instalar el paquete - elige la que mejor se adapte a tu flujo de trabajo:
npx skills add
La CLI skills funciona con
cualquier proyecto, independientemente del lenguaje o entorno de
ejecución, y no necesita nada más que Node.js:
npx skills add ortus-boxlang/bx-sites-skills
npx -y skills add ortus-boxlang/bx-sites-skills -y
Instala un solo skill en lugar de todo el conjunto apuntando directamente a él:
npx skills add ortus-boxlang/bx-sites-skills/skills/bx-sites-deployment
coldbox ai skills install
Si ya tienes la CLI de ColdBox, puede instalar directamente desde la misma fuente de GitHub - consulta el BoxLang Skills Directory:
coldbox ai skills install ortus-boxlang/bx-sites-skills/bx-sites-deployment
bxSites skills:install
bx-sites también trae su propio verbo de un solo paso - un envoltorio
delgado sobre npx skills add que instala todo el paquete directamente en
el proyecto actual, para que el asistente de IA de un proyecto recién
andamiado conozca bx-sites desde el primer prompt:
bxSites skills install
# o, equivalentemente:
bxSites skills:install
bxSites skills:install --skill=bx-sites-deployment
Requiere Node.js/npx en el PATH (el mismo requisito que tiene por su
cuenta npx skills add) - consulta la
Referencia de la CLI para la
referencia completa de flags.
Skills disponibles
Cada skill es un único SKILL.md autocontenido (sin archivos de recursos
adjuntos), por lo que se instala correctamente por cualquiera de las vías
anteriores:
| Skill | Descripción |
|---|---|
bx-sites-getting-started | Instalar bx-sites, andamiar un proyecto nuevo (o migrar uno existente de GitBook/mkdocs/Notion), estructura del proyecto, frontmatter de página, enlaces, build/serve/clean. |
bx-sites-content-blocks | Bloques de contenido ::: name ::: completos - tarjetas, columnas, stepper, botones, incrustaciones, tarjetas de enlace a página/vista previa, prompt, updates, includes, contenido condicional, widget de OpenAPI. |
bx-sites-markdown | Admoniciones, notas al pie, listas de definición, pestañas de contenido, anotaciones de bloques de código, Mermaid, matemáticas, tablas, iconos, imágenes responsivas, interactividad con Alpine.js. |
bx-sites-variables-functions | {{ variables }} reutilizables y funciones mágicas de BoxLang (docs/functions.bxs), incluidas recetas de visualizadores de insignias de estado/valoraciones/barras de progreso. |
bx-sites-blog-versioning-i18n | El blog (docs/blog/posts/), la documentación versionada (docs/versions/), los locales traducidos (docs/i18n/) y las redirecciones. |
bx-sites-content-quality | Comprobaciones de contenido previas al build sin necesidad de un build completo - lint, blog:drafts, blog:find, search:query. |
bx-sites-build | build/serve/clean/search-index, más diagnósticos doctor/stats/check sobre un sitio ya construido. |
bx-sites-configuration | La referencia completa de claves de bxsites.yaml/bxsites.json - baseURL, nav, redirects, markdown, assets y más. |
bx-sites-themes | Elegir, personalizar, sobrescribir, instalar o escribir un tema; el contrato ThemeProvider. |
bx-sites-search | Proveedores de búsqueda - local (MiniSearch), Algolia DocSearch, Pagefind, y cómo conectar un proveedor personalizado. |
bx-sites-plugins | Escribir/instalar un plugin de bx-sites (hooks del ciclo de vida del build) o un proveedor de CLI (nuevos verbos de bxSites). |
bx-sites-deployment | Destinos de despliegue (S3/Azure/GCS/Firebase/FTP/SFTP/rsync/Netlify/Vercel/Cloudflare Pages/GitHub Pages), package, y el flujo de publicación de GitHub Actions. |
bx-sites-actions | Operar y resolver problemas de los propios flujos de GitHub Actions de bx-sites (tests, snapshot, release, docs, pages). |
Prompts de ejemplo
Una vez instalado, basta con describir lo que quieres - tu asistente elige el skill adecuado por su cuenta:
Scaffold a new bx-sites project called "acme-docs" using the gitbook
theme, add a Getting Started page, and start the dev server.
Add a three-step ::: stepper ::: block to docs/getting-started.md walking
through install, scaffold, and build - and a ::: cards ::: grid linking
to the three main guides.
Add a Netlify deploy target to bxsites.yaml and explain which
environment variable it expects for the auth token.
Preguntas frecuentes
Un breve bloque de frontmatter YAML (name, description - el
disparador con el que compara un asistente) seguido de instrucciones,
convenciones y ejemplos en Markdown simple para ese único tema. Sin
scripts ni archivos de recursos adjuntos - cada skill de este paquete
es un único archivo, por diseño, para que se instale de la misma forma
con npx skills add, coldbox ai skills install y
bxSites skills:install.
No - todas las vías de instalación admiten instalar un solo skill por nombre (ver Instalación más arriba). Aun así, la mayoría de proyectos están bien instalando el paquete completo: un asistente solo carga el contenido de un skill cuando una tarea realmente coincide con él, así que los skills sin usar no cuestan nada en tiempo de prompt.
Con cualquier asistente que admita el formato Agent Skills - Claude
Code, Cursor, Codex y otros. npx skills add/coldbox ai skills install detectan qué asistente(s) tiene ya configurados tu proyecto e
instalan en cada uno automáticamente.
Comprueba si hay un nuevo SKILL.md en el propio directorio de skills
de tu asistente (p. ej. .claude/skills/bx-sites-getting-started/SKILL.md
para Claude Code) - o simplemente pregúntale a tu asistente algo que
cubra el skill (p. ej. "¿cómo añado un destino de despliegue de
Netlify?") y comprueba si su respuesta coincide con esta documentación.
Por debajo, ejecuta el npx skills add real, así que necesita Node.js
en el PATH igual que ese comando por su cuenta - instala Node.js
desde nodejs.org e inténtalo de nuevo. O
sáltate por completo el propio envoltorio de bxSites y ejecuta
directamente npx skills add ortus-boxlang/bx-sites-skills.
Sí - npx skills add/coldbox ai skills install funcionan en
cualquier directorio. bxSites skills:install necesita
específicamente un --projectRoot existente (el directorio actual por
defecto), igual que cualquier otro verbo de bxSites, pero ese
proyecto no necesita estar construido todavía - instalar los skills
antes de haber escrito una sola página es precisamente la idea, para
que tu asistente ya conozca bx-sites desde el primerísimo prompt.
Fuente
- Repositorio de skills: ortus-boxlang/bx-sites-skills
- Repositorio de bx-sites: ortus-boxlang/bx-sites
- BoxLang Skills Directory: skills.boxlang.io