Skip to content
Back to search

padhai

MarketplaceWorks with Claude CodeGitHub

Free exam notes from any syllabus. An open-source agent skill that turns your unit syllabus and past papers into a complete, exam-ready PDF.

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/krishnanaicker--padhai/badge.svg)](/listings/krishnanaicker--padhai)

HTML

<a href="/listings/krishnanaicker--padhai"><img src="/api/listings/krishnanaicker--padhai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

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 · 11 lines
  1. {
  2. "name": "padhai",
  3. "owner": { "name": "Krishna Naicker", "url": "https://github.com/KrishnaNaicker" },
  4. "plugins": [
  5. {
  6. "name": "padhai",
  7. "source": "./",
  8. "description": "Exam-ready master-solution notes (PDF) from any university syllabus, with optional previous-year questions."
  9. }
  10. ]
  11. }
README.md · README · 152 lines
  1. # Padhai (पढ़ाई)
  2. **Give it your syllabus. Get back exam-ready notes.**
  3. [![skills.sh installs](https://skills.sh/b/KrishnaNaicker/padhai)](https://skills.sh/KrishnaNaicker/padhai)
  4. *Padhai* means "studies", the word every Indian student hears every day. Padhai turns your syllabus into the notes you wish you had: complete, exam-ready, and free for every student.
  5. Padhai is an open-source **Agent Skill**. You give an AI agent (Claude Code, Codex, Gemini CLI, Copilot, Cursor and others) your unit's syllabus, plus previous-year questions if you have them. It writes a **master-solution PDF**: every likely exam question with a full answer, written the way a topper writes it in the exam.
  6. ![Four pages from a Padhai sample: the question index, a confusion-matrix numerical, a KNN numerical and an SVM answer](samples/preview.png)
  7. 📄 **See a real output:** [`samples/ML_Unit3_Classification.pdf`](samples/ML_Unit3_Classification.pdf) (Machine Learning, Unit III, 30 pages)
  8. ---
  9. ## Start here: copy, paste, done
  10. Open any AI agent that can run commands (Claude Code, Codex, Gemini CLI, OpenCode, Cursor, Copilot, or any other) and paste this prompt. It sets everything up, checks that it works, and then asks you for your syllabus.
  11. ```text
  12. Set up Padhai (https://github.com/KrishnaNaicker/padhai), a free skill that makes exam notes, then use it to make my notes.
  13. 1. Install it as a skill: npx skills add KrishnaNaicker/padhai
  14. If that is not possible here, run: git clone https://github.com/KrishnaNaicker/padhai
  15. From now on, "the skill" means the skills/padhai folder, wherever it ended up.
  16. 2. Install the Python packages it needs: beautifulsoup4 matplotlib numpy pillow pypdf
  17. (use pip, a virtual environment, or whatever works on this system).
  18. 3. If Node.js is installed, run "npm install katex" inside the skill's scripts folder.
  19. 4. Check for Chrome, Edge, Chromium or Brave. If none is installed, tell me the notes will come as an HTML file I can print to PDF.
  20. 5. Test it: build the example in the skill's examples/ml-unit3-classification folder with scripts/build.py and confirm the notes file is created. Fix any setup problem you hit.
  21. 6. Read the skill's SKILL.md fully.
  22. 7. Tell me setup is done. Then ask me for the syllabus of the unit I want notes for, plus previous-year questions if I have them. Wait for my reply.
  23. 8. When I send them, follow SKILL.md exactly and give me the PDF.
  24. ```
  25. That's it. Setup runs once. Next time, just type `/padhai` (or say *"make notes with padhai"*) and paste your syllabus.
  26. ## Is it safe?
  27. Yes. Padhai is plain instructions plus a few small Python scripts that build your PDF. It doesn't need an account, doesn't collect your data, and doesn't send your notes anywhere. Everything is open here, so you can read every line.
  28. If your installer shows a security warning: automated scanners are strict with skills that use web search or add a credit line to the output. Padhai does both (to check facts, and to add the free-notes footer). A fresh scan of the latest version has been requested.
  29. ## What you get
  30. - **Every syllabus topic covered.** Previous-year questions (PYQs) are answered first. Any topic no paper has asked yet gets an **Expected** question, phrased the way your examiners phrase them.
  31. - **No duplicate PYQs.** A question asked in three papers appears once, tagged with all three dates, so you know it's important.
  32. - **Answer length follows marks.** A 2-mark answer is a few lines; an 8-mark answer is about 2 pages. Definitions, step-by-step points, diagrams, examples, comparison tables, advantages and limitations, and a conclusion.
  33. - **Numericals worked step by step**: given → formula → substitution → result table → interpretation. Every number is computed in code, not guessed.
  34. - **Clean diagrams** for processes, architectures, graphs and curves.
  35. - **Rapid Revision Sheet** at the end: every formula, key one-liners, "if they ask X, write Y", and every numerical answer.
  36. - **Marked as free, on every page.** Each PDF has a small footer on every page and a first-page notice with a QR code saying the notes are free and where to get Padhai, so nobody can quietly sell them to students who don't know.
  37. - **A plain exam format**: black, grey and white with a serif font, bordered question/answer boxes and tables with Sr. No. columns. It looks like a topper's notebook, not a webpage.
  38. Works for **any university, board or autonomous college**: SPPU, Mumbai University, VTU, AKTU, Anna University, GTU, RGPV, JNTU, and the rest.
  39. ## What to give
  40. | | |
  41. |---|---|
  42. | **Required** | Subject, unit name, and the **syllabus** of the unit: typed, or a screenshot or photo of it |
  43. | Optional | Previous-year questions: typed, screenshots, or full papers (say which question numbers belong to the unit) |
  44. | Optional | University, course, semester, marks per question |
  45. > A unit name on its own isn't enough. "Unit 3 Normalization" covers different topics at different universities, so Padhai asks for the syllabus first. If you don't have it, Padhai drafts a topic list and waits for you to confirm it.
  46. **One unit per run, one PDF per unit.**
  47. ## How it works
  48. 1. **Collect** the syllabus and any PYQs, and ask once for anything missing.
  49. 2. **Plan**: list every syllabus topic, pull out the PYQs, merge duplicates, and add Expected questions for uncovered topics.
  50. 3. **Verify**: compute every number in code; look up facts that change over time.
  51. 4. **Draw** the figures, then check every one visually for overlapping labels.
  52. 5. **Write** each answer to fit its marks.
  53. 6. **Build** the PDF, then check every page visually and fix any problems.
  54. The full method is in [`skills/padhai/SKILL.md`](skills/padhai/SKILL.md) and [`skills/padhai/references/`](skills/padhai/references/).
  55. ## Free, forever
  56. Padhai is built so that no student has to pay for good notes. Every PDF it makes says so:
  57. - a footer on every page: *Free notes · made with Padhai · github.com/KrishnaNaicker/padhai · If you paid for this, you were scammed.*
  58. - a notice on the first page with a QR code to this repo;
  59. - tags inside the PDF file.
  60. The code is MIT licensed, so we can't legally stop anyone from selling copies. We're asking you not to. **If someone sold you notes made with Padhai, you can make your own for free right here.** Share the repo so more students know.
  61. ## Please read
  62. - **Padhai is a study aid. Check it against your textbook and your teacher's notes.** AI can make mistakes. Padhai is built to reduce them (computed numericals, fact checks, visual checks), but it can't remove them completely.
  63. - **Quality depends on the model.** A strong model with code execution gives notes like the sample. Smaller models give weaker notes.
  64. - Subjects that need hand-drawn engineering drawings or detailed circuit schematics are only partly supported.
  65. - Keep it free. If Padhai helped you, share it with someone who can't afford guidebooks.
  66. ## Other ways to install
  67. **Any agent that supports skills** (Claude Code, Codex, Gemini CLI, GitHub Copilot, Cursor, and more):
  68. ```bash
  69. npx skills add KrishnaNaicker/padhai
  70. ```
  71. **Claude Code as a plugin:**
  72. ```
  73. /plugin marketplace add KrishnaNaicker/padhai
  74. /plugin install padhai@padhai
  75. ```
  76. **Manual:** copy the `skills/padhai` folder into your agent's skills folder:
  77. | Agent | Folder |
  78. |---|---|
  79. | Claude Code | `~/.claude/skills/` (all projects) or `.claude/skills/` (one project) |
  80. | OpenAI Codex | `~/.codex/skills/` or `.agents/skills/` |
  81. | Gemini CLI | `~/.gemini/skills/` or `.agents/skills/` |
  82. | GitHub Copilot | `.github/skills/` |
  83. | Cursor | `.cursor/skills/` |
  84. **Chat apps that accept skill uploads** (e.g. Claude.ai): zip the `skills/padhai` folder and upload it as a skill.
  85. **No skill support at all?** Paste the contents of `skills/padhai/SKILL.md` into the chat first, then give your syllabus. You'll get the same method, as Markdown notes.
  86. ### Requirements (for the PDF)
  87. ```bash
  88. pip install beautifulsoup4 matplotlib numpy pillow
  89. ```
  90. - Any **Chrome, Edge, Chromium or Brave** browser installed (used to print the PDF).
  91. - Optional: Node.js and `npm install katex` inside `skills/padhai/scripts`, so maths renders offline. Without it, maths is rendered from a CDN, so you need internet when building.
  92. - No browser? You still get an HTML file. Open it, press **Ctrl+P**, choose **Save as PDF**, and tick **Background graphics**.
  93. The prompt in **Start here** does all of this for you.
  94. ## Contributing
  95. Pull requests are welcome. The most useful contributions:
  96. - **Sample units** for other universities and subjects, so the agent has more examples to learn from.
  97. - Better figure helpers for specific subjects (circuits, ER diagrams, timing diagrams).
  98. - Install notes for more agents.
  99. Open an issue before large changes.
  100. ## Credits
  101. Created by [Krishna Naicker](https://github.com/KrishnaNaicker), built with Claude. The format comes from real end-semester notes that friends compared side by side against paid guidebooks.
  102. MIT licensed. Free for every student, forever.

Ratings and comments

Sign in to rate this skill.

Sign in

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