Communitygithub.com

josepdecid/subtitle-flashcards

Crear commits git siguiendo la especificación de Commits Convencionales, con opción de subirlos después. Úsalo cuando el usuario pida hacer un commit o ejecute /commit.

¿Qué es subtitle-flashcards?

Este skill automatiza la creación de commits git conforme a la especificación de Commits Convencionales (Conventional Commits). Es útil para mantener un historial de commits limpio, legible y semánticamente estructurado, facilitando la generación automática de changelogs o el versionado semántico. Funciona en cualquier repositorio git donde esté instalado el skill, compatible con agentes como Claude Code, Cursor o Codex. El skill inspecciona el estado del repositorio, prepara los cambios relevantes (evitando archivos sensibles como .env), genera un mensaje de commit con formato estandarizado (tipo, ámbito, descripción, cuerpo opcional y marcas de cambios rupturistas), ejecuta el commit, verifica que haya sido exitoso y, opcionalmente, sube los cambios al remoto si el usuario lo solicita con la bandera --push. No permite reescribir el historial ni omitir hooks, y maneja fallos de hooks con un nuevo commit.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/josepdecid/subtitle-flashcards/tree/HEAD/.agents/skills/conventional-commit

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Flujo de trabajo

  1. Inspecciona el estado del repositorio: git status --short, git diff --cached y git diff. También revisa git log --oneline -10 para mantener el estilo existente.
  2. Si no hay nada preparado (staged), prepara los cambios relevantes por ruta explícita (evita git add -A si hay archivos no relacionados o sensibles). Nunca prepares .env, secretos o .venv.
  3. Si los cambios contienen preocupaciones claramente no relacionadas, divídelos en commits separados.
  4. Escribe el mensaje siguiendo el formato a continuación, luego haz el commit con git commit.
  5. Ejecuta git status para verificar que el commit se realizó correctamente.
  6. Solo sube (push) si el usuario pasó --push: ejecuta git push (usa git push -u origin <rama> si no hay upstream configurado). Nunca hagas force-push.

Formato del mensaje

<tipo>(<ámbito opcional>): <descripción>

<cuerpo opcional>

<pie opcional>
  • Tipos: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
  • Descripción: modo imperativo, minúscula, sin punto final, máximo ~72 caracteres.
  • Ámbito: sustantivo corto para el área afectada (ej. cli, servidor, traducir); omítelo si no está claro.
  • Cuerpo: explica el porqué, con saltos de línea cada ~72 caracteres; omítelo para cambios triviales.
  • Cambios rupturistas: añade ! después del tipo/ámbito y un pie BREAKING CHANGE:.

Reglas

  • No modifiques (amend), rebases ni reescribas el historial a menos que se te pida.
  • No omitas hooks (--no-verify).
  • Si un hook falla, corrige el problema y crea un nuevo commit.
  • No hagas commit cuando no haya cambios; en su lugar, indícalo.

Skills relacionados