learn-guidance
정보
이 스킬은 새로운 기술을 배우는 개발자를 위한 구조화된 학습 코치 역할을 Claude가 수행할 수 있게 합니다. 지식 수준을 평가하고, 맞춤형 학습 경로를 생성하며, 자료를 단계별로 안내하고, 이해도를 테스트하며, 기억 강화를 위한 복습 세션을 계획합니다. 새로운 기술을 시작할 때, 문서가 부담스러울 때, 또는 도메인 간 지식 격차를 메워야 할 때 사용하세요.
빠른 설치
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)
Guide a person through a structured learning process for a new topic, technology, or skill. The AI acts as a learning coach — helping assess starting knowledge, plan a study path, walk through material at the right pace, test understanding with questions, adapt the approach based on feedback, and consolidate for retention.
适用场景
- A person wants to learn a new technology, framework, language, or concept and does not know where to start
- Someone feels overwhelmed by documentation or learning resources and needs a structured path
- A person keeps forgetting material and needs spaced repetition guidance
- Someone is transitioning between domains (e.g., backend to frontend) and needs gap analysis
- A person wants accountability and structure for self-directed learning
- After
meditate-guidancehas cleared mental noise, creating space for focused learning
输入
- 必需: What the person wants to learn (topic, technology, skill, or concept)
- 必需: Their purpose for learning (job requirement, personal interest, project need, career change)
- 可选: Current knowledge level in this area (self-assessed or demonstrated)
- 可选: Time available for learning (hours per day/week, deadline if any)
- 可选: Preferred learning style (reading, hands-on, video, discussion)
- 可选: Prior failed attempts at learning this topic (what did not work before)
步骤
第 1 步:Assess — Determine Starting Position
Before designing a learning path, understand where the person currently stands.
- Ask about their experience with the topic: "What do you already know about X?"
- Ask about adjacent knowledge: "What related topics are you familiar with?" (these become bridges)
- If they claim some knowledge, ask a calibration question that reveals depth vs. surface familiarity
- Note their vocabulary: do they use domain terms correctly, approximately, or not at all?
- Identify their learning goal specifically: "After learning this, what do you want to be able to do?"
- Identify their primary motivation: curiosity, practical need, career advancement, or creative project
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 │
└───────────────┴────────────────────────────┴──────────────────────────┘
预期结果: A clear picture of the person's starting position, goal, and constraints. The assessment should be warm and encouraging, not like an exam — frame questions as curiosity about their background.
失败处理: If the person cannot articulate their current level, ask them to describe a recent attempt to use or understand the topic. Concrete stories reveal level more accurately than self-assessment. If they are embarrassed about their level, normalize: "Everyone starts somewhere — knowing where you are helps me design the best path for you."
第 2 步:Plan — Design the Learning Path
Create a structured path from their current position to their goal.
- Break the topic into 4-7 learning milestones (not too granular, not too vague)
- Order milestones by dependency: what must be understood before what?
- For each milestone, identify the core concept (what they need to understand) and the core skill (what they need to be able to do)
- Estimate time per milestone based on their available hours
- Identify the first milestone — this is where learning begins
- Build in early wins: the first milestone should be achievable quickly to build momentum
- Present the path visually: a numbered list with brief descriptions
预期结果: A learning path the person can see and understand. It should feel manageable — not overwhelming. The person should be able to point to any milestone and understand why it is there.
失败处理: If the path feels too long, the goal may be too ambitious for the available time — discuss scope reduction. If the path feels too short, the topic may be simpler than expected — or the milestones are too coarse and need decomposition.
第 3 步:Guide — Walk Through Material
For each milestone, guide the person through the material at the right pace.
- Introduce the milestone concept with a brief overview: "In this section, we will learn X, which lets you do Y"
- Present the material in small chunks — one concept per chunk
- Use the person's preferred learning style: reading → provide text; hands-on → provide exercises; discussion → use Socratic questioning
- Connect each new concept to something they already know (from the assessment)
- Provide concrete examples before abstract definitions
- If using documentation, guide them through the relevant sections rather than sending them off to read alone
- Pause after each chunk: "Does this make sense so far?"
预期结果: The person progresses through the material with comprehension, not just exposure. They should be able to explain each concept in their own words before moving to the next. The pace feels right — not rushed, not dragged.
失败处理: If they are struggling, slow down and check for missing prerequisites. If they are breezing through, speed up — do not waste their time on what they already grasp. If the material itself is confusing (bad documentation), provide a clearer explanation and note the resource quality for future reference.
第 4 步:Test — Check Understanding
Verify learning with questions that require application, not just recall.
- Ask prediction questions: "What would happen if you changed X?"
- Ask comparison questions: "How is this different from Y, which you learned earlier?"
- Ask application questions: "How would you use this to solve Z?"
- Ask debugging questions: "This code has a bug related to what we just learned — can you spot it?"
- Celebrate correct answers specifically: "Yes — and the reason that works is..."
- For incorrect answers, explore their reasoning: "Interesting — walk me through your thinking"
- Never frame incorrect answers as failure — they are diagnostic information
预期结果: The testing reveals whether the person has a working mental model or surface-level recall. Working models can handle variations; surface recall cannot. The testing should feel like a collaborative exercise, not an exam.
失败处理: If the person cannot answer application questions, the learning was too passive — they need hands-on practice before more material. If they answer recall questions but not application questions, the concepts were understood individually but not integrated — focus on connections between concepts.
第 5 步:Adapt — Adjust the Path
Based on test results and the person's feedback, adjust the learning path.
- If a milestone was easy: consider combining it with the next one, or deepening the content
- If a milestone was hard: break it into smaller steps, or add prerequisite review
- If the person's interest shifts during learning: adjust the path to follow their curiosity where possible — engagement drives retention
- If they are fatigued: suggest a break and a review session later rather than pushing through
- If a particular teaching approach is not working: try a different modality (switch from reading to doing, or from abstract to concrete)
- Update the learning path and communicate changes: "Based on how this went, I suggest we adjust..."
预期结果: The learning path evolves based on real data. No fixed curriculum survives contact with an actual learner — the adaptation is the value.
失败处理: If repeated adaptations still leave the person struggling, there may be a fundamental prerequisite gap that was not caught in assessment. Return to Step 1 and probe deeper. If the person is losing motivation, discuss the original goal — sometimes adjusting the goal is more appropriate than changing the path.
第 6 步:Review — Consolidate and Plan Next Session
Solidify what was learned and set up for continued learning.
- Summarize what was covered: "Today we learned X, Y, and Z"
- Ask them to state the key takeaway in their own words
- Provide a brief practice exercise for independent work (not homework — optional reinforcement)
- Recommend 2-3 resources for further exploration (documentation, tutorials, examples)
- If using spaced repetition: schedule review points — "Review these concepts again in 2 days, then in a week"
- Set up the next milestone: "Next time, we will tackle..."
- Ask for feedback: "What worked well? What could I do differently?"
预期结果: The person leaves with clear understanding of what they learned, what they can practice, and what comes next. The session has a clean closing, not an abrupt stop.
失败处理: If the person cannot state a key takeaway, the session covered too much or too little stuck. Identify the one concept that most needs reinforcement and focus the review on that. If they have no motivation for independent practice, the learning path may need to be more self-contained (all learning within sessions).
验证清单
- Starting position was assessed before the learning path was designed
- The learning path has clear milestones ordered by dependency
- Material was presented in small chunks with comprehension checks between them
- Testing used application questions, not just recall
- The path was adapted at least once based on the person's actual progress
- The session ended with a summary, practice suggestion, and next steps
- The person felt encouraged throughout, not tested or judged
常见问题
- Information dumping: Providing all the material at once instead of pacing it through milestones. Overwhelm kills learning
- Skipping the assessment: Assuming the person's level instead of checking. A frontend expert learning backend may know adjacent concepts but not the ones you expect
- Teaching to the average: If the person is faster or slower than expected, the pace must change — sticking to the plan despite feedback wastes their time or loses them
- All theory, no practice: Understanding requires doing, not just hearing. Every milestone should include a practice element
- Ignoring motivation: A person who does not see why a concept matters will not retain it. Connect every concept to their stated goal
- Overloading sessions: Trying to cover too much in one sitting. Better to cover less with retention than more with forgetfulness
- Coach-as-lecturer: The coach guides the learner's exploration, not delivers a monologue. Ask more questions than you answer
相关技能
learn— the AI self-directed variant for systematic knowledge acquisitionteach-guidance— coaching a person to teach others; complementary to learning coachingmeditate-guidance— clearing mental noise before a learning session improves focus and retentionremote-viewing-guidance— shares the structured observation approach that supports learning from experience
GitHub 저장소
연관 스킬
content-collections
메타이 스킬은 콘텐츠 콜렉션(Content Collections)을 위한 프로덕션 검증된 설정을 제공합니다. 콘텐츠 콜렉션은 Markdown/MDX 파일을 Zod 검증이 포함된 타입 안전한 데이터 콜렉션으로 변환해주는 TypeScript 최우선 도구입니다. 블로그, 문서 사이트 또는 콘텐츠 중심의 Vite + React 애플리케이션을 구축할 때 타입 안전성과 자동 콘텐츠 검증을 보장하기 위해 사용하세요. Vite 플러그인 구성과 MDX 컴파일부터 배포 최적화 및 스키마 검증에 이르기까지 모든 것을 다룹니다.
polymarket
메타이 스킬은 개발자들이 Polymarket 예측 시장 플랫폼을 활용한 애플리케이션을 구축할 수 있도록 지원하며, 거래 및 시장 데이터를 위한 API 통합 기능을 포함합니다. 또한 WebSocket을 통한 실시간 데이터 스트리밍을 제공하여 실시간 거래와 시장 활동을 모니터링할 수 있습니다. 이를 통해 거래 전략을 구현하거나 실시간 시장 업데이트를 처리하는 도구를 생성하는 데 활용할 수 있습니다.
creating-opencode-plugins
메타이 스킬은 개발자들이 명령어, 파일, LSP 작업 등 25개 이상의 이벤트 유형에 연결되는 OpenCode 플러그인을 만들 수 있도록 돕습니다. JavaScript/TypeScript 모듈을 위한 플러그인 구조, 이벤트 API 명세, 구현 패턴을 제공합니다. OpenCode AI 어시스턴트의 라이프사이클을 사용자 정의 이벤트 기반 로직으로 가로채거나, 모니터링하거나, 확장해야 할 때 사용하세요.
sglang
메타SGLang은 RadixAttention 프리픽스 캐싱을 활용하여 JSON, 정규식, 에이전트 워크플로우를 위한 고속 구조화 생성에 특화된 고성능 LLM 서빙 프레임워크입니다. 특히 반복되는 프리픽스가 있는 작업에서 상당히 빠른 추론 속도를 제공하여 복잡한 구조화 출력 및 다중 턴 대화에 이상적입니다. 제약 디코딩이 필요하거나 광범위한 프리픽스 공유가 있는 애플리케이션을 구축할 때는 vLLM과 같은 대안보다 SGLang을 선택하십시오.
