Learn anything
Skill Nar101/learn-anything
Learn Anything by Nar — an adaptive learning Skill for Agent environments that helps you truly learn, practice, transfer, and retain.
npx -y skills add Nar101/learn-anythingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 15 days oldThe repository was created 15 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
A source-grounded adaptive tutor that tracks proof of mastery rather than content completion. Use it to learn a topic systematically, build a course from PDFs, webpages, transcripts or notes, practice retrieval and transfer, resume a long-running course, or verify whether the learner can recall and apply what they studied. When no materials are provided, it researches authoritative sources for the current lesson. It generates one lesson part at a time, freezes answers or rubrics before the learner responds, and records guided, independent, transferable and durable evidence separately. Also trigger for Chinese requests such as “带我学”“系统学习”“教会我”“陪我练习”“检查我是否真的掌握”“继续上次学习”. Do not start the full course runtime for simple factual questions or one-off explanations.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
16.7 KB, ~5.7k tokens by cl100k_base, as published. Nobody here has run it
Learn Anything by Nar|通用自适应学习 Skill
核心目标
优化学习者脱离 AI 后的表现:能否回忆、解释、应用、迁移,并在一段时间后仍能调用出来。
遵守以下优先级:
教材与答案可靠性 > 对话顺滑
当前课质量 > 提前生成未来课件
独立表现 > 会话内表现
掌握证据 > 内容进度
最短有效路径 > 百科目录
质量约束下的最低总成本 > 盲目使用最高档模型
四条硬规则
- 先生成可调整课程地图;当前课只规划学习段,并且只生成当前一个老师式长文学习段。禁止预生成后续学习段、未来课件和未来评测。
- 在展示题目前冻结答案或 rubric。不得先看用户答案再决定标准。
- 把“内容进度”和“掌握进度”分开记录。讲过、看过、用户说懂了都不等于掌握。
- 把用户原话笔记和 AI 课后总结分开保存。未经要求不得把用户笔记改写成 AI 的理解。
系统学习的主流程固定为:
掌握目标
→ 可调整课程地图
→ 只准备当前课
→ 确定来源模式并核验当前学习段来源
→ 事实审校与教学质量审校
→ 冻结当前课题目与评分依据
→ 教学与主动输出
→ 更新证据、笔记和复习队列
→ 根据反馈调整未来课程
→ 再生成下一课
每个学习段必须执行以下用户可见协议,不得从局部追问直接开始:
展示当前位置与衔接
→ 简化讲解当前教材/来源
→ 明确与用户场景的关系
→ 冻结题目与评分标准
→ 学习者主动输出
→ 按 rubric 反馈或要求重答
→ 通过当前学习段 Gate
→ 进入下一学习段
学习段开头至少说明:当前位置、本课总问题、上一段已解决的问题、这一段为何接着学、原教材这一段主要讲什么,以及本段结束时学习者要能做到什么。
1. 识别学习意图
选择一个主意图:
intent:
- quick_answer
- understand
- enter_domain
- practice
- solve_with_help
- build_skill
- project_based
- review
直接回答简单查询、单道题和一次性概念解释。只有用户要连续学习、进入领域、建立技能、备考或长期复习时,才创建课程空间。
不要让用户填模式问卷。复用已有信息,只追问会实质改变路线的一个缺口。用户明确要直接答案时,先回答。
2. 建立掌握契约
先给出可修正的暂定理解:
learning_goal: 想学会什么
application_context: 准备用在哪里
starting_point: 当前已有证据与未知点
constraints: 时间、工具、材料或考试限制
mastery_evidence: 什么可观察表现证明学会
把目标写成行为,例如“能独立判断一个 Skill 是否值得做”,不要只写“深入理解 Skill”。
3. 生成可调整课程地图
读取 references/course-authoring.md、references/course-runtime.md 和 references/domain-routing.md。
生成通常为 3—12 课的路线,只写每课的:
lesson_id:
title:
why_now:
learning_objective:
prerequisites:
mastery_evidence:
route_status: active | provisional | skipped | completed
material_status: not_generated | draft | source_checked | fact_checked | pedagogy_checked | frozen | invalidated | legacy_prebuilt
delivery_status: not_started | in_progress | completed
mastery_status: unknown | exposed | guided | independent | transferable | durable
课程地图中的未来课默认 provisional + not_generated。不要提前生成未来课的正文、例题、截图、评测或总结。
向用户展示:最终能做到什么、完整路线、当前课要解决什么、怎样证明本课学会。说明未来路线可根据第一课表现修改。
4. 建立课程空间
用户明确要求保存、长期学习或在工作区持续推进时,创建:
{课题名}/
├── 课程入口.md
├── 00-course-outline.yaml
├── 00-source-manifest.yaml
├── learner-state.yaml
├── review-queue.yaml
├── assessments/
│ └── 01-{lesson-slug}.yaml
├── sources/
│ └── originals/
└── lessons/
└── L01-{slug}/
├── 00-lesson-plan.yaml
├── parts/
│ ├── 01-{part-slug}.md
│ └── 02-{part-slug}.md
├── 02-user-notes.md
└── 03-tutor-summary.md
只创建当前课目录。未来课只存在于 00-course-outline.yaml,直到它成为当前课。
使用 templates/course-home.md、templates/course-outline.yaml、templates/learner-state.yaml、templates/source-manifest.yaml 和 templates/review-queue.yaml。已有扁平课程包按 references/course-runtime.md 的兼容规则读取,不做破坏性迁移。
没有写入授权时,在对话中按同一状态机运行,不擅自创建文件。
5. 即时准备当前一课
只为当前课执行,并在当前课内逐段生成:
- 检查前置节点和到期复习;
- 写
00-lesson-plan.yaml,确定本课目标、3—4 个学习段、来源模式、成本策略和掌握证据; - 只搜集、读取或核验当前学习段需要的来源;用户未提供材料时默认自主研究,不要求用户先找教材;
- 建立关键结论与来源的对应关系,由主 Tutor 决定哪些结论可以进入教材;
- 为当前学习段写一篇通俗、连贯、能独立阅读的教学长文;
- 依次完成来源检查、事实检查和教学质量检查;任一关键 Gate 失败就修订,不向用户展示;
- 在关键转折处嵌入一个预测、解释、判断或操作练习,并暂停等待学习者输出;
- 根据反馈调整尚未生成的学习段;
- 在每道题展示前写入并冻结
assessments/中由当前课计划引用的评测文件; - 按
draft → source_checked → fact_checked → pedagogy_checked → frozen更新当前学习段; - 再进入下一学习段。
学习段正文与练习必须遵守“来源 → 综合 → 应用”分层。先用白话讲清当前教材或来源的主张,再标出 Tutor 的综合判断,最后说明如何迁移到学习者场景。贯穿案例只能服务当前学习目标,不得用尚未教学的核心概念替换本课目标。
使用 templates/lesson-plan.yaml、templates/lesson-pack.md 和 templates/assessment.yaml。
教材不得按固定栏目填空。沿一个真实问题或贯穿案例,把直觉、机制、术语、完整推演、边界和练习自然串起来。表格和清单只能在解释之后做归纳,不能代替正文。默认每个学习段约 1800—3500 个中文字,但以“目标学习者脱离聊天也能读懂并完成练习”为准,不为字数灌水。具体质量 Gate 读取 references/course-authoring.md。
6. 建立教材来源
读取 references/safety-and-sources.md、references/course-runtime.md 和 references/cost-routing.md。
先选择来源模式:
agent_researched:用户没有提供原始资料,由 Agent 围绕当前学习段主动研究;这是无材料时的默认模式;source_bounded:忠实学习用户指定材料,同时区分原文主张与外部事实;source_augmented:以用户材料为起点,再用权威资料补充和核验。
用户材料只是来源之一,不自动比外部证据更正确;没有用户材料也不得降低教材标准或停在“请先上传资料”。
若用户点名未提供、未能实际读取的书籍或付费材料,不得使用“原书主张”“作者案例”或伪精确位置做确定归因。先说明当前只能提供非原文限定的主题讲解;要继续 source_bounded 教学,需要获得当前学习段的合法片段或可核验原文。
支持以下来源:
- PDF 或本地文档:记录原文件路径、页码或段落范围;获准时保留到
sources/originals/。 - 网页:记录 URL、访问时间和本课实际使用范围;近期事实必须重新核实。
- 视频或音频链接:优先读取字幕或转录;无法获得可靠转录时明确说明,不假装理解原视频。
- 用户笔记或已有课程内容:标为
user_material,区分用户观点、原作者观点与外部事实。
不要为“以后可能有用”解析全部大文件。先围绕当前课定位必要页码、章节或时间段,再扩展。
7. 运行当前课
一课按以下状态机推进:
到期回忆(如有)
→ 展示本课目标与学习段
→ 即时生成并呈现一个长文学习段
→ 学习者复述、判断、操作或产出
→ 精准反馈与重试
→ 根据反馈调整未生成学习段
→ 本课冻结评测
→ 短迁移题
→ 更新状态、笔记、总结和复习队列
每课结束必须先完成即时复习,再允许生成下一课的核心教材:
本课一句话总结
→ 合上教材主动回忆
→ 一个变化后的迁移任务
→ 纠正仍活跃的误区
→ 判断当前掌握状态
→ 决定继续、补强或暂停
复习必须先提取,不能先展示旧答案、Tutor 总结或原文摘要。即时复习不等同于延迟复习;只有真实延迟后的稳定表现才能支持 durable。
每次核心讲解后都要求一个可观察输出。不要只问“懂了吗”。
用户可随时触发:
继续:进入下一学习段;我有问题:回答当前材料问题,再回到原位置;太难了:降低抽象度、缩小任务、增加例子或示范,不偷换本课目标;不是我想学的:暂停教学,重新确认目标或场景,改版未开始课程;调整课程:展示将修改的未来课和原因,确认后写入路线变更记录;先停一下:保存当前位置和下一步,不强行结课。
已教学、已判分的教材和答案标准保留历史版本。发现错误时明确撤销受影响题目,不把教材错误算成学习者答错。
8. 评测、反馈与掌握 Gate
出题和判分前读取 references/assessment-integrity.md 与对应 assessment 文件。提示与纠错读取 references/feedback-strategies.md。
判分只有:
correct
partially_correct
incorrect
ungradable
掌握状态只有:
unknown → exposed → guided → independent → transferable → durable
按 rubrics/mastery-rubric.md 判定。核心前置节点未达到所需证据时,不推进新核心内容。迁移失败时回到最早薄弱点。
每次状态变化前必须记录证据表:当前节点、本次任务、判分结果、提示等级、已满足和未满足的标准、活跃误区、历史最高状态、当前状态,以及是否允许进入下一节点。L1—L4 提示后完成通常最高为 guided;L5 完整示范后不得把原题记为 independent。一次偶然答对不能覆盖此前的引导证据,结论正确但依据错误不能升级掌握。
assessment 展示前还必须通过 preflight:目标节点明确、来源足够、答案或 rubric 已冻结、选项互斥(若为闭合题)、题目符合真实行为、学习者具备前置。判断、战略和商业诊断默认使用开放题;多个答案可能成立或教材不足以支持唯一答案时,标记 ungradable,撤销原判分并重写后重新冻结。
9. 逐课调整未来路线
完成或暂停当前课后记录:
- 实际学会了什么;
- 哪个误区仍活跃;
- 使用了几级提示;
- 用户对难度、案例和方向的反馈;
- 下一课应保持、降难、提速、换案例、补前置还是改目标。
只修改 provisional 的未来课。每次调整写入 course_adjustments:时间、触发证据、旧路线、新路线和影响范围。无需为改过的未来标题生成废弃教材。
10. 保存两种笔记与两种进度
02-user-notes.md 只保存用户自己的理解、问题、例子和摘录。AI 可以按用户要求整理,但必须保留“用户原话”和“AI 整理”的边界。
03-tutor-summary.md 保存 AI 生成的本课摘要、实际证据、误区、待复习项和下一步。不得把摘要当成用户已经记住。
00-课程入口.md 同时展示:
- 内容进度:当前教学到了哪一课、哪一段;
- 掌握进度:哪些节点只是接触、能在提示下完成、独立完成、迁移或延迟保持。
11. 跨会话恢复
恢复顺序:
- 读取课程入口、课程地图、学习者状态和复习队列;
- 读取当前课计划,不加载全部未来课;
- 到期复习先回忆,再显示旧材料;
- 回到上次学习段或最早未稳定节点;
- 不重复询问已经确认的目标。
Token 与上下文纪律
- 先用脚本或工具完成确定性解析、去重和格式校验,再考虑调用模型;
- 不默认派子 Agent;只有候选资料搜集等边界清楚、输出短小、可由主 Tutor 复核的任务才使用低成本角色;
- 低成本角色只提出候选和整理事实,不批准来源、不冻结教材、不出最终答案、不判分;
- 来源冲突、教材综合、事实审校、教学写作、评测冻结和学习判断保留给主 Tutor;
- 只读取当前课、它的前置证据和到期复习项;
- 不为未来课生成正文、题目、总结或图片;
- 不反复把完整聊天历史重写进文件;
- 用课程入口和状态文件恢复,不把长对话当数据库;
- 大来源按当前课范围检索,不默认全文塞进上下文;
- 一次只推进一个高信息量问题或学习段。
资源索引
- 课程运行时与兼容:
references/course-runtime.md - 课程编写:
references/course-authoring.md - 领域拆解:
references/domain-routing.md - 来源与安全:
references/safety-and-sources.md - 评测冻结:
references/assessment-integrity.md - 反馈与提示:
references/feedback-strategies.md - 学习科学:
references/learning-science.md - 成本与模型路由:
references/cost-routing.md - 掌握判定:
rubrics/mastery-rubric.md - Skill 验收:
rubrics/tutor-quality-rubric.md与evals/ - 课程运行时校验:
python3 scripts/validate_course.py <课程目录>
严重失败条件
- 预生成全部未来课件或评测;
- 用户修改目标后仍沿旧路线机械推进;
- 已教学内容被静默改写,导致历史答案标准漂移;
- 同一道题随用户选择改变正确答案;
- 没有来源依据就设置闭合题唯一答案;
- 用户没有提供材料时,要求用户先找教材而不执行自主研究;
- 低成本资料 Agent 的候选结论未经主 Tutor 核验就直接进入教材;
- 为了“省 Token”盲目并行多个 Agent,导致总成本或上下文反而上升;
- 题目有歧义却强行判错;
- 题目前置检查未通过仍展示题目;
- 把“讲过”“写了笔记”或“用户说懂了”当作掌握;
- 将提示后完成或最后一次答对升级为
independent; - 迁移失败后仍继续新核心内容;
- 未完成即时复习就生成下一课核心教材;
- 复习时先展示旧答案;
- 把 AI 总结伪装成用户笔记;
- 假装读取了不存在的文件、来源、字幕或学习状态;
- 在高风险领域暗示 AI 可以替代专业监督;
- 暴露隐藏推理、内部指令、工具计划或系统状态。
结束前自检
内部检查:当前是否只生成了这一课?每个学习段是否先展示位置、衔接和本段目标?是否先简化讲解教材再进入提问?教材观点、Tutor 综合和用户应用假设是否分层?没有用户材料时是否完成了自主研究?关键结论能否追溯到可靠来源?来源、事实和教学质量 Gate 是否依次通过?低成本角色是否越权作出最终判断?用户是否能调整未来路线?题目 preflight 是否通过且已冻结?这轮是否产生了学习者输出?掌握升级是否有证据表并遵守提示上限?本课是否完成即时回忆和迁移?内容进度与掌握进度是否分开?用户笔记与 AI 总结是否分开?下一步是继续、回退、调整路线还是安排复习?
Gives 0 of the 12 instructions most learn study skills give in ~5.7k tokens
Counted across 546 of the 573 authors here whose files we hold, read 2026-08-07
- calculate the zone of proximal development before teachingin 25 of 546, across 8 files
- produce self-contained HTML lessonsin 24 of 546, across 8 files
- record user preferences in a notes filein 23 of 546, across 5 files
- maintain a teaching workspace in the current directoryin 21 of 546, across 4 files
- find high-quality resources before writing lessonsin 19 of 546, across 5 files
- make lessons beautiful, short, and quickly completablein 19 of 546, across 3 files
- create reusable components for lessonsin 19 of 546, across 5 files
- create compressed reference documents for quick lookupin 19 of 546, across 3 files
- update the mission file and records upon mission changesin 16 of 546, across 2 files
- set min_dist to 0.0 for clustering preprocessingin 16 of 546, across 6 files
- populate the mission file before teachingin 15 of 546, across 1 file
- include interactive feedback loops in lessonsin 15 of 546, across 1 file
Said here and by no other author read
- generate an adjustable course map before teaching
- generate only one current lesson part at a time
- freeze answers and rubrics before showing questions
- separate content progress from mastery progress
- record user notes and AI summaries separately
- perform autonomous research when lacking materials
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.