Qué contiene realmente el SKILL.md
Una skill no es más que sus instrucciones, así que aquí simplemente las describimos. El archivo empieza con la frontmatter: el nombre entrenador-practica-deliberada, la versión 1.0.0, la licencia MIT y una descripción breve que determina cuándo Claude activa la skill. El alcance y todas las frases de activación originales se conservan en el cuerpo. Después viene el rol en un único párrafo, y ese marca el tono: un entrenador de práctica que trabaja en español de España que no inventa puntuaciones de nivel sin tu aportación, que no promete maestría dentro de un plazo, y que nunca actúa como si las horas por sí solas generasen pericia.
A continuación aparece la teoría, con sus fuentes. Ericsson y el estudio con violinistas de 1993, Peak de 2016, las cuatro características de la práctica deliberada, la regla de las 10.000 horas y por qué no es cierta tal como se cuenta, el límite de 4 a 4,5 horas al día y la meseta OK. Al final de ese bloque están las tres reglas básicas que después se repiten en todo el archivo: cuatro pasos por ciclo, máximo 90 minutos por sesión, y exactamente una subhabilidad por sesión.
El corazón del archivo es una lista de ocho cosas que la skill siempre hace. Pregunta la habilidad, el nivel actual, el tiempo de práctica disponible por semana y el objetivo. Divide la habilidad en un mínimo de cuatro subhabilidades entrenables. Te deja dar una puntuación de 1 a 10 por subhabilidad. Diseña un ejercicio por subhabilidad con una duración exacta y un mecanismo de feedback concreto: grabación en vídeo, tarjeta de autopuntuación, medición, coach o reacción de un cliente. Construye una programación semanal que se ajusta a tu tiempo. Obliga a un momento de feedback después de cada sesión. Diagnostica una meseta cuando las puntuaciones se quedan igual durante tres sesiones. Y vigila los límites, incluso si tú mismo quieres sobrepasarlos.
Después vienen los cuatro prompts, y esa es la parte práctica que determina qué pides. El Plan de dominio entrega el mapa completo con subhabilidades, ejercicios y una programación semanal para cuatro semanas.
El Diseño de Sesión entrega una sesión completa de, por ejemplo, 60 minutos: objetivo, calentamiento de cinco minutos, ejercicio principal con instrucciones exactas, protocolo de feedback y una nota de corrección para la siguiente sesión. El Análisis de Feedback es para después: tú describes qué hiciste y qué feedback recibiste, y la skill señala qué va bien, cuál es el punto de mejora más crítico, qué ejercicio lo aborda y cuál es la prioridad para las próximas tres sesiones. Y el Superar la meseta de lo aceptable es para cuando todo se estanca: diagnóstico de la causa probable, tres ejercicios de ruptura concretos, un nuevo sistema de feedback y la sesión de práctica ideal para las próximas dos semanas.
Incluye una lista de comprobación de entrada obligatoria con seis puntos, con la instrucción de preguntar solo lo que falte. La habilidad y por qué precisamente esa. Tu nivel actual, a ser posible con un ejemplo concreto de un desempeño reciente. Tu tiempo de práctica disponible por semana, realista y no aspiracional. Tu objetivo y el plazo si lo hay. Qué fuentes de feedback tienes disponibles: cámara, coach, compañero, datos de medición, público. Y tus intentos de práctica anteriores, con el punto en el que se quedaron estancados.
El formato de salida está fijado en cinco partes. El mapa de subhabilidades. Los ejercicios, por subhabilidad con duración, mecanismo de feedback y el criterio con el que mides tu progreso. La programación semanal de cuatro semanas con días de descanso incluidos. El registro de feedback, como formato de relleno por sesión con fecha, subhabilidad, qué mejoró de forma medible, el punto más débil y la corrección para la próxima vez. Y la señal de meseta: cómo reconoces que el progreso se estanca y cuándo se activa el prompt de ruptura. Debajo de esa plantilla está el ejemplo desarrollado y resumido que ves en FIG.01 más arriba.
Al final del archivo está exactamente lo que la skill nunca hace, junto con cinco fuentes citadas por su nombre. Esos dos bloques aparecen más abajo, en la sección 04 y en DOC.04.