bruh2211/universal-agent-skills

Estandariza mensajes de commit semánticos, commits atómicos, higiene de ramas y descripciones limpias de PR siguiendo la especificación de Conventional Commits. Útil al preparar commits, organizar cambios, escribir mensajes de commit o cuando se solicite 'hacer commit', 'escribir mensaje de commit' o '/commit'.

¿Qué es universal-agent-skills?

Esta habilidad para agentes de IA estandariza el flujo de trabajo de Git siguiendo la especificación **Conventional Commits v1.0.0**. Su propósito es garantizar que los mensajes de commit, nombres de ramas y descripciones de pull requests sean consistentes, semánticos y fáciles de entender para equipos de desarrollo y herramientas de automatización. Es compatible con agentes como Claude Code, Cursor y otros asistentes de codificación que acepten instrucciones markdown. La habilidad define reglas claras para commits atómicos (un cambio lógico por commit), el uso del modo imperativo en el asunto, la marcación de cambios disruptivos (`BREAKING CHANGE`) y la referencia a issues. Al aplicar estas reglas, se mejora la legibilidad del historial del repositorio, se facilita la generación automática de changelogs y se optimizan los flujos de trabajo de CI/CD. Su funcionamiento se basa en la validación de mensajes de commit según el formato `<tipo>[ámbito opcional]: <descripción>` y la corrección de desviaciones comunes, como el uso de tiempo pasado o puntos finales en el asunto.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/bruh2211/universal-agent-skills/tree/HEAD/skills/conventional-commits

Documentación

📦 Habilidad de Conventional Commits e Higiene de Git

Eres un especialista en flujos de trabajo de Git e ingeniería de lanzamientos. Al preparar mensajes de commit, nombres de ramas o descripciones de pull requests, aplica estrictamente los estándares Conventional Commits v1.0.0.

📌 Formato del Mensaje de Commit

<tipo>[ámbito opcional]: <descripción>

[cuerpo opcional]

[pie de página opcional]

Tipos

feat: Una nueva funcionalidad para el usuario.
fix: Corrección de un error.
docs: Cambios solo en documentación.
style: Cambios que no afectan el significado del código (espacios en blanco, formato, punto y coma).
refactor: Un cambio en el código que no corrige un error ni añade una funcionalidad.
perf: Un cambio que mejora el rendimiento.
test: Añadir pruebas faltantes o corregir pruebas existentes.
build: Cambios que afectan el sistema de compilación o dependencias externas (npm, cargo, gradle).
ci: Cambios en archivos de configuración y scripts de CI (GitHub Actions, CircleCI).
chore: Tareas de mantenimiento, configuraciones del repositorio, actualizaciones de herramientas.

📐 Reglas para Commits Limpios

Modo Imperativo: Usa el modo imperativo en presente en la línea de asunto (p. ej., "añadir validación de token de autenticación", NO "añadió validación de token de autenticación" ni "añade validación de token de autenticación").
Sin Punto Final: No termines la línea de asunto con un punto.
Commits Atómicos: Cada commit debe representar un cambio lógico y autónomo. Nunca mezcles refactorizaciones no relacionadas con correcciones de errores.

Cambios Disruptivos: Marca los cambios disruptivos con un ! después del tipo/ámbito e incluye un pie de página BREAKING CHANGE::

feat(api)!: cambiar encabezado de autenticación de X-Auth a token Bearer

BREAKING CHANGE: Los clientes deben actualizar el encabezado de Autorización para usar el esquema Bearer estándar.

Referencias a Issues: Referencia issues de forma limpia en el pie de página: Cierra #142 o Corrige #205.