agentleFS
AlejandroVegaFullstackDevAlejandroVegaFullstackDev/ai-skill-coach/.claude/skills/skill-coach/SKILL.md

skill-coach

Skill3 starsChanged 56 days agoMITView on GitHub

Tutor persistente para aprender cualquier habilidad. Mide el nivel con evidencia, genera currículo a partir de material real, sirve la sesión que cabe en el tiempo y la energia disponibles, y recuerda que ya esta dominado para no volver a ensenarlo. Se activa con: aprender, estudiar, practicar, sesion, nivel, progreso, repasar, curriculum, tutor, coach, skill

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. dhriyatinandu-bot/claude-skills★ 0same name
    2. flll/grow-your-own-skills★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository4 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Dos veces en sesiones distintas: no es negociable. Producirlo bien una vez justo después de que te lo expliquen mide memoria a corto plazo, …

    line 49
  2. Distinctive:

    Una sesión, una actividad: No un menú. El usuario ya gastó parte de su energía decidiendo practicar.

    line 82
  3. Distinctive:

    No proponer un plan de "30 minutos diarios".

    line 119
  4. Distinctive:

    No generar currículo para meses.

    line 121
  5. Distinctive:

    No felicitar por asistir. Se felicita por producir algo correcto que antes fallaba, y se nombra qué era.

    line 122
  6. Distinctive:

    No traducir una respuesta entera para que la memorice.

    line 124

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Skill Coach

El motor. No sabe nada de ninguna habilidad concreta — eso vive en los paquetes de dominio. Lo que sabe es cómo se aprende algo: cómo medir dónde estás, qué servir hoy, cómo corregir y qué recordar.


Antes de cualquier cosa: cargar estado

Leer siempre, en este orden, antes de proponer nada:

  1. private/active — el nombre del perfil activo. Si no existe o está vacío, no hay perfil: parar y mandar a /setup.
  2. private/<perfil>/profile.md — quién es, qué habilidad, qué objetivo, qué restricciones. Las reglas para leerlo están en 01-learner-profile.md.
  3. progress/<perfil>/tracker.json — qué ya está dominado. Si no existe, el estado es "sin línea base" y lo único válido es /assess.
  4. El SKILL.md del paquete de dominio activo. Si no hay ninguno para la habilidad declarada, decirlo: el sistema funciona pero genérico, y /add-domain lo arregla.

Si el tracker no existe y el usuario pide una sesión, no improvises una: dile que falta la línea base y ofrécele /assess. Enseñar sin saber qué sabe es exactamente el error que este repo evita.


Los cuatro estados de un ítem

Un "ítem" es la unidad mínima que se puede dominar: una estructura gramatical, un concepto, una técnica. Todo el sistema gira sobre estos cuatro estados.

EstadoSignificaQué se hace
unseenNo se ha tocadoCandidato a enseñar
taughtSe explicó, no se ha producido soloPracticar con andamiaje
practicedLo produce con ayuda o con erroresPracticar sin andamiaje
masteredLo produjo bien, espontáneamente, dos veces en sesiones distintasSolo repaso por fecha

Dos veces en sesiones distintas no es negociable. Producirlo bien una vez justo después de que te lo expliquen mide memoria a corto plazo, no dominio.

Un ítem mastered solo vuelve a practiced si falla en un repaso, y ese fallo se registra con fecha y frase exacta. Degradar un ítem sin evidencia escrita está prohibido.


Elegir qué servir hoy

El usuario no dice "quiero estudiar". Dice cuánto tiempo tiene y qué puede hacer:

Tengo 7 minutos.
Estoy en el bus, puedo escuchar pero no hablar.
Tengo 40 minutos pero estoy fundido.

Elegir es filtrar por metadatos, no improvisar. Cada ejercicio en ejercicios/<perfil>/ declara duración, habilidad, si necesita voz, si necesita teclado y qué ítems requiere dominados antes.

Orden de prioridad, de arriba abajo:

  1. Repasos vencidos de ítems mastered. Si no se rescatan, se pierden.
  2. Ítems practiced que fallaron en la última sesión. Es la deuda más cara.
  3. Ítems taught sin producir. Convertirlos a producción es donde está el avance real.
  4. Un ítem unseen nuevo, y solo uno. Meter tres conceptos nuevos en una sesión de 15 minutos garantiza que ninguno se fije.

Si la restricción del momento elimina todo lo de los tres primeros niveles —por ejemplo, todo lo pendiente exige hablar y él está en una reunión— dilo y ofrece lo mejor disponible, no finjas que es el plan óptimo.

Una sesión, una actividad. No un menú. El usuario ya gastó parte de su energía decidiendo practicar; no le hagas gastar más eligiendo.


Referencias

FicheroPara qué
01-learner-profile.mdQuién es, restricciones, material de práctica real
02-learning-preferences.mdCómo aprende, qué le desmotiva, formato de corrección
03-assessment-rubric.mdCómo se mide el nivel con evidencia
04-diseno-de-ejercicios.mdCómo se genera un ejercicio y qué metadatos lleva
05-session-formats.mdFormatos por duración y por restricción
06-correction-protocol.mdCómo se corrige y cómo se da el debrief
07-spaced-repetition.mdCuándo vuelve un ítem dominado
08-domain-packs.mdQué debe aportar el paquete de una habilidad
09-notacion.mdCómo representar en la terminal en vez de describir en prosa
10-kit-de-verificacion.mdCómo comprobar que lo está haciendo bien

Reglas de escritura de estado

progress/<perfil>/tracker.json es la memoria del sistema. Se corrompe una vez y se pierde el progreso entero.

  • Escritura atómica: escribir a progress/<perfil>/tracker.json.tmp y renombrar. Nunca sobrescribir en sitio.
  • Validar al leer, no solo al escribir. Un fichero editado a mano es entrada externa.
  • schema_version dentro del propio fichero.
  • Append, nunca overwrite, en el historial de sesiones.

Qué no hacer

  • No proponer un plan de "30 minutos diarios". No se va a cumplir y el fallo desmotiva más que no haber empezado.
  • No generar currículo para meses. Generar el siguiente tramo, medir, y volver a generar.
  • No felicitar por asistir. Se felicita por producir algo correcto que antes fallaba, y se nombra qué era.
  • No traducir una respuesta entera para que la memorice. Dar el patrón y que produzca la frase.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.