dobby-skills

Colección pública de Agent Skills para Claude Code

Conocimiento reutilizable, empaquetado como SKILL.md y listo para instalar como plugin.

Cómo funciona · Instalar · Catálogo · Crear una skill · Validar

---

Aquí viven las skills que uso y decido publicar: conocimiento reutilizable, sin datos personales ni información confidencial. El repositorio entero es un plugin de Claude Code instalable, no solo una carpeta de documentos.

Note

Una Agent Skill es una carpeta con un SKILL.md: metadata ligera (name + description) más un cuerpo de instrucciones. Claude Code carga el nombre y la descripción de cada skill siempre, pero solo lee el cuerpo cuando la description coincide con lo que pides. Es la forma que tiene Claude de aprender un procedimiento reutilizable sin que ocupe contexto hasta que hace falta.

Cómo funciona

• Autodescubrimiento. Claude Code escanea skills/ y activa cualquier subcarpeta que contenga un SKILL.md. No hay que registrar nada en un índice.
• Carga progresiva. El frontmatter (name + description) está siempre en contexto; el cuerpo de SKILL.md solo se carga cuando la skill se dispara. Esto hace viable tener muchas skills sin saturar el contexto.
• Recursos bajo demanda. Los archivos de scripts/, references/ y assets/ solo se leen si el propio SKILL.md los referencia. Lo largo o de consulta ocasional vive fuera del cuerpo.
• Plugin instalable. El repo trae .claude-plugin/plugin.json en la raíz, así que se instala como un plugin de Claude Code de una sola pieza.
• Validado en CI. Cada push y PR pasa por validate-skills.sh, que comprueba el formato antes de que nada llegue a main.

Instalar

El repo es un plugin de Claude Code. Para probarlo en local, apunta Claude Code a la carpeta:

git clone https://github.com/dobbygl/skills.git
claude --plugin-dir ./skills

Para añadirlo como fuente de tu propio marketplace, sigue la documentación de plugins de Claude Code.

Catálogo

Skill	Qué hace	Recursos
dobby-gamedev	Aplica el estándar dobby de desarrollo de videojuegos web: crear un juego de cero, adaptar uno existente al estándar o auditar su cumplimiento. Cubre arquitectura (núcleo de simulación headless, timestep fijo), puertas de calidad, presupuestos de assets, licencias, documentación y publicación en GitHub Pages.	references/
imagegen	Genera y edita imágenes bitmap con IA —fotos, mockups, logos, sprites, texturas, cutouts con fondo transparente— vía la API de imágenes de OpenAI (gpt-image-2 por defecto). Requiere OPENAI_API_KEY.	scripts/, references/
example-skill	Skill de ejemplo del scaffold inicial (notas de reunión → acta). Muestra el formato mínimo; sustitúyela por skills reales.	—

Anatomía de una skill

Cada skill es una carpeta en skills/, en kebab-case, cuyo nombre coincide con el campo name del frontmatter:

skills/<nombre-en-kebab-case>/
├── SKILL.md          # obligatorio: frontmatter (name + description) + cuerpo
├── scripts/          # opcional: código ejecutable determinista
├── references/       # opcional: documentación que se carga bajo demanda
└── assets/           # opcional: plantillas o ficheros usados en el output

Parte	Cuándo usarla
SKILL.md	Siempre. name y description son los únicos campos obligatorios del frontmatter. La description es lo único que decide si la skill se activa.
scripts/	Código que se escribiría igual cada vez o que necesita fiabilidad determinista.
references/	Documentación que Claude solo carga al usar la skill (esquemas, políticas, guías largas). Mantiene corto el SKILL.md.
assets/	Plantillas, imágenes o ficheros que van al output final, no al contexto.

Tip

Todo el contenido dentro de skills/<nombre>/ se escribe en inglés (es contenido público consumido por Claude Code y por terceros). La documentación del propio repo —este README.md, CONTRIBUTING.md, CLAUDE.md— se mantiene en español.

Crear una skill nueva

1. Copia templates/skill-template/ a skills/<nombre-en-kebab-case>/.
2. Ajusta el name (que debe coincidir con el nombre de la carpeta) y escribe una description en tercera persona, con frases disparadoras concretas entre comillas —lo que dirías para activarla—.
3. Escribe el cuerpo en forma imperativa; crea scripts/, references/ o assets/ solo si de verdad hacen falta.
4. Añade la skill al catálogo.

La guía completa, con las convenciones de formato y de idioma, está en CONTRIBUTING.md.

Validar

Antes de publicar, corre el mismo check que ejecuta CI:

./scripts/validate-skills.sh

Comprueba que cada SKILL.md tiene name y description, que name es kebab-case y coincide con la carpeta, que toda ruta a scripts/, references/ o assets/ mencionada en el cuerpo existe, y que el contenido de la skill no arrastra ortografía en español fuera de los bloques de código.

Recursos

• Agent Skills — documentación
• Plugins de Claude Code
• CLAUDE.md — arquitectura y reglas de formato del repo
• CONTRIBUTING.md — cómo añadir una skill