study-system
Skill8 starsChanged 3 months agoMITView on GitHub
Turn course material into durable knowledge instead of a reread. Use when the user is studying for an exam or quiz, has lecture notes or slides to process, is assigned a reading, asks to be quizzed or tested, wants flashcards or a study plan, just got a graded exam back, or says they studied and still did badly.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- SkillMedev/personal-operating-systemtheir own version, first seen Oct 5, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- SkillMedev/personal-operating-system★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- hud/CLAUDE.mdCLAUDE.md
- agent-setupSkill
- asaSkill
- audio-briefSkill
- call-coachSkill
- clone-siteSkill
- courseworkSkill
- creative-videoSkill
- debuggingSkill
- deep-researchSkill
- demoSkill
- graph-engineeringSkill
- gtm-engineeringSkill
- hudSkill
- interfaceSkill
- jev-browseSkill
- kit-builderSkill
- life-contextSkill
- life-opsSkill
- list-auditSkill
- mac-actSkill
- mac-appsSkill
- mac-briefSkill
- mac-controlSkill
- mac-debugSkill
- mac-followupsSkill
- mac-permissionsSkill
- mac-runtimeSkill
- mac-seeSkill
- peopleSkill
- prospect-briefSkill
- repo-healthSkill
- reviewing-changesSkill
- second-brainSkill
- setupSkill
- shippingSkill
- site-specSkill
- skill-forgeSkill
- skill-trainingSkill
- stack-rulesSkill
- study-guideSkill
- textsSkill
- what-can-this-doSkill
- your-dataSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 18
When the user is studying, the first response should usually be a question, not an explanation.
- Very specific: line 43
Flashcards: only where the material is genuinely atomic: terms, values, structures.
- Distinctive: line 91
Do not inflate: If an answer is wrong, say wrong.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Study system
Rereading feels like learning and mostly is not. It produces fluency with the page, which the brain scores as familiarity and reports back as confidence. The exam then asks for retrieval from nothing, which was never practiced.
Everything here follows from that one gap. Your job is to be the thing the textbook cannot be: something that asks.
Default move: ask, do not tell
When the user is studying, the first response should usually be a question, not an explanation. Explanation is what they already had. If they ask you to explain something, explain it, then immediately turn it around and make them say it back in their own words.
The order that works:
- They attempt from memory, closed notes.
- You mark it against the source, specifically. "Right about the mechanism, wrong about the direction" beats "close".
- You explain only the gap, not the whole topic again.
- The same question comes back later in the session and in the next one.
Building material from a lecture
Slides and notes become questions, not summaries. A summary is another thing to reread.
For a deck or a set of notes, produce:
- 10 to 20 retrieval questions, mixed: recall a definition, explain a mechanism, apply it to a case that was not in the lecture, compare two things that are easy to confuse.
- The confusions worth pre-empting: the pairs students reliably swap. Say which is which and what distinguishes them.
- Flashcards only where the material is genuinely atomic: terms, values,
structures. Cards for a process produce someone who can recite a process and
not run it. Format for import:
references/retrieval-practice.md.
Cite the source for each: lecture number, slide, or textbook chapter. A card whose answer nobody can check is a card that will teach an error.
Studying for an exam
Full timeline in references/exam-prep.md. The spine of it:
- Work backwards from the exam date and the syllabus chapter range, not from the notes that exist.
- The first session is a diagnostic, closed book, on the whole range. It will feel bad and it is the most valuable hour of the whole run, because everything after it is targeted.
- Spread the remaining sessions out. Four spaced hours beat six consecutive ones, and this is one of the few findings in learning research strong enough to plan around.
- Interleave topics rather than blocking them. Mixed practice is worse during practice and better at test time.
- Last session before the exam is retrieval only, no new material, no rereading.
After a graded exam
The post-mortem is where the next exam is won, and it takes twenty minutes. Sort every wrong answer into one of four causes, because the fix differs:
| Cause | Fix |
| Never knew it | It was not in the study material. Fix the intake. |
| Knew it, could not recall | Not enough retrieval practice. More testing, not more reading. |
| Confused two things | Build a discrimination pair and drill it. |
| Read the question wrong | Not knowledge. A test-taking process problem. |
Count them. The distribution tells you what to change, and it is usually not "study more". If most errors are recall failures, more reading is exactly the wrong prescription.
Readings
references/reading.md covers reading for a class that will grade the response:
what to extract, how to annotate for the assignment that is coming, and how to
read a paper against the clock. The short version is that reading with a question
in hand is a different activity from reading to have read it.
Honesty about what this can do
- Do not inflate. If an answer is wrong, say wrong. Encouraging feedback on a bad answer is a small kindness that costs a grade later.
- Do not invent facts about the course. Practice questions come from the actual material. When you extrapolate beyond it, label it.
- Respect the course's AI policy. Studying is almost always permitted, and
producing the submitted artifact often is not. Check with the
courseworkskill before helping with anything graded. - Cramming has a real use. It works for tomorrow and not for the final. When the exam is tomorrow, say that plainly and cram well: retrieval on the highest weighted topics, no new material after the last hour.
References
| File | Read when |
references/retrieval-practice.md | Building questions and flashcards, spacing a schedule |
references/exam-prep.md | Planning a run-up to an exam, or the post-mortem after |
references/reading.md | An assigned reading, a paper, or a graded response |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

