Un proyecto abierto para Claude Code y Codex
Claude-Codex Skills
Una biblioteca de habilidades donde convierto la experiencia práctica con agentes de IA en instrucciones reutilizables, desde la definición de la tarea hasta la verificación del resultado.
Por qué creé este proyecto
Un agente de IA puede producir mucho código rápidamente, pero la velocidad por sí sola no garantiza el resultado adecuado. En mi trabajo tenía que volver una y otra vez al objetivo, a los límites del cambio y a las pruebas de que la solución realmente funcionaba.
Empecé a convertir esos requisitos recurrentes en habilidades independientes. Cada una define un resultado concreto, una forma de trabajar y criterios de finalización, sin exigir un orquestador ni un flujo universal.
Cómo utilizo las habilidades
Elijo una habilidad para la tarea actual y la utilizo para definir cómo debe trabajar el agente y cuándo se considera terminada la tarea. El repositorio me ayuda a mantener la misma disciplina de ingeniería en distintos proyectos y etapas de entrega.
Antes del desarrollo
Analizo la oportunidad, los requisitos, las restricciones de arquitectura y el plan antes de que los cambios resulten costosos.
Durante la implementación
Respeto el alcance acordado, identifico la causa del problema y dónde corregirla en el código, y exijo pruebas del comportamiento afectado.
Al revisar el resultado
Separo los hechos confirmados de las suposiciones. Indico qué comprobaciones han detectado errores, cuáles están pendientes y qué riesgos quedan.
En la entrega y la operación
Distingo entre la preparación del código, su publicación y el estado observado del sistema en funcionamiento.
Mi aportación
Diseñé la estructura de la biblioteca, escribí y sigo mejorando las instrucciones, definí los límites de responsabilidad de las habilidades y establecí un enfoque común para obtener resultados verificables.
También preparé los plugins para Claude Code y Codex, las comprobaciones de integridad del catálogo y los escenarios de validación del comportamiento. El repositorio es abierto para que las habilidades se puedan estudiar, adaptar y utilizar de forma independiente.
Lo que he aprendido al utilizarlo
Una tarea concreta funciona mejor
Una habilidad con un resultado claro es más fácil de aplicar y evaluar que un proceso obligatorio de gran tamaño.
El contexto importa más que el volumen
Una habilidad resulta útil cuando el agente estudia primero el código real, las restricciones y las decisiones existentes.
La verificación debe ser visible
Una lista de acciones no es una prueba. Un resultado útil muestra qué se ha verificado y qué sigue siendo desconocido.
La responsabilidad sigue siendo del ingeniero
Las habilidades ayudan a dirigir al agente, pero elegir la solución y decidir si es suficiente sigue requiriendo criterio profesional.
Ejemplo: corregir el idioma de navegación
Un ejemplo didáctico de una tarea acotada, no una medición de rendimiento. Supongamos que un enlace desde una página en español abre la versión inglesa.
Usa ln-41-surgical-change-implementer. Haz que la navegación interna conserve el idioma de la URL. Comprueba los enlaces directos, la recarga y los botones Atrás y Adelante. Conserva los eventos de analítica. No publiques los cambios.
Revisa los cambios y las comprobaciones: el destino, el idioma mostrado y la URL canónica deben coincidir. Abre el enlace sin JavaScript, recarga la página y vuelve atrás. Una compilación correcta por sí sola no demuestra que estos escenarios funcionen.
Leer las instrucciones de la habilidadUso de las habilidades
¿Claude-Codex Skills funciona con Claude Code y Codex?
El repositorio ofrece plugins para ambas herramientas. Sigue las instrucciones de instalación actuales para tu entorno: las habilidades orientan al agente, pero no sustituyen sus herramientas ni sus permisos.
¿Hay que ejecutar toda la colección?
No. Elige una habilidad según el resultado que necesitas. Para una corrección acotada, Surgical Change Implementer cubre la implementación y sus comprobaciones necesarias; una revisión independiente es útil cuando hace falta evidencia adicional.
¿Qué no garantiza una habilidad?
Una habilidad no garantiza código correcto, acceso al entorno de pruebas ni un despliegue satisfactorio. Antes de aceptar el resultado, revisa la evidencia y las comprobaciones pendientes para tu proyecto.
La documentación vive junto al código
El catálogo actual, la finalidad de cada habilidad y las instrucciones de instalación se mantienen en el README del repositorio.