Skip to content
Back to search

learn-everything

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/diegorecover8--learn-everything/badge.svg)](/listings/diegorecover8--learn-everything)

HTML

<a href="/listings/diegorecover8--learn-everything"><img src="/api/listings/diegorecover8--learn-everything/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need [Claude Code](https://claude.com/claude-code) and Python 3.8 or newer (already installed on macOS and most Linux systems). Nothing else.

claude plugin marketplace add DiegoRecover8/learn-everything
claude plugin install learn@learn-everything

Restart Claude Code and type `/learn`.

To try it without installing, clone the repository and start Claude Code with `claude --plugin-dir /path/to/learn-everything`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 36 lines
  1. {
  2. "name": "learn-everything",
  3. "owner": {
  4. "name": "DiegoRecover8"
  5. },
  6. "metadata": {
  7. "description": "Single-plugin marketplace hosting Learn Everything, an exam study companion for Claude Code.",
  8. "version": "0.2.3"
  9. },
  10. "plugins": [
  11. {
  12. "name": "learn",
  13. "source": "./",
  14. "description": "Learn Everything: study for any exam from your own materials. Roadmap, daily plan, quizzes, mock exams, streaks, achievements and a local dashboard. Run /learn.",
  15. "category": "education",
  16. "tags": [
  17. "education",
  18. "exam-preparation",
  19. "study",
  20. "ai-tutor",
  21. "spaced-repetition",
  22. "flashcards",
  23. "quiz",
  24. "gamification"
  25. ],
  26. "homepage": "https://github.com/DiegoRecover8/learn-everything",
  27. "repository": "https://github.com/DiegoRecover8/learn-everything",
  28. "license": "MIT",
  29. "author": {
  30. "name": "DiegoRecover8",
  31. "url": "https://github.com/DiegoRecover8"
  32. },
  33. "version": "0.2.3"
  34. }
  35. ]
  36. }
README.md · README · 213 lines
  1. <div align="center">
  2. <img src="docs/banner.png" alt="Learn Everything — Your notes. Your roadmap. Your exam." width="100%">
  3. **Turn your own notes into an exam plan, a personal tutor and a daily habit.**
  4. A plugin for [Claude Code](https://claude.com/claude-code)
  5. [![Version](https://img.shields.io/badge/version-0.2.3-2a78d6)](CHANGELOG.md)
  6. [![License: MIT](https://img.shields.io/badge/license-MIT-0ca30c)](LICENSE)
  7. [![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-3776ab)](https://www.python.org/)
  8. [![Tests](https://github.com/DiegoRecover8/learn-everything/actions/workflows/tests.yml/badge.svg)](https://github.com/DiegoRecover8/learn-everything/actions/workflows/tests.yml)
  9. 🇬🇧 **English** · 🇪🇸 [Español](README.es.md)
  10. </div>
  11. ---
  12. You give it your PDFs, slides, Word files and photos of your notes **once**. It builds a roadmap of everything that goes into the exam, plans every day until exam day, explains each topic from your own materials, quizzes you, brings questions back right before you would forget them, and keeps you going with streaks, XP and achievements, Duolingo style.
  13. https://github.com/user-attachments/assets/e3641ba7-4212-4db5-afcc-65499a3eeaa2
  14. ## ✨ Features
  15. | | |
  16. |---|---|
  17. | 📄 **Reads your materials once** | PDF, Word, PowerPoint, Jupyter notebooks, photos, text. Each file becomes faithful study notes and is recognised by its content, so it is never read twice. |
  18. | 🗺️ **Roadmap and content map** | Units and topics with their key concepts, weighted by how much each one counts in the exam. |
  19. | 📅 **A plan up to exam day** | Topics per day from your exam date and your daily minutes. The last days are kept for revision, and a missed day is re-planned automatically. The date is optional. |
  20. | 🧑‍🏫 **Explains, then tests** | Short interactive explanations taken from your notes, then multiple choice, true or false, fill the gap, short answer, open questions, ordering and matching. |
  21. | 🔁 **Spaced repetition** | SM-2 brings each question back at the right moment, and always before the exam. |
  22. | 🎯 **Review what you choose** | A topic, a whole unit, everything from one PDF, or your weakest topics, whenever you want. Also from a button on each topic of the dashboard. |
  23. | 📝 **Mock exams** | No feedback until the end, then a mark and a breakdown by topic. |
  24. | 🔥 **Streaks, XP, levels, 16 achievements** | Plus streak freezes, so one bad day does not wipe out your streak. |
  25. | 📊 **Dashboard** | One local HTML page: countdown, content map, roadmap, strong and weak topics, activity, accuracy and reviews ahead. Light and dark mode. |
  26. | 👋 **A recap every time you come back** | What you covered last time, where you are strong, what to work on, and today's plan. |
  27. | 📚 **Several exams at once** | Each subject keeps its own roadmap, questions and dashboard; `/learn` asks which one to study. Your streak and XP are shared. |
  28. | 🌍 **Any language** | Study in your own language. The dashboard and the status lines come in English, Spanish, French, German, Italian and Portuguese. |
  29. | 🔒 **Private** | Everything stays on your computer as plain files. |
  30. ## 🚀 Install
  31. You need [Claude Code](https://claude.com/claude-code) and Python 3.8 or newer (already installed on macOS and most Linux systems). Nothing else.
  32. ```bash
  33. claude plugin marketplace add DiegoRecover8/learn-everything
  34. claude plugin install learn@learn-everything
  35. ```
  36. Restart Claude Code and type `/learn`.
  37. To try it without installing, clone the repository and start Claude Code with `claude --plugin-dir /path/to/learn-everything`.
  38. ## ⚡ Quick start
  39. ```
  40. /learn:setup answer a few clickable questions: language, name, level, exam, date, daily time
  41. /learn:add drag your files or a folder into the window, or let it find recent files for you
  42. /learn today's session
  43. ```
  44. After that, `/learn` once a day is all you need. Every time you open Claude Code you see where you stand:
  45. ```
  46. [Learn Everything] 📚 Physics II — 24 days to the exam
  47. [Learn Everything] 🔥 Streak: 8 days · ⭐ Level 8 (3543 XP)
  48. [Learn Everything] 🗺️ Progress: 11/15 topics studied · 3 mastered
  49. [Learn Everything] 📖 Last session (yesterday): Gauss's law · 8/10 correct
  50. [Learn Everything] 💪 Strong: Coulomb's law · 🎯 To improve: Electric potential
  51. [Learn Everything] 📅 Today: 14 reviews + 1 new topic — run /learn
  52. [Learn Everything] 📚 Also: History of Art (12 days)
  53. ```
  54. ## 🧭 Commands
  55. Type `/learn` and Claude Code lists them all.
  56. | Command | What it does |
  57. |---|---|
  58. | `/learn` | Asks which exam and what to do, then runs today's session (or setup, or materials, if missing) |
  59. | `/learn:setup` | Create an exam, or change the date, daily time, language or level |
  60. | `/learn:add` | Load materials and build or extend the roadmap |
  61. | `/learn:review` | Review a topic, a unit, a document or your weakest topics: `/learn:review gauss` |
  62. | `/learn:exam` | Mock exam |
  63. | `/learn:dashboard` | Build and open the dashboards (one per exam, with a switcher) |
  64. | `/learn:data` | Switch exams, back up, export, restore, delete |
  65. You can also just say it: "test me on unit 2", "I have new slides", "how am I doing?".
  66. ## 📎 Adding your materials
  67. No need to type paths:
  68. - **Drag and drop** a file or a whole folder into the Claude Code window; its path is pasted for you.
  69. - **Let it look**: `/learn:add` can list your recent PDFs, Word files, slides and images from Downloads, Desktop and Documents, and you pick them by number.
  70. - **Paste** photos of your notes (Ctrl+V) or text straight into the chat.
  71. | Type | Notes |
  72. |---|---|
  73. | PDF | Text read page by page with nothing to install; pages with figures and scanned pages are turned into images for Claude to look at |
  74. | DOCX, PPTX | Text, tables, speaker notes and embedded images |
  75. | IPYNB | Jupyter notebooks: explanations, code, outputs and plots |
  76. | RTF | Rich text |
  77. | JPG, PNG, WEBP, GIF | Photos of notes, whiteboards, textbook pages |
  78. | TXT, MD, CSV | Read as they are |
  79. Claude reads scans and photos itself, so no OCR tool is needed. The first read takes a few minutes for long documents; it happens only once.
  80. ## ⚙️ How it works
  81. **A session** has three parts: review the questions due today, learn the next topic on the roadmap, and practise it with new questions. It starts with a short recap and ends with your score, the XP you earned, your streak and what comes tomorrow.
  82. **The plan.** With an exam date, the topics left are spread over the days left, keeping about the last fifth (at least two days) for revision and mock exams. Without a date, it goes at a steady pace based on your daily minutes. If the plan needs more per day than your time allows, it tells you.
  83. **Reviews.** Each answer is graded from 0 to 5. A good answer pushes the question further away (1 day, 6 days, then longer each time); a bad one brings it back tomorrow. As the exam gets close, intervals are shortened so every question is seen again in time.
  84. **Topic status** goes from not started to learning, reviewing and mastered, according to how you answer its questions. It can go down again if you start failing them.
  85. **Streak.** A day counts when you record at least one session. Every 7 days in a row you earn a streak freeze (up to 2), which covers one missed day automatically.
  86. **XP.** Up to 10 per correct answer, 2 for a wrong one, 20 per topic studied, 30 for meeting the daily goal, 50 per mock exam.
  87. **Light on tokens.** Your materials are read once and turned into notes. Each session then reads only the pages of the topic it is teaching, and the plugin's extra commands cost nothing until you use them.
  88. **Who does what.** Claude teaches and grades; a small Python script does all the bookkeeping and arithmetic, so streaks, schedules and achievements are always computed the same way.
  89. ## 🔒 Your data
  90. Everything is stored as plain files in `~/learn-everything/` (set `LEARN_EVERYTHING_HOME` to use another folder):
  91. ```
  92. profile.json you: XP, level, streak, achievements, shared by all your exams
  93. <exam>/ one folder per exam or subject, independent of the others
  94. exam.json settings and roadmap
  95. cards.json questions and their review schedule
  96. log.jsonl one line per session
  97. sources/ study notes made from your materials
  98. dashboard.html this exam's dashboard
  99. ```
  100. - Your original files are never modified or copied; only the notes made from them are kept.
  101. - A backup is taken before every change (the last 10 are kept in `.backups/`).
  102. - `/learn:data` exports an exam to a zip, restores it on another computer, or deletes it. Deleted exams go to `.trash/`, so a mistake can be undone.
  103. - To remove everything, delete the `~/learn-everything/` folder.
  104. ## ❓ FAQ
  105. <details>
  106. <summary><b>Where does it work?</b></summary>
  107. In Claude Code: the terminal, the desktop app and the IDE extensions. It needs Python on the same computer and a folder to keep your progress, so it does not run in the regular claude.ai chat. Cowork supports plugins, but this one has not been tested there yet.
  108. </details>
  109. <details>
  110. <summary><b>Do I need to know how to code?</b></summary>
  111. No. You talk to Claude in plain words and answer questions by clicking options. Claude runs everything for you: it reads your files, keeps your progress and opens the dashboard. The only thing you type in a terminal is the two install commands above, once.
  112. </details>
  113. <details>
  114. <summary><b>Can I prepare several exams at once?</b></summary>
  115. Yes. Each exam has its own folder, roadmap, questions, plan and dashboard; XP, streak and achievements are shared. `/learn` asks which exam you want to study, the dashboards link to each other, and you can even study two subjects at the same time in two Claude Code windows.
  116. </details>
  117. <details>
  118. <summary><b>I updated from 0.1 and the commands changed.</b></summary>
  119. From 0.2.0 the plugin is called `learn`, so its commands are `/learn:setup`, `/learn:add` and so on. Reinstall it once:
  120. ```bash
  121. claude plugin uninstall learn-everything@learn-everything
  122. claude plugin marketplace update learn-everything
  123. claude plugin install learn@learn-everything
  124. ```
  125. Your study data is not touched.
  126. </details>
  127. <details>
  128. <summary><b>How much does it cost in usage?</b></summary>
  129. Reading long materials the first time is the expensive part, and it happens once per file. Daily sessions read only the notes of the topic being studied and the questions due today.
  130. </details>
  131. ## 🤝 Contributing
  132. Contributions are welcome, especially **new languages** (one JSON file in [`scripts/i18n/`](scripts/i18n)), bug reports and ideas. Read [CONTRIBUTING.md](CONTRIBUTING.md) to get started; everyone taking part follows the [Code of Conduct](CODE_OF_CONDUCT.md). Security problems go through [SECURITY.md](SECURITY.md).
  133. ## 📁 Project layout
  134. ```
  135. .claude-plugin/ plugin and marketplace manifests
  136. skills/learn/ /learn: the daily session, plus the guides for teaching and exercises
  137. skills/<action>/ /learn:setup, /learn:add, /learn:review, /learn:exam, /learn:dashboard, /learn:data
  138. scripts/le.py the data engine (Python standard library only)
  139. scripts/i18n/ translations of the dashboard and status lines
  140. scripts/dashboard_template.html
  141. hooks/hooks.json the status lines shown when Claude Code starts
  142. tests/test_le.py python3 -m unittest discover -s tests
  143. ```
  144. ## 🙏 Credits
  145. Learn Everything builds on ideas from two MIT-licensed projects:
  146. - [learn-anything](https://github.com/ChenChenyaqi/learn-anything) by ChenChenyaqi: the knowledge map, the structure of explanations and the question types.
  147. - [Fluent](https://github.com/m98/fluent) by m98: the Claude Code plugin shape, the session-start status, the streak and SM-2 spaced repetition.
  148. ## 📄 License
  149. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.