skills/

Claude Agent Skills: una subcarpeta por SKILL.md, cargada bajo demanda.

skills/

Cada subcarpeta inmediata de skills/ que contiene un archivo SKILL.md es una skill, siguiendo la convención de Claude Agent Skills: frontmatter YAML (name, description) seguido de un cuerpo de instrucciones de formato libre.

skills/
└── greeting/
    └── SKILL.md

---
name: greeting
description: How to greet people warmly.
---

Always greet the user warmly and use their name if known.

Nombramiento

El nombre de la skill es su name: de frontmatter si está presente; de lo contrario recae en el nombre de la carpeta (greeting/ sin nombre de frontmatter de todos modos se descubriría como greeting, pero un name: explícito siempre gana incluso si difiere de la carpeta). Dos skills que resuelven al mismo nombre fallan la validación con un error de nombre duplicado.

Una carpeta sin un SKILL.md dentro no se descubre como una skill en absoluto - simplemente se ignora (útil para subcarpetas de borrador, activos guardados junto a una skill bajo una estructura diferente, etc., siempre que no se sitúen directamente bajo skills/ sin un SKILL.md propio).

Cómo se conecta en tiempo de ejecución

skills/ se copia textualmente a la app generada (la misma copia de borrar-y-escribir, excluyendo dotfiles, que tools/). El config/ColdBox.bx generado siempre apunta el propio ajuste de módulo skillsDirectory de bx-ai a /skills:

moduleSettings = {
	bxai : { skillsDirectory : "/skills" }
}