Skills · Claude Code · Agent Skills

Una skill es un paquete de software: versión, gate y release — sin negociación.

Crea y mantiene skills del catálogo con anatomía completa, description ajustada, la misma versión en 4 lugares, scripts probados con caso rojo y un release solo con gate en verde.

v0.2.0Disciplina · Autoria de skillsgithub.com/schematizeme/skill-skill-dev

Mantenido por Lucas Andrade

schematize-skill-dev · v0.2.0bash
$ schematize install skill-dev
GitHub →descargar skill (.zip)/skill-dev-help · github.com/schematizeme/schematize-cli

Pisos no negociables

No se apagan "para ir más rápido". Lista completa en la skill.

Un repo por skill

Directorio skill-[slug], name schematize-[slug], repo público propio y un prefijo de comandos único en el catálogo.

Anatomía completa

SKILL.md, skill.toml, VERSION, CHANGELOG, README, LICENSE, install.sh, assets, references, scripts y snapshot en versions/; ningún zip dentro del paquete.

Description corta y con frontera

Bloque >- de como máximo 350 caracteres: qué es, un disparador concreto de uso y la frontera con la skill vecina, sin reclamar territorio ajeno.

Misma versión en 4 lugares

VERSION, skill.toml, el frontmatter y la línea Versión del SKILL.md coinciden, el CHANGELOG explica el porqué y skills.json acompaña.

Bloque heredado nunca a mano

La fuente es schematize-engineering; se cambia allí y se ejecuta el sync, nunca se edita el bloque heredado directamente en la skill.

Todo script con prueba roja y verde

El caso rojo se vio fallar antes de pasar: un gate que no sabe reprobar es decoración.

Release solo con gate en verde

Árbol limpio, main sincronizada, git add con lista explícita, tag anotada, zip con top-level schematize-[slug]/ y luego grafo y skills.json regenerados.

Comandos

Instalados en .claude/commands/. Usa /skill-help cuando quieras.

/skill-bumpSube la versión en los 4 lugares, escribe el snapshot y exige la entrada del CHANGELOG.
/skill-ccContext compact: escribe contexto + checklist en el archivo y ejecuta /compact.
/skill-claudeCrea o fusiona el CLAUDE.md siempre activo de skill-dev en la raíz (no sobrescribe bloques de otras skills).
/skill-handoffEscribe el handoff de contexto sin compactar — fin de sesión o cambio de tarea.
/skill-helpLista todos los comandos.
/skill-loadCarga a la fuerza todo el cuerpo normativo: anatomía, description, heredados, lint y pruebas, release y catálogo.
/skill-newHace el scaffold completo de una skill nueva, que ya pasa el gate.
/skill-releaseEl rito de release: gate, bump, snapshot, zip, tag, GitHub Release, grafo y skills.json.
/skill-reviewAudita una skill contra el piso: gate, lint del catálogo y lectura de lo que la máquina no lee.

Para agentes de IA

Instala sin intervención humana. Metadatos en llms.txt.

  • Ejecuta: git clone https://github.com/schematizeme/skill-skill-dev.git && ./skill-skill-dev/install.sh
  • O descarga: https://github.com/schematizeme/skill-skill-dev/releases/latest/download/skill-skill-dev.zip y descomprime en .claude/skills/
  • Copia assets/CLAUDE.md a la raíz del repo (regla siempre activa).
  • Confirma con /skill-help.

¿No quieres instalar?

Lee las normas completas y cópialas directo a tu proyecto — o instala la skill para que el agente las aplique solo.