Factura de Habilidades: Un Marco de Gobernanza Basado en Markdown para Habilidades de Codificación con IA

Qué es Skill Bill

Skill Bill es un marco de gobernanza para habilidades de codificación con IA construido completamente en Markdown. Aborda problemas comunes que enfrentan los desarrolladores al gestionar múltiples prompts de IA en diferentes agentes: deriva de nombres, lógica duplicada, código específico de plataforma infiltrándose en habilidades genéricas y falta de una única fuente de verdad.

Cómo comenzó

El desarrollador comenzó con habilidades individuales para tareas específicas: un prompt de revisión de código para trabajo en Android/KMP, una habilidad gradle check con convenciones para corregir problemas en lugar de suprimirlos, una habilidad feature flag y una habilidad para implementar funciones a partir de documentos de diseño. Después de acumular aproximadamente una docena de habilidades dispersas entre agentes, experimentaron la "descomposición familiar" de nombres inconsistentes y lógica específica de Kotlin apareciendo en habilidades supuestamente genéricas.

El avance del orquestador

La innovación clave fue crear feature-implement, una habilidad que llama a otras habilidades en secuencia. Este orquestador toma un documento de diseño, crea un plan, pregunta sobre la estrategia de feature flags, implementa código, ejecuta revisiones y verifica la completitud. Una sola ejecución de feature-implement encadena 10-12 invocaciones de habilidades: un orquestador, un enrutador de revisión de código que detecta la pila tecnológica, 3-5 revisores especialistas ejecutándose en paralelo, una verificación de calidad, descripción de PR y configuración opcional de feature flags.

Consideraciones de costo

El desarrollador usa Claude Code con suscripción Max y inicialmente no consideró los costos de uso. Sin embargo, un amigo que usa suscripción Codex Pro informó que una sola invocación de la habilidad code-review (no la cadena completa) consume el 40-50% del límite de tasa de 5 horas de Pro. Copilot usa un modelo de facturación diferente (por turno de conversación en lugar de por volumen de tokens), haciéndolo más rentable para este enfoque.

Arquitectura técnica

El marco evolucionó para soportar múltiples lenguajes de programación a través de Markdown estructurado que funciona como código:

• Herencia: Habilidades base con anulaciones de plataforma
• Lógica de enrutamiento: Detección de pila tecnológica y delegación a especialistas apropiados
• Contratos de interfaz: Relaciones definidas entre habilidades
• Validación: Aplica reglas de nomenclatura y estructura para prevenir la descomposición del repositorio

Una vez que la capa base se volvió adecuadamente genérica, agregar soporte para PHP fue sencillo, seguido por Go. El marco ahora incluye 44 habilidades en Kotlin, Android/KMP, backend Kotlin, PHP y Go.

Características clave

• Habilidades base que enrutan automáticamente al especialista de plataforma correcto
• Un validador que aplica reglas de nomenclatura y estructura
• Repositorio único que se sincroniza con Claude Code, Copilot, GLM y Codex
• Habilidades de orquestador como feature-implement que encadenan todo de principio a fin
• Actualmente más fuerte para la familia Kotlin y backends Go/PHP, pero diseñado para extenderse a nuevas plataformas

Implicaciones prácticas

El desarrollador descubrió que los repositorios de prompts tienen los mismos problemas de ingeniería que el software regular. Al tratar las habilidades como código—con contratos, validación y componibilidad—todo el sistema se volvió dramáticamente más mantenible. El marco está disponible en GitHub bajo licencia MIT en https://github.com/Sermilion/skill-bill.