AI Skills Library
jorgedison/ai-skills-library
126 skills de IA reutilizáveis para engenharia empresarial por papel
Ver no GitHubBiblioteca de 126 skills reutilizáveis para engenharia de software, compatível com Claude Code e Codex. Organizada por papéis (arquiteto, desenvolvedor, DBA, QA, DevOps, segurança, redes) e fases do SDLC, com prompts canônicos, contratos SDD e critérios de aceitação para .NET, Vue.js, Azure DevOps e AWS.
Instalação
npx convez-ai jorgedison/ai-skills-library1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar código e reviews automáticos em pull requests
- Modelagem de ameaças e análise de segurança (OWASP, STRIDE)
- Geração de testes, documentação e casos de UAT
- Otimização de queries SQL Server e migrações EF Core
- Automação de pipelines CloudFormation, EKS e Azure DevOps
- Análise de impacto, RCA de incidentes e drift de esquema
Veredito

Excelente repositório de prompts estruturados para times de engenharia. Abordagem por papéis e SDLC é prática; integração com Claude Code é nativa, mas Codex requer wrappers gerados. Recomendado para equipes que buscam padronizar workflows de IA em stack .NET/Azure.
README
A tradução para o português deste README ainda está na fila.
AI Skills Library
Colección de 126 skills reutilizables impulsadas por IA para equipos de ingeniería empresarial. Diseñado para equipos que trabajan con .NET · Vue.js · Azure DevOps · AWS · SQL Server.
La librería puede usarse tanto con Claude Code como con Codex:
- Claude Code: usa las skills canónicas en
.claude/skills/. - Codex: usa wrappers generados en
.agents/skills/, compatibles con el mecanismo de Agent Skills de Codex.
Contenido del repositorio
| Componente | Descripción |
|---|---|
Skills canónicas Claude (.claude/skills/) | 126 skills completas con prompt, contrato SDD y criterios de aceptación |
Skills Codex (.agents/skills/) | 126 wrappers generados para invocación desde Codex |
Generador Codex (scripts/generate_codex_wrappers.py) | Sincroniza .agents/skills/ desde .claude/skills/ |
Guías Agentes IA (guia-*-agentes-ia.md) | Guías homologadas para Claude Code y Codex |
Guías Claude Code (claude-code-guia-*.md) | Referencia específica histórica de Claude Code |
Catálogo visual (skills-catalog.html) | Catálogo HTML de skills — abrir en cualquier navegador |
Skills por rol
| Prefijo | Rol | Skills | Alcance |
|---|---|---|---|
arch- | Arquitecto | 15 | ADRs, contratos API, patrones, cumplimiento, fitness |
ba- | Analista de Negocio | 16 | Documentación de procesos, historias de usuario, PBIs, UAT, reglas de negocio |
dba- | DBA | 20 | SQL Server, RDS, migraciones EF Core, optimización de consultas |
dev- | Desarrollador | 15 | Generación/revisión de código, unit tests, análisis de bugs, documentación técnica |
net- | Analista de Redes | 12 | Conectividad, VLANs, firewall, calidad de red, failover, coordinación con proveedores |
ops- | DevOps | 16 | AWS, CloudFormation, EKS, pipelines Azure DevOps |
qa- | QA | 15 | Casos de prueba, cobertura, guías UAT, métricas de calidad |
sec- | Seguridad | 16 | OWASP, modelado de amenazas, STRIDE, SonarCloud, Snyk |
doc- | Documentación | 1 | Resumen ejecutivo rápido de documentos |
Skills por fase del SDLC
| Fase | Skills típicas utilizadas |
|---|---|
| Pre-Sprint | Análisis de impacto, modelado de amenazas, asesoría de arquitectura, generación de historias |
| Desarrollo | Generación de código, autoría de IaC, optimización de consultas, unit tests |
| Pull Request | Revisión de código, revisión de pipeline, revisión de seguridad, checklist de BD |
| Pre-Deploy | Checklist de despliegue, riesgo de migración, configuración de observabilidad, guía UAT |
| Post-Deploy | Análisis de logs, validación de consistencia, análisis de regresión, drift de esquema |
| Operación | RCA de incidentes, optimización de costos, análisis de slow queries, documentación de procesos |
| Red (transversal) | Validación de conectividad, análisis de calidad, monitoreo, coordinación con ISP, failover |
Uso de skills en Claude Code
Invoca cualquier skill directamente desde el CLI de Claude Code:
/ba-process-documenter @"requerimientos.md"
/sec-threat-modeling-assistant @"especificacion.md"
/dev-code-review @"src/MiServicio.cs"
/qa-test-case-generator @"historia-usuario.md"
/net-connectivity-validator @"diagrama-red.md"
/net-firewall-rule-analyzer @"politica-firewall.txt"
Uso de skills en Codex
Codex descubre las skills desde .agents/skills/. Puedes invocarlas desde /skills o mencionarlas con $:
$ba-process-documenter documenta requerimientos.md
$sec-threat-modeling-assistant usa especificacion.md
$dev-code-review revisa src/MiServicio.cs
$qa-test-case-generator genera casos para historia-usuario.md
$net-connectivity-validator valida diagrama-red.md
Los wrappers Codex delegan en la definición canónica de .claude/skills/<skill>/SKILL.md, por lo que Claude y Codex usan el mismo contrato funcional.
Cada skill acepta tres tipos de entrada:
- Referencia a archivo —
@"ruta/al/archivo.ext" - Texto inline — descripción de PBI, mensaje de error, consulta SQL pegada directamente
- Identificadores — números de PBI, números de caso, nombres de servicio
Skills del Analista de Redes (net-)
| Skill | Propósito |
|---|---|
net-connectivity-validator | Protocolo de validación real de conectividad capa por capa (sin asumir nada) |
net-vlan-segmentation-reviewer | Revisión de VLANs, trunks, tagged ports y riesgos de segmentación |
net-ip-routing-nat-analyzer | Análisis de direccionamiento IP, tablas de ruteo y configuración NAT |
net-firewall-rule-analyzer | Auditoría de reglas de firewall del cliente y del proveedor (GTD) |
net-failover-test-planner | Plan de pruebas de failover de enlaces WAN, routers, switches y energía |
net-quality-metrics-analyzer | Análisis de latencia, jitter, pérdida de paquetes y ancho de banda |
net-physical-infra-checklist | Checklist de UPS, temperatura, rack, energía y seguridad física |
net-cabling-validator | Validación de cableado LAN estructurado contra estándar TIA-568 |
net-demarcation-mapper | Matriz RACI de responsabilidades entre cliente, integrador e ISP |
net-monitoring-advisor | Estrategia de monitoreo propio aunque la red no sea del analista |
net-intermittency-analyzer | Diagnóstico de intermitencias con árbol de causas y recomendaciones de resiliencia |
net-provider-coordination-assistant | Tickets formales, reportes post-incidente y actas para coordinación con ISP y cliente |
Crear o modificar skills
- Crear o modificar
.claude/skills/<nombre-skill>/SKILL.md(fuente canónica). - El campo
namedebe coincidir con el nombre del directorio. - Regenerar la capa Codex:
python3 scripts/generate_codex_wrappers.py
- Validar que los wrappers estén sincronizados:
python3 scripts/generate_codex_wrappers.py --check
Validar que funciona en ambos runtimes
Ejecuta la validación dual:
python3 scripts/validate_dual_runtime.py
Debe reportar:
Dual runtime validation
- Canonical Claude skills: 126
- Codex wrappers: 126
- Status: OK
Esta validación confirma que:
- cada skill canónica existe en
.claude/skills/, - cada wrapper Codex existe en
.agents/skills/, - cada wrapper apunta a su skill canónica,
- los wrappers están sincronizados con el generador.
Plantilla SKILL.md
---
name: nombre-skill
description: Descripción en una línea para descubrimiento de la skill
argument-hint: "<qué pasar como argumento>"
allowed-tools:
- Read
- Bash
- Grep
- Glob
---
[Cuerpo del prompt — formato de salida, metodología, qué hacer con $ARGUMENTS]
Convenciones
- Todas las skills generan salida en español.
- Formato de salida: secciones numeradas, tablas markdown, clasificación de severidad.
- Escala de severidad:
Crítica / Alta / Media / Bajao🔴 / 🟠 / 🟡 / 🔵. - Las skills de seguridad referencian CWE IDs, OWASP Top 10 2021, ISO 27001, NIST CSF.
- Las skills de DBA apuntan a SQL Server / RDS AWS.
- Las skills de DevOps asumen AWS + Azure DevOps Pipelines.
- Las skills de redes (
net-) están orientadas a entornos con proveedor ISP externo (ej. GTD) y cubren tanto la red propia del cliente como la coordinación con terceros.
Documentación de referencia
| Archivo | Propósito |
|---|---|
guia-maestra-agentes-ia.md | Guía maestra homologada para Claude Code y Codex |
guia-empresarial-agentes-ia.md | Guía empresarial homologada por rol, SDLC y gobierno |
SKILL-SPEC-SCHEMA.md | Contrato SDD para frontmatter, input, output y criterios de aceptación |
skills-catalog.html | Catálogo visual HTML de skills (abrir en navegador) |
AGENTS.md | Instrucciones persistentes para Codex al trabajar en este repositorio |
CLAUDE.md | Instrucciones persistentes para Claude Code al trabajar en este repositorio |
claude-code-guia-maestra.md | Referencia específica histórica de Claude Code |
claude-code-guia-empresarial.md | Referencia empresarial histórica de Claude Code |