Principios de escritura de habilidades para Claude Code, basados en 159 habilidades de código abierto.

Un desarrollador ha publicado 10 principios para escribir habilidades efectivas para Claude Code, derivados de la construcción y mantenimiento de un registro de habilidades de código abierto con 159 habilidades. Los principios se centran en patrones de implementación práctica observados a través del uso real de agentes.

Principios clave para escribir habilidades

• No digas lo obvio - Empuja a Claude más allá de sus configuraciones predeterminadas en lugar de reforzarlas
• Sección de advertencias - Considerada el contenido con mayor retorno de inversión en cualquier habilidad
• Las habilidades son carpetas, no archivos - Usa subdirectorios references/, scripts/, assets/
• No encasilles - Proporciona pautas en lugar de secuencias de pasos rígidas
• Configuración inicial mediante config.json - Coloca archivos de configuración directamente en la carpeta de la habilidad
• El campo de descripción es una condición de activación - No solo un resumen
• Dale memoria a las habilidades - Usa registros, JSON o SQLite entre ejecuciones
• Envía scripts junto con la explicación - Ejemplo: fetch_events.py es más valioso que 200 líneas de explicación
• Ganchos bajo demanda - Usa bloques /careful para restringir comandos destructivos solo cuando se invocan
• Las habilidades se componen - Referencia otras habilidades por nombre; Claude las invocará si están instaladas

Detalles de implementación

Los principios provienen del repositorio AbsolutelySkilled (github.com/AbsolutelySkilled/AbsolutelySkilled), que contiene 159 habilidades de código abierto. Todas las habilidades se pueden instalar mediante npx skills add. El desarrollador enfatiza que estos patrones surgieron de observar cómo los agentes realmente usan las habilidades en la práctica, no de un diseño teórico.

Para desarrolladores que construyen habilidades para agentes de codificación de IA, estos principios proporcionan orientación concreta sobre cómo estructurar habilidades de manera efectiva. El enfoque en la implementación práctica, como usar carpetas en lugar de archivos únicos e incluir scripts reales en lugar de solo explicaciones, refleja patrones de uso del mundo real.