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-guidanceClaude 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
디자인이 스킬은 코드 변경 사항을 요구 사항에 따라 분석하기 위해 코드 리뷰어 하위 에이전트를 호출합니다. 작업 완료 후, 주요 기능 구현 후, 또는 메인 브랜치에 병합하기 전에 사용해야 합니다. 이 리뷰는 현재 구현체와 원래 계획을 비교하여 문제를 조기에 발견하는 데 도움이 됩니다.
connect-mcp-server
디자인이 스킬은 개발자들이 HTTP, stdio 또는 SSE 전송 방식을 통해 MCP 서버를 Claude Code에 연결하는 포괄적인 가이드를 제공합니다. GitHub, Notion 및 사용자 정의 API와 같은 외부 서비스를 통합하기 위한 설치, 구성, 인증 및 보안을 다룹니다. MCP 통합 설정, 외부 도구 구성 또는 Claude의 모델 컨텍스트 프로토콜 작업 시 활용하세요.
web-cli-teleport
디자인이 스킬은 작업 분석을 기반으로 개발자가 Claude Code 웹 인터페이스와 CLI 인터페이스 중 선택할 수 있도록 돕고, 두 환경 간 원활한 세션 텔레포트를 가능하게 합니다. 웹, CLI 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.
