skill-developer

SKILL.md

Comprehensive guide for creating and managing skills in Claude Code with auto-activation system, following Anthropic's official best practices including the 500-line rule and progressive disclosure pattern.

Philosophy Change (2025-10-27): We moved away from blocking PreToolUse for Sentry/error handling. Instead, use gentle post-response reminders that don't block workflow but maintain code quality awareness.

✅ Keep SKILL.md under 500 lines ✅ Use progressive disclosure with reference files ✅ Add table of contents to reference files > 100 lines ✅ Write detailed description with trigger keywords ✅ Test with 3+ real scenarios before documenting ✅ Iterate based on actual usage

Cree y administre habilidades de Claude Code siguiendo las mejores prácticas de Anthropic. Úselo al crear nuevas habilidades, modificar Skill-rules.json, comprender patrones de activación, trabajar con ganchos, depurar la activación de habilidades o implementar la divulgación progresiva. Cubre la estructura de habilidades, temas de YAML, tipos de desencadenantes (palabras clave, patrones de intención, rutas de archivos, patrones de contenido), niveles de aplicación (bloquear, sugerir, advertir), mecanismos de enlace (UserPromptSubmit, PreToolUse), seguimiento de sesiones y la regla de las 500 líneas. Fuente: poletron/custom-rules.

Ver original