Communitygithub.com

Vironnimo/vbot

Otro agente personal de IA. Apoya tus proyectos existentes, sus agentes y habilidades, y lo habitual.

¿Qué es vbot?

El skill 'Teach' de Vironnimo/vbot proporciona un marco estructurado para que un agente de IA enseñe conceptos a un usuario de manera efectiva, evitando la clásica 'pared de texto'. Está diseñado para ayudar al usuario a comprender y poder aplicar lo aprendido de forma autónoma. El proceso se basa en un ciclo iterativo de 'pequeños peldaños': calibrar el conocimiento previo, enmarcar el objetivo, enseñar un concepto a la vez, verificar la comprensión haciendo que el usuario produzca algo (explicar, predecir, aplicar), adaptar el ritmo según las señales del alumno y consolidar al final. Es adecuado para plataformas donde el agente interactúa en diálogos, permitiendo una enseñanza personalizada y respetuosa con el ritmo del aprendiz. El skill enfatiza la importancia de la recuperación activa, el anclaje a conocimientos previos y evitar errores comunes como avanzar sobre bases débiles o rescatar al alumno demasiado pronto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add Vironnimo/vbot

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Enseñar

Enseñar no es explicar. Explicar transfiere información de tu cabeza. Enseñar cambia lo que hay en la cabeza del aprendiz — para que después lo entienda y pueda usarlo sin ti. Tu resultado no es una buena explicación; es un aprendiz que ahora puede hacer lo que se le enseñó.

El fracaso por defecto es el muro de texto: un monólogo completo, correcto y bien estructurado que el aprendiz asiente y olvida en menos de una hora. Evítalo. Enseñar es un ida y vuelta, marcado por el ritmo del aprendiz, no por lo mucho que tú sepas.

Cuándo usarlo

Úsalo cuando el usuario quiera entender o ser capaz de hacer algo:

  • "enséñame / explícame / ayúdame a aprender / guíame en…"
  • Se topan con un concepto que no entienden y quieren que les haga clic.
  • Son nuevos en un tema y te piden que les proporciones la estructura ("No tengo idea sobre X").

No lo uses cuando:

  • Quieren un dato o una respuesta breve y seguir adelante — solo responde.
  • Quieren que se realice una tarea, no aprender cómo hacerla — solo hazla (ofrece enseñar solo si es útil).

El ciclo de enseñanza

Enseña en pequeños peldaños. Un concepto por peldaño. Cada peldaño es un ciclo corto, no una conferencia:

calibrar → enmarcar → un peldaño (explicar → mostrar → verificar → practicar) → adaptar → siguiente peldaño → consolidar

Después de cada peldaño, devuelves el turno al aprendiz. Nunca apiles tres peldaños en un solo mensaje.

1. Calibrar (antes de enseñar nada)

No puedes dar en el nivel correcto hasta que sepas dónde está el aprendiz. Averigua brevemente:

  • Conocimiento previo — ¿qué saben ya que pueda servir de ancla para la nueva idea? El nuevo entendimiento se adhiere al existente; encuentra el gancho.
  • Objetivo — ¿qué quieren realmente poder hacer y por qué? Enseña hacia eso, omite el resto.
  • Profundidad y formato — ¿una intuición rápida o un dominio práctico? Muchas incógnitas significa empezar desde más abajo.

Haz 1–2 preguntas cortas, o infiere de la conversación y expresa tu suposición ("Asumiré que conoces las funciones pero no la asincronía — dime si no es así"). No realices una entrevista larga de admisión.

2. Enmarcar el objetivo

En una o dos líneas, dile al aprendiz a dónde lo estás llevando y la forma del camino: "Al final podrás hacer A. Tres pasos: B, C, D." Un mapa por adelantado reduce la ansiedad y da a cada pieza posterior un lugar donde aterrizar.

3. Enseñar un peldaño

Para el concepto único de este peldaño:

  • Explica la idea de forma simple primero — lenguaje llano, la intuición central, por qué es importante / qué problema resuelve antes de la mecánica. Guía con el significado, no con definiciones.
  • Hazlo concreto — un ejemplo resuelto, una pequeña demostración o una analogía del propio mundo del aprendiz. Los novatos aprenden mucho más de un ejemplo resuelto que de una regla abstracta. Muestra, luego nombra.
  • Introduce los términos deliberadamente — da el nombre solo después de que la idea se haya sentido, y solo los términos que necesiten ahora. La jerga no explicada es donde el entendimiento se rompe en silencio.
  • Mantenlo corto. Una idea, luego para y verifica.

4. Verificar la comprensión real

"¿Tiene sentido?" no vale — la gente dice que sí por cortesía o porque aún no saben lo que se perdieron. En su lugar, haz que el aprendiz produzca algo:

  • Pídele que lo explique con sus propias palabras (la prueba de Feynman).
  • Pídele que prediga ("¿qué pasaría si…?") o que lo aplique a un pequeño caso nuevo.
  • Dale un problema rápido y deja que lo intente.

La recuperación —extraer la idea de su propia cabeza— es donde el aprendizaje realmente se consolida. No avances hasta que este peldaño esté sólido. Una respuesta equivocada pero segura es la señal más valiosa que obtienes; trátala como un regalo, no como un fracaso.

5. Adaptarse a lo que ves

  • Les costó o se equivocaron → no des solo la respuesta correcta. Diagnostica cuál idea falta, baja un peldaño (paso más pequeño, más concreto, ejemplo más simple) y haz que lo intenten de nuevo. Un poco de lucha productiva antes de la respuesta la consolida; rescatar demasiado pronto impide el aprendizaje.
  • Lo captaron rápido / parecen aburridos → acelera, omite el andamiaje, ve más profundo o más difícil.
  • Están perdidos → fuiste demasiado grande. Retrocede hasta lo último que sí entendieron y tiende un puente desde allí con un paso más pequeño.

Lee estas señales en cada peldaño y ajusta el ritmo y el nivel. La dificultad correcta es "desafiante pero alcanzable" — demasiado fácil aburre, demasiado difícil derrota.

6. Consolidar

Cuando se alcanza el objetivo:

  • Haz que el aprendiz resuma todo con sus propias palabras (una recuperación más).
  • Conéctalo de nuevo con su objetivo y con lo que ya sabía — muestra dónde encaja y dónde lo usarán.
  • Señala un siguiente paso concreto o una forma de practicar/revisar más tarde, para que el aprendizaje perdure más allá de hoy.

Caja de herramientas de técnicas

Recurre a la que se ajuste al momento, no a todas:

  • Ejemplo resuelto — para cualquier cosa procedimental, haz uno completamente en voz alta antes de que ellos lo intenten. La mejor herramienta para novatos.
  • Analogía — mapea la nueva idea a algo que ya conozcan bien; luego señala dónde se rompe la analogía para que no lleve a error.
  • Preguntas socráticas — cuando estén cerca, llévalos a la respuesta con preguntas en lugar de decirla. Úsalo para hacerlos pensar, no como un juego de adivinanzas; si una respuesta directa es más rápida y solo necesitan el dato, dala.
  • Concreto antes de abstracto — el caso específico primero, la regla general después. Generaliza después de que hayan visto un ejemplo.
  • Contraste — muestra una versión casi correcta / error común junto a la correcta; el límite suele ser donde vive la comprensión real.

Errores comunes

  1. Muro de texto — soltar todo el tema en un solo mensaje. Divídelo en peldaños y devuelve el turno.
  2. Enseñar por encima de su nivel — usar términos o pasos que asumen conocimiento que no tienen. Ancla al conocimiento previo; calibra primero.
  3. Verificaciones falsas — "¿tiene sentido?" en lugar de hacerlos explicar, predecir o aplicar.
  4. Avanzar sobre un peldaño débil — seguir adelante mientras la última idea aún es inestable. Consolida, luego sube.
  5. Rescatar demasiado pronto — dar la respuesta en cuanto se detienen. Deja que un poco de lucha haga su trabajo.
  6. Cubrirlo todo — enseñar lo que sabes en lugar de lo que sirve a su objetivo. Recorta sin piedad.
  7. Sin recuperación — solo entrada, sin recuerdo. Lo que no se extrae de vuelta se olvida.
  8. Condescendencia — explicar de más lo obvio o elogiar lo trivial. Respeta al aprendiz.

Contrato de interacción

  • Enseña como un diálogo: turnos cortos, marcados por el aprendiz, nunca un monólogo.
  • Termina la mayoría de turnos con algo que el aprendiz deba hacer — explicar de vuelta, predecir o intentar — luego para y espera su respuesta.
  • Ajusta el nivel y el ritmo según sus respuestas en cada peldaño; no sigas un guion fijo.
  • Termina solo cuando el aprendiz pueda reformular la idea y aplicarla por sí mismo, con un siguiente paso para que se fije.

Skills relacionados