Skills · Claude Code · Agent Skills

El historial es permanente: el gate corre antes del push — sin negociación.

Trunk-based, Conventional Commits, PR pequeño, commits firmados y un secreto commiteado tratado como público. El error se corrige hacia adelante, nunca reescribiendo lo ya publicado.

v0.2.1Disciplina · Fluxo gitgithub.com/schematizeme/skill-git

Mantenido por Lucas Andrade

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

Pisos no negociables

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

GitHub es la fuente de la verdad

Commit y push al instante; la copia local nunca diverge de lo publicado.

Trunk-based y Conventional Commits

Main siempre en verde, ramas cortas, historial lineal y commits atómicos según Conventional Commits 1.0.0.

PR pequeño

Revisable en unos 15 minutos, con una descripción que responde qué, cómo se probó, riesgo/rollback y dónde mirar.

Nunca reescribir lo publicado

Sin force push en main, release ni tags; un error publicado se corrige con git revert. La única excepción es quitar un secreto o dato personal.

Secreto commiteado: rotar primero

Reescribir el historial no deshace la fuga; nunca --no-verify, con secret scanning y pre-commit activos.

Main protegida en el servidor

Ruleset con force push bloqueado, historial lineal, PR, status check del gate y revisión de code owner; una regla solo en el cliente no cuenta.

Firma y tags inmutables

Commits de main y tags de release firmados cuando la política está adoptada; una tag SemVer anotada nunca se mueve.

Comandos

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

/git-ccContext compact: escribe contexto + checklist en el archivo y ejecuta /compact.
/git-claudeCrea o fusiona el CLAUDE.md siempre activo de git en la raíz (no sobrescribe bloques de otras skills).
/git-commitArma commits atómicos en Conventional Commits, pasa el gate del índice y publica al instante.
/git-handoffEscribe el handoff de contexto sin compactar — fin de sesión o cambio de tarea.
/git-helpLista todos los comandos.
/git-leakRito de secreto commiteado: rotar primero, medir, limpiar el código y solo después decidir sobre el historial.
/git-loadCarga a la fuerza todo el cuerpo normativo: flujo, firma, protección, secretos e higiene.
/git-prAbre un PR pequeño con rebase, gate en verde y la descripción de las 4 preguntas.
/git-releaseCalcula el SemVer a partir de los commits, escribe el CHANGELOG y crea la tag anotada (firmada si la política lo exige).
/git-reviewEjecuta el gate sobre el rango y lee lo que la máquina no lee: atomicidad, tamaño del PR, ruleset y divergencia local.

Para agentes de IA

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

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