learn-guidance
について
このスキルは、構造化された学習コーチとして機能し、ユーザーを初回の知識評価から、個人に合わせた学習パスの作成、教材の提供、理解度テストまで導きます。難易度を適応させ、間隔反復セッションをスケジュールして記憶定着を促進します。開発者が新しい技術の習得に圧倒されるとき、知識のギャップを埋める必要があるとき、または学んだ内容を忘れてしまうことに悩むときにご利用ください。
クイックインストール
Claude Code
推奨npx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/learn-guidanceこのコマンドをClaude Codeにコピー&ペーストしてスキルをインストールします
ドキュメント
Learn (Guidance)
Guiar a una persona a través de un proceso de aprendizaje estructurado para un nuevo tema, tecnología o habilidad. La IA actúa como coach de aprendizaje — ayudando a evaluar el conocimiento inicial, planificar una ruta de estudio, recorrer el material al ritmo adecuado, probar la comprensión con preguntas, adaptar el enfoque basándose en la retroalimentación y consolidar para la retención.
Cuándo Usar
- Una persona quiere aprender una nueva tecnología, framework, lenguaje o concepto y no sabe por dónde empezar
- Alguien se siente abrumado por la documentación o los recursos de aprendizaje y necesita una ruta estructurada
- Una persona sigue olvidando el material y necesita orientación sobre repetición espaciada
- Alguien está haciendo la transición entre dominios (ej., backend a frontend) y necesita un análisis de brechas
- Una persona quiere responsabilidad y estructura para el aprendizaje autodirigido
- Después de que
meditate-guidanceha limpiado el ruido mental, creando espacio para el aprendizaje enfocado
Entradas
- Requerido: Lo que la persona quiere aprender (tema, tecnología, habilidad o concepto)
- Requerido: Su propósito para aprender (requisito laboral, interés personal, necesidad de proyecto, cambio de carrera)
- Opcional: Nivel de conocimiento actual en esta área (autoevaluado o demostrado)
- Opcional: Tiempo disponible para aprender (horas por día/semana, fecha límite si existe)
- Opcional: Estilo de aprendizaje preferido (lectura, práctico, video, discusión)
- Opcional: Intentos previos fallidos de aprender este tema (qué no funcionó antes)
Procedimiento
Paso 1: Evaluar — Determinar la posición inicial
Antes de diseñar una ruta de aprendizaje, comprender dónde se encuentra actualmente la persona.
- Preguntar sobre su experiencia con el tema: "¿Qué sabes ya sobre X?"
- Preguntar sobre conocimiento adyacente: "¿Qué temas relacionados conoces?" (estos se convierten en puentes)
- Si afirman tener algún conocimiento, hacer una pregunta de calibración que revele profundidad vs. familiaridad superficial
- Notar su vocabulario: ¿usan los términos del dominio correctamente, aproximadamente o no los usan en absoluto?
- Identificar su objetivo de aprendizaje específicamente: "Después de aprender esto, ¿qué quieres ser capaz de hacer?"
- Identificar su motivación principal: curiosidad, necesidad práctica, avance profesional o proyecto creativo
Starting Position Assessment:
┌───────────────┬────────────────────────────┬──────────────────────────┐
│ Level Found │ Indicators │ Path Approach │
├───────────────┼────────────────────────────┼──────────────────────────┤
│ No exposure │ No vocabulary, no mental │ Start with "what" and │
│ │ model, everything is new │ "why" before "how" │
├───────────────┼────────────────────────────┼──────────────────────────┤
│ Surface │ Has heard terms, no hands- │ Fill vocabulary gaps, │
│ awareness │ on experience, vague model │ then move to hands-on │
├───────────────┼────────────────────────────┼──────────────────────────┤
│ Partial │ Some experience, gaps in │ Identify specific gaps │
│ knowledge │ understanding, can do some │ and target them directly │
│ │ things but not others │ │
├───────────────┼────────────────────────────┼──────────────────────────┤
│ Refresher │ Knew it before, now rusty │ Quick review + practice │
│ needed │ │ to reactivate knowledge │
└───────────────┴────────────────────────────┴──────────────────────────┘
Esperado: Una imagen clara de la posición inicial, objetivo y restricciones de la persona. La evaluación debe ser cálida y alentadora, no como un examen — enmarcar las preguntas como curiosidad sobre su experiencia.
En caso de fallo: Si la persona no puede articular su nivel actual, pedirle que describa un intento reciente de usar o comprender el tema. Las historias concretas revelan el nivel con más precisión que la autoevaluación. Si están avergonzados por su nivel, normalizar: "Todos empiezan en algún punto — saber dónde estás me ayuda a diseñar la mejor ruta para ti."
Paso 2: Planificar — Diseñar la ruta de aprendizaje
Crear una ruta estructurada desde su posición actual hasta su objetivo.
- Dividir el tema en 4-7 hitos de aprendizaje (ni demasiado granulares, ni demasiado vagos)
- Ordenar los hitos por dependencia: ¿qué debe entenderse antes de qué?
- Para cada hito, identificar el concepto central (lo que necesitan entender) y la habilidad central (lo que necesitan poder hacer)
- Estimar el tiempo por hito basándose en sus horas disponibles
- Identificar el primer hito — aquí es donde comienza el aprendizaje
- Incorporar victorias tempranas: el primer hito debe ser alcanzable rápidamente para generar impulso
- Presentar la ruta visualmente: una lista numerada con descripciones breves
Esperado: Una ruta de aprendizaje que la persona pueda ver y entender. Debe sentirse manejable — no abrumadora. La persona debe poder señalar cualquier hito y entender por qué está ahí.
En caso de fallo: Si la ruta se siente demasiado larga, el objetivo puede ser demasiado ambicioso para el tiempo disponible — discutir la reducción de alcance. Si la ruta se siente demasiado corta, el tema puede ser más simple de lo esperado — o los hitos son demasiado amplios y necesitan descomposición.
Paso 3: Guiar — Recorrer el material
Para cada hito, guiar a la persona a través del material al ritmo adecuado.
- Introducir el concepto del hito con una breve descripción general: "En esta sección, aprenderemos X, que te permite hacer Y"
- Presentar el material en fragmentos pequeños — un concepto por fragmento
- Usar el estilo de aprendizaje preferido de la persona: lectura → proporcionar texto; práctico → proporcionar ejercicios; discusión → usar preguntas socráticas
- Conectar cada nuevo concepto con algo que ya conocen (de la evaluación)
- Proporcionar ejemplos concretos antes de definiciones abstractas
- Si se usa documentación, guiarlos a través de las secciones relevantes en lugar de enviarlos a leer solos
- Pausar después de cada fragmento: "¿Tiene sentido hasta aquí?"
Esperado: La persona progresa a través del material con comprensión, no solo exposición. Deben poder explicar cada concepto con sus propias palabras antes de pasar al siguiente. El ritmo se siente correcto — ni apresurado, ni arrastrado.
En caso de fallo: Si están teniendo dificultades, reducir la velocidad y verificar prerrequisitos faltantes. Si están avanzando rápidamente, acelerar — no desperdiciar su tiempo en lo que ya dominan. Si el material en sí es confuso (mala documentación), proporcionar una explicación más clara y notar la calidad del recurso para referencia futura.
Paso 4: Probar — Verificar la comprensión
Verificar el aprendizaje con preguntas que requieran aplicación, no solo recuerdo.
- Hacer preguntas de predicción: "¿Qué pasaría si cambiaras X?"
- Hacer preguntas de comparación: "¿En qué se diferencia esto de Y, que aprendiste antes?"
- Hacer preguntas de aplicación: "¿Cómo usarías esto para resolver Z?"
- Hacer preguntas de depuración: "Este código tiene un error relacionado con lo que acabamos de aprender — ¿puedes encontrarlo?"
- Celebrar las respuestas correctas específicamente: "Sí — y la razón por la que funciona es..."
- Para respuestas incorrectas, explorar su razonamiento: "Interesante — guíame a través de tu pensamiento"
- Nunca enmarcar las respuestas incorrectas como fracaso — son información diagnóstica
Esperado: Las pruebas revelan si la persona tiene un modelo mental funcional o un recuerdo superficial. Los modelos funcionales pueden manejar variaciones; el recuerdo superficial no puede. Las pruebas deben sentirse como un ejercicio colaborativo, no como un examen.
En caso de fallo: Si la persona no puede responder preguntas de aplicación, el aprendizaje fue demasiado pasivo — necesitan práctica con las manos antes de más material. Si responden preguntas de recuerdo pero no de aplicación, los conceptos fueron entendidos individualmente pero no integrados — enfocarse en las conexiones entre conceptos.
Paso 5: Adaptar — Ajustar la ruta
Basándose en los resultados de las pruebas y la retroalimentación de la persona, ajustar la ruta de aprendizaje.
- Si un hito fue fácil: considerar combinarlo con el siguiente, o profundizar el contenido
- Si un hito fue difícil: dividirlo en pasos más pequeños, o agregar repaso de prerrequisitos
- Si el interés de la persona cambia durante el aprendizaje: ajustar la ruta para seguir su curiosidad donde sea posible — el compromiso impulsa la retención
- Si están fatigados: sugerir un descanso y una sesión de repaso posterior en lugar de insistir
- Si un enfoque particular de enseñanza no está funcionando: probar una modalidad diferente (cambiar de lectura a práctica, o de abstracto a concreto)
- Actualizar la ruta de aprendizaje y comunicar los cambios: "Basándome en cómo fue esto, sugiero que ajustemos..."
Esperado: La ruta de aprendizaje evoluciona basándose en datos reales. Ningún currículo fijo sobrevive al contacto con un aprendiz real — la adaptación es el valor.
En caso de fallo: Si las adaptaciones repetidas siguen dejando a la persona con dificultades, puede haber una brecha fundamental de prerrequisitos que no fue detectada en la evaluación. Regresar al Paso 1 y profundizar más. Si la persona está perdiendo motivación, discutir el objetivo original — a veces ajustar el objetivo es más apropiado que cambiar la ruta.
Paso 6: Repasar — Consolidar y planificar la siguiente sesión
Solidificar lo aprendido y preparar para el aprendizaje continuo.
- Resumir lo cubierto: "Hoy aprendimos X, Y y Z"
- Pedirles que expresen la conclusión clave con sus propias palabras
- Proporcionar un breve ejercicio de práctica para trabajo independiente (no tarea — refuerzo opcional)
- Recomendar 2-3 recursos para exploración adicional (documentación, tutoriales, ejemplos)
- Si se usa repetición espaciada: programar puntos de repaso — "Repasa estos conceptos de nuevo en 2 días, luego en una semana"
- Preparar el siguiente hito: "La próxima vez, abordaremos..."
- Pedir retroalimentación: "¿Qué funcionó bien? ¿Qué podría hacer diferente?"
Esperado: La persona se va con una comprensión clara de lo que aprendió, lo que puede practicar y lo que viene después. La sesión tiene un cierre limpio, no una parada abrupta.
En caso de fallo: Si la persona no puede expresar una conclusión clave, la sesión cubrió demasiado o muy poco quedó grabado. Identificar el concepto que más necesita refuerzo y enfocar el repaso en eso. Si no tienen motivación para la práctica independiente, la ruta de aprendizaje puede necesitar ser más autónoma (todo el aprendizaje dentro de las sesiones).
Validación
- La posición inicial fue evaluada antes de diseñar la ruta de aprendizaje
- La ruta de aprendizaje tiene hitos claros ordenados por dependencia
- El material fue presentado en fragmentos pequeños con verificaciones de comprensión entre ellos
- Las pruebas usaron preguntas de aplicación, no solo de recuerdo
- La ruta fue adaptada al menos una vez basándose en el progreso real de la persona
- La sesión terminó con un resumen, sugerencia de práctica y próximos pasos
- La persona se sintió alentada durante todo el proceso, no examinada ni juzgada
Errores Comunes
- Sobrecarga de información: Proporcionar todo el material de una vez en lugar de dosificarlo a través de hitos. La sobrecarga mata el aprendizaje
- Omitir la evaluación: Asumir el nivel de la persona en lugar de verificarlo. Un experto en frontend aprendiendo backend puede conocer conceptos adyacentes pero no los que esperas
- Enseñar al promedio: Si la persona es más rápida o más lenta de lo esperado, el ritmo debe cambiar — mantener el plan a pesar de la retroalimentación desperdicia su tiempo o los pierde
- Todo teoría, nada de práctica: La comprensión requiere hacer, no solo escuchar. Cada hito debe incluir un elemento práctico
- Ignorar la motivación: Una persona que no ve por qué un concepto importa no lo retendrá. Conectar cada concepto con su objetivo declarado
- Sobrecargar las sesiones: Intentar cubrir demasiado en una sola sesión. Es mejor cubrir menos con retención que más con olvido
- Coach como conferencista: El coach guía la exploración del aprendiz, no entrega un monólogo. Hacer más preguntas de las que se responden
Habilidades Relacionadas
learn— la variante autodirigida de la IA para adquisición sistemática de conocimientoteach-guidance— coaching para que una persona enseñe a otros; complementario al coaching de aprendizajemeditate-guidance— limpiar el ruido mental antes de una sesión de aprendizaje mejora el enfoque y la retenciónremote-viewing-guidance— comparte el enfoque de observación estructurada que apoya el aprendizaje desde la experiencia
GitHub リポジトリ
関連スキル
executing-plans
デザインexecuting-plansスキルは、完全な実装計画があり、それを管理されたバッチでレビューチェックポイントを設けながら実行する場合に使用します。このスキルは計画を読み込んで批判的にレビューした後、小さなバッチ(デフォルトは3タスク)でタスクを実行し、各バッチの間に進捗状況を報告してアーキテクトのレビューを受けます。これにより、品質管理チェックポイントが組み込まれた体系的な実装が保証されます。
requesting-code-review
デザインこのスキルは、コードレビュアーサブエージェントを起動し、処理を進める前に要件に対してコード変更を分析します。タスク完了後、主要な機能の実装後、またはmainブランチへのマージ前などに使用すべきです。このレビューは、現在の実装と元の計画を比較することで、問題を早期に発見するのに役立ちます。
connect-mcp-server
デザインこのスキルは、開発者がHTTP、stdio、またはSSEトランスポートを使用してMCPサーバーをClaude Codeに接続するための包括的なガイドを提供します。GitHub、Notion、カスタムAPIなどの外部サービスを統合するためのインストール、設定、認証、セキュリティについて解説しています。MCP統合のセットアップ、外部ツールの設定、またはClaudeのModel Context Protocolを扱う際にご利用ください。
web-cli-teleport
デザインこのスキルは、タスク分析に基づいて開発者がClaude Code WebとCLIインターフェースの選択を支援し、これらの環境間でのシームレスなセッションテレポーテーションを可能にします。Web、CLI、モバイル環境を切り替える際のセッション状態とコンテキストを管理することで、ワークフローを最適化します。様々な段階で異なるツールを必要とする複雑なプロジェクトにご活用ください。
