Skip to content
Back to search

flashcard-maker

MarketplaceWorks with Claude CodeGitHub

A Claude Code skill that turns textbook chapters into flashcards with spaced repetition, spelling practice and pronunciation guides.

Safety scan

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

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hclovecraft00--flashcard-maker/badge.svg)](/listings/hclovecraft00--flashcard-maker)

HTML

<a href="/listings/hclovecraft00--flashcard-maker"><img src="/api/listings/hclovecraft00--flashcard-maker/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. In a terminal:

claude plugin marketplace add hclovecraft00/flashcard-maker
claude plugin install flashcard-maker@flashcard-maker

The first time it runs, Claude installs two small Python libraries, `pypdf` and `wordfreq`, into `~/.cache/flashcard-maker/lib`. This needs an internet connection, and Claude Code asks your permission before running it.

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": "flashcard-maker",
  3. "owner": { "name": "hclovecraft00" },
  4. "plugins": [
  5. {
  6. "name": "flashcard-maker",
  7. "source": "./",
  8. "description": "Turn chapters of a textbook PDF into flashcards with spaced-repetition practice, spelling practice and pronunciation guides."
  9. }
  10. ]
  11. }
README.md · README · 95 lines
  1. # Flashcard Maker
  2. A Claude Code skill that turns chapters of a textbook PDF into a study page: a word list and flashcards with spaced repetition, spelling practice and pronunciation guides.
  3. You give Claude a PDF and say which chapters. It reads them, picks the vocabulary you need to follow the book, writes a plain-English meaning for each word based on how the book uses it, looks up how to say it, and builds one page you can use on a computer or a phone.
  4. ![The practice screen](examples/practice-setup.png)
  5. ## Who it’s for
  6. I made this when I started reading a textbook on starfish with no background in biology. Almost every page had words I didn’t know and there was no way I could follow the chapter until I actually got some grasp of what things mean.
  7. It’s for anyone new to a field who needs to learn its vocabulary quickly, from the book in front of them.
  8. It also suits people who, like me, remember a word by typing it and hearing it. Type it shows you the meaning, you spell the word, and the page says it aloud when you submit.
  9. ## The study page
  10. The page is a single HTML file with two tabs, Words and Practice.
  11. **Words.** Every word, searchable and filtered by chapter, with:
  12. - a pronunciation guide, such as *autotomy* → aw-TOT-uh-mee
  13. - a meaning that follows the book, pitched at how much you already know about the subject (Claude asks)
  14. - Greek or Latin roots where they help you remember it
  15. **Practice.** The same words, two ways:
  16. - **Flip cards:** see the word, recall the meaning, then check.
  17. - **Type it:** read the meaning and spell the word. The page says the word aloud when you submit and underlines any letters you got wrong.
  18. After each card you rate it 1 (hard), 2 (okay) or 3 (easy). Words you find hard come back later in the session and again the next day; words you know wait longer, up to 90 days. You choose how many new words each session brings (5, 10, 20, 30 or all).
  19. If the skill misses a word, add it on the Words tab, or ask Claude to add it. You can also hide words you don’t want to practise. Words you add on the page live in that browser; the Words tab’s “copy my added words” button gives you a list to paste to Claude, which adds them to the page for good.
  20. ![A Type it card after a near miss](examples/practice-card.png)
  21. ## Example cards
  22. From *Starfish: Biology and Ecology of the Asteroidea* (ed. John M. Lawrence), chapters 1–4:
  23. | Word | Say it | Meaning |
  24. |---|---|---|
  25. | ossicles | OS-ih-kulz | The many small hard plates, made of a chalky mineral, that form a starfish’s skeleton and are joined by muscle and tissue. |
  26. | ambulacral | am-byoo-LAY-krul | Describes the paired plates and channel running down the underside of each arm, where the tube feet come out. |
  27. | tube feet | toob FEET | Small, soft, water-filled limbs along the underside groove of each arm, used for gripping and for pulling shellfish open. |
  28. | madreporite | mad-ruh-POR-ite | The sieve-like plate on the top surface of a starfish; its position and the timing of its formation differ between groups. |
  29. | pedicellariae | ped-ih-suh-LAIR-ee-ee | Tiny pincer-like organs on the body surface, used to remove parasites, deter predators and catch prey. |
  30. | phylogeny | fy-LOJ-uh-nee | The evolutionary family tree of a group. It shows which kinds descend from, or are related to, which. |
  31. | brachiolaria | brak-ee-oh-LAIR-ee-uh | A larval stage with three sticky arms at the front used to attach before settling; sand stars lack it. |
  32. | autotomy | aw-TOT-uh-mee | Deliberately dropping a body part, such as an arm, usually at a set breaking point, to escape a predator or damage. |
  33. | Asterias rubens | as-TEER-ee-us ROO-benz | A common northern European starfish whose arm has been studied for its mechanics and for how it breaks off and regrows. |
  34. | spawning | SPAW-ning | Releasing eggs and sperm into the water, usually timed to a particular season or day so that the sex cells can meet. |
  35. ## Install
  36. You need [Claude Code](https://claude.com/claude-code) and Python 3. In a terminal:
  37. ```
  38. claude plugin marketplace add hclovecraft00/flashcard-maker
  39. claude plugin install flashcard-maker@flashcard-maker
  40. ```
  41. The first time it runs, Claude installs two small Python libraries, `pypdf` and `wordfreq`, into `~/.cache/flashcard-maker/lib`. This needs an internet connection, and Claude Code asks your permission before running it.
  42. ## Use
  43. Open Claude Code in the folder with your PDF and ask, for example:
  44. > make flashcards for chapters 1–3 of cell-biology.pdf
  45. Claude asks which chapters, how much you already know about the subject, and whether you want British or American spelling. It then builds the page in a new folder next to the PDF and opens it. You can also start it directly with `/flashcard-maker:flashcard-maker`.
  46. Later you can ask it to add a chapter, add or remove a word, or paste in the list from the page’s “copy my added words” button. Rebuilding the page keeps the practice progress saved in your browser.
  47. ## How it picks the words
  48. 1. It counts every word in each chapter that is rare in everyday English, and every repeated two-word phrase.
  49. 2. One sub-agent per chapter reads the chapter and keeps a term when the chapter uses it 3 or more times, explains it, or relies on it. Names (genus, species, groups) stay when used 4 or more times or when the book features them. Everyday words, people’s names and one-off examples are left out.
  50. 3. Each word belongs to the first chapter that uses it, and each chapter’s words are ordered by how often the chapter uses them, so the most important ones come first.
  51. Meanings follow the book’s own definitions where it gives them. Pronunciations come from [Wiktionary](https://en.wiktionary.org) where it has an entry; the rest are written from standard pronunciation rules and marked “no dictionary entry” on the page.
  52. ## Privacy
  53. The page never contains the book’s text, only the words, their meanings and guides. To look up pronunciations, only the words themselves are sent to Wiktionary. Your progress stays in your browser.
  54. ## Limits
  55. - Progress is saved per device and doesn’t sync between them.
  56. - Scanned PDFs without selectable text can’t be read.
  57. - English-language books only.
  58. - No pictures from the book.
  59. ## Licence
  60. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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