🧠 Estándares de Codificación con IA y Habilidades del Agente
Aprende principios de ingeniería. Aplícalos en contexto. Verifica el resultado.
Una colección pública de habilidades reutilizables y conscientes del proyecto para agentes de codificación de IA y desarrolladores.
Estas habilidades ayudan a la IA a entender las convenciones existentes del proyecto, tomar mejores decisiones de ingeniería, aplicar prácticas de codificación apropiadas y verificar cambios sin introducir complejidad innecesaria.
📑 Catálogo de Habilidades
🛡️ Gobernanza y Disciplina
| Habilidad | Descripción | Mejor para |
|---|---|---|
cite-or-stop | Refuerza afirmaciones basadas en evidencia, previene intentos fallidos repetidos y proporciona traspasos estructurados cuando se está bloqueado. | Evitar alucinaciones, suposiciones sin fundamento y bucles de reintento. |
🔄 Meta-aprendizaje y Auto-reparación
| Habilidad | Descripción | Mejor para |
|---|---|---|
lesson-to-skill | Convierte errores confirmados, correcciones de usuario y problemas recurrentes en instrucciones reutilizables para ayudar a prevenir los mismos errores en tareas futuras. | Aprendizaje continuo, prevención de errores y mejora del comportamiento del agente de IA. |
🏗️ Estándares de Codificación y Mejores Prácticas
| Habilidad | Descripción | Mejor para |
|---|---|---|
solid-principles | Ayuda a los desarrolladores a aprender y aplicar los principios SOLID. Analiza el código existente y sugiere mejoras de diseño sin introducir abstracciones innecesarias. | Código limpio, mantenible y extensible. |
precision-and-rounding | Analiza los tipos numéricos existentes, reglas de redondeo, cálculos y configuraciones antes de sugerir cambios. Preserva el comportamiento establecido del proyecto a menos que se indique explícitamente lo contrario. | Prevenir pérdida de precisión, redondeo incorrecto e inconsistencias en cálculos. |
database-query-patterns | Analiza consultas de base de datos, patrones ORM, esquemas e índices antes de recomendar mejoras. Ayuda a identificar consultas ineficientes mientras preserva el comportamiento existente de los datos. | Optimización de consultas, rendimiento de base de datos y corrección de datos. |
Aprende → Aplica → Verifica: Comprende el principio, aplícalo según las convenciones existentes del proyecto y verifica el resultado.
🚀 Configuración y Uso Rápido
⚡ Instalación Rápida (Recomendada)
Instala habilidades de IA directamente desde GitHub:
npx skills add geek-prateek/ai-coding-standards
Instala una habilidad específica:
npx skills add geek-prateek/ai-coding-standards --skill precision-and-rounding
Instala de forma global entre proyectos:
npx skills add geek-prateek/ai-coding-standards -g
Explora las habilidades disponibles:
npx skills add geek-prateek/ai-coding-standards --list
Descubre más habilidades en skills.sh.
Opción 1: Configuración Global (Funciona en Todos los Proyectos)
Instala una vez para que estas habilidades estén disponibles en todos los proyectos.
Google Antigravity
# Windows (PowerShell)
cd $HOME\.gemini\config\skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
# macOS / Linux
cd ~/.gemini/config/skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
Claude Code
cd ~/.claude/skills
git clone https://github.com/geek-prateek/ai-coding-standards.git .
Nota: Las rutas de descubrimiento de habilidades pueden variar según el agente y la versión. El CLI de Skills es el método de instalación recomendado para agentes compatibles.
Opción 2: Configuración por Proyecto
Para usar habilidades en un proyecto específico, copia las carpetas de habilidades requeridas en el directorio de habilidades compatible con tu agente.
Ejemplo:
mi-proyecto/
├── .agents/
│ └── skills/
│ ├── cite-or-stop/
│ │ └── SKILL.md
│ ├── lesson-to-skill/
│ │ └── SKILL.md
│ ├── solid-principles/
│ │ └── SKILL.md
│ ├── precision-and-rounding/
│ │ └── SKILL.md
│ └── database-query-patterns/
│ └── SKILL.md
└── src/
O mediante submódulo de Git
git submodule add https://github.com/geek-prateek/ai-coding-standards.git .agents/skills/shared
Asegúrate de que tu agente de codificación pueda descubrir las carpetas de habilidades anidadas.
📂 Estructura del Repositorio
ai-coding-standards/
├── README.md
├── cite-or-stop/
│ └── SKILL.md
├── lesson-to-skill/
│ └── SKILL.md
├── solid-principles/
│ └── SKILL.md
├── precision-and-rounding/
│ └── SKILL.md
└── database-query-patterns/
└── SKILL.md
Cada habilidad puede contener también referencias de apoyo, ejemplos y casos de evaluación.
➕ Cómo Agregar una Nueva Habilidad
Para mantener el repositorio limpio y escalable:
- Crea un directorio:
<nombre-de-la-habilidad>/ - Agrega
SKILL.md: Incluye frontmatter YAML válido. - Define cuándo usarlo: Describe el problema específico y los criterios de activación.
- Sigue las convenciones existentes del proyecto: Evita forzar patrones o cambiar el comportamiento establecido sin justificación.
- Mantenlo genérico: No incluyas código propietario, credenciales, URLs internas o información específica de la empresa.
- Agrega evaluaciones donde sea útil: Incluye escenarios prácticos para verificar la efectividad de la habilidad.
- Actualiza el catálogo: Agrega la nueva habilidad al Catálogo de Habilidades.
Ejemplo de SKILL.md:
---
name: nombre-de-la-habilidad
description: >-
Describe qué hace la habilidad y cuándo usarla.
---
Título de la Habilidad
Aprender
Explica el concepto con ejemplos prácticos.
Aplicar
Analiza las convenciones existentes del proyecto antes de sugerir cambios.
Verificar
Valida la corrección, compatibilidad y casos límite.
Importante: No crees una habilidad solo porque existe un concepto de programación. Crea una cuando un problema recurrente se beneficie de un flujo de trabajo específico y reutilizable.
🤝 Contribuciones
¡Las contribuciones, sugerencias y mejoras son bienvenidas!
Siéntete libre de abrir un issue o enviar un pull request para mejorar las habilidades existentes o proponer nuevas.
📄 Licencia
Consulta el archivo LICENSE del repositorio para obtener información sobre la licencia.