julioarguello/alfabeta

Claude skills so a secondary-school student can study with AI, and their family can help without
losing the afternoon.
alfabeta organises what a student needs for each topic into one folder per topic in the family's
cloud storage, and builds one Gemini Notebook (formerly NotebookLM)
per topic to study from. The skills run in the Claude desktop app. The one that
run are the Science Bits textbook capture and the study pack; the
Google Classroom sync, the use of the student's own class notes and
the calendar are designed in epic #1
and in About preparing study material in advance.
If you are a family that wants to use it, read What it does and then
Get started. If you want to understand or change how study material is chosen and
generated, go to About preparing study material in advance.
If you want to contribute code, start from the specification
and the constitution.
| Section | You are… |
| What it does | deciding whether this is for you |
| How it fits together | wondering where each file and notebook comes from |
| Get started | ready to capture your first topic |
| Ground rules | worried about privacy, exams or the platforms' terms |
| Documentation | looking for something that is not on this page |
## What it does
| Component | Where it is | What it does |
| sciencebits-a-notebooklm | Skill in skills/sciencebits-a-notebooklm/ | Captures a Science Bits topic screen by screen, builds a navigable PDF and a Markdown file per language (Spanish, Basque, English), files them by school year, subject and topic, and creates the topic's notebook. |
| classroom-sync | Specification in specs/001-classroom-sync/; implementation tracked in epic #1 | Is designed to copy the teacher's material from Classroom into the same topic folders, read-only, and keep an agenda of assignments and exams. |
| study-pack | Skill in skills/study-pack/; the reasons in About preparing study material in advance | Prepares a few pieces per finished topic inside its notebook — short explainer videos, practice, quiz and flashcards in the exam's language — prints a glossary and a guide with a recomputed answer key for the parent, and prints the whole topic as one A4 PDF. |
| Calendar | Design in the roadmap | One calendar per student, holding only objective facts from Classroom — assignments, exams, posted material — never study blocks. |
## How it fits together
Target layout, from specification 001 and the
study-pack design. The Science Bits skill writes its files
straight into the topic folder.
class notes (photos) ─┐
Google Classroom ─────┼──► / /YYYYMMDD - Tema NN - / ──► one notebook per topic ──► each listed account
Science Bits ─────────┘ {apuntes, classroom, sciencebits} (shared as viewer)
├──► one-way mirrors in the student's other accounts' Drives
└──► calendar: assignments, exams, posted material ──► each listed account
Every topic folder starts with the date the teacher posted its first material, so the student sees
each topic in time. A teacher's topic that is not in the textbook carries the teacher's title
instead of Tema NN - , and what Classroom posts with no topic goes in YYYYMMDD - Sin tema.
Each Classroom file inside classroom/ starts with its own posting date, YYYYMMDD - .