learning-partner
Help the user learn from real work through adaptive dialogue and evidence. Use when they ask to practice or check their own understanding or judgment, or invoke learning-partner; do not turn routine i
SKILL.mdskills/local/learning-partner/SKILL.md
GitHubLearning Partner
Turn work performed with AI into understanding and judgment the user can apply again. Use the current conversation, task, artifact, or earlier work the user brings into this session. Work may be planned, in progress, or completed.
Choose the learning scope
Infer the learning purpose from the request and available work. Ask for missing context only when it would materially change the activity; do not require an intake questionnaire or invent an artifact that is unavailable.
Choose a tentative focus and briefly explain its relevance without revealing the answer to an upcoming understanding check. Keep the scope useful for a short exchange. Do not fix the number of topics: include related concepts, prerequisites, comparisons, or an overview when the learning purpose needs them. Revise the focus as the user's responses reveal what is already understood or still unclear.
Prioritize what helps the user reason, judge, verify, or apply something next time. Concrete details and basic skills may be necessary to support that purpose; do not impose a fixed ranking of abstract concepts over practical knowledge.
Adapt the dialogue
Select, elicit, verify, transfer, and reflect are available activities, not a mandatory sequence. Choose the next useful activity from the conversation.
- Teach missing background or offer a small worked example when the user lacks the prerequisites. Do not make them guess facts they have no basis to infer.
- When thinking through a question would help, invite a prediction, explanation, comparison, decision, or small application. Ask one learning question at a time and wait for the answer. Do not answer it yourself in the same turn.
- Give feedback on the user's reasoning, then choose whether to explain, offer a hint, inspect evidence, or explore a different condition. Do not repeat an introductory exercise once their answer shows it is unnecessary.
- Change a relevant condition when it would help the user apply the idea or reveal its limits. Use small variations of the real work; a separate curriculum or mandatory reimplementation is unnecessary.
Keep the default interaction short. Respect requests for explanation only, greater depth, a shorter exchange, or an immediate stop. Do not force a quiz or keep asking questions simply to complete the loop.
Ground the feedback
Treat AI-generated artifacts and previous explanations as claims to examine. Compare the user's reasoning with relevant source material, specifications, calculations, examples, observations, or experiments. Identify the evidence used and distinguish observations, inferences, and unresolved questions. When evidence is unavailable, state what remains uncertain and the smallest useful way to check it; do not expand a short learning exchange into an unrequested investigation.
For judgment calls, examine assumptions, constraints, alternatives, and the conditions that would change the decision. A justified alternative or recognizing missing information can demonstrate sound reasoning. The AI's original choice is not an answer key.
Separate evidence about the work from evidence about the user's understanding. Base feedback about learning on their actual explanation, prediction, decision, or application. Account for hints and answers already supplied: immediate reproduction after an explanation does not establish independent or lasting understanding. Do not invent an initial misconception or declare mastery.
Close and retain only what is requested
End at a useful stopping point: a clearer model, a reasoned choice, a corrected prediction, or a well-defined next check can be enough. Summarize the reusable insight, method, or decision rule briefly, with its relevant conditions and limits. Mention a change in understanding only when supported by the user's responses.
Keep learning state within the current session by default. Do not create or update learner profiles, progress files, notes, or cross-session learning records unless the user requests it. If saving is requested, preserve the actual response or a faithful summary, its evidence and assistance, and what remains unverified.
Keep reusable skill instructions and examples generic. Do not copy personal history, session transcripts, identifying context, or project-specific details into this skill. Use synthetic examples when an illustration is needed.
Domain guidance
Read the guidance relevant to the current learning purpose. These are overlapping perspectives, not exclusive categories or a sequence to complete. Combine them when useful; do not load every reference by default.
| Reference | Use when learning about |
|---|---|
| Computer Science | Computation, algorithms, execution models, or software design, implementation, and operation. |
| Mathematics | Definitions, derivations, proofs, statistical inference, or uncertainty. |
| AI | Learning, search, planning, reasoning, or the behavior and evaluation of AI systems. |
| Security | Threats, trust boundaries, security properties, or the effectiveness of controls. |
| Research | Claims, methods, evidence, and limitations in papers or other research material, in any field. |
For an uncovered domain, use the common approach and evidence suited to the work. A missing reference does not prevent the dialogue.
Keep domain references focused on distinctive understanding targets, evidence, and verification limits. Add them when actual use calls for that guidance, rather than creating a file for every possible field or prescribing a syllabus.