withmarbleapp / os-taxonomy

# Marble Skill Taxonomy
An open, structured taxonomy of **what children learn** across the primary/elementary years — decomposed into fine-grained "micro-topics", wired into a prerequisite graph, and aligned to national curriculum standards. Produced by Marble.
> **Version:** `v1` · **Topics:** 1,616 · **Prerequisite edges:** 3,317 · **Subjects:** 8
## See it
Every dot is a micro-topic, colored by subject; height is age; each thread is a prerequisite (full-quality video). Explore it interactively at withmarble.com/curriculum — tap any concept to trace everything a learner must master before it.
## What this is
Most curriculum data is either a flat list of standards or locked inside a product. This dataset is a **connected graph of learning**:
- **1,616 micro-topics** — a single, teachable idea (e.g. *"Building sentences"*, *"Apparent brightness of stars"*), each with a plain-language description, mastery **evidence** criteria, a type (conceptual / procedural / representational / language / meta), a subject + domain, and an approximate age range.
- **3,317 prerequisite dependencies** — a directed acyclic graph: *"topic X depends on prerequisite Y"*, each edge tagged `hard`/`soft` and carrying a one-line **reason**.
- **Curriculum alignment** — each micro-topic links to the standards it was distilled from (NGSS, Common Core, the UK National Curriculum, and more).
- **Teaching research** — 1,049 records covering Science and Mathematics topics: teaching approaches, concrete learning activities, feedback, assessment guidance and linked sources. Coverage is partial; the other 567 topics have no research in this release.
- **Domain clusters** — 176 parent-friendly one-paragraph summaries per (subject, domain, age band).
### Subjects
| Subject | Topics |
|---|---:|
| Science | 547 |
| Mathematics | 529 |
| English | 286 |
| History | 90 |
| Personal & Social Development | 88 |
| Life Skills | 37 |
| Computing | 21 |
| Learning to Learn | 18 |
## Files
All data lives in `data/` as UTF-8 JSON. See `schema/` for JSON Schemas and `manifest.json` for counts + SHA-256 checksums.
| File | What it holds |
|---|---|
| `data/topics.json` | The micro-topics (graph **nodes**). |
| `data/dependencies.json` | Prerequisite **edges** (`topicId` depends on `prerequisiteId`). |
| `data/curriculum-standards.json` | The source curriculum standards, grouped by curriculum. |
| `data/clusters.json` | Parent-friendly domain summaries. |
| `data/teaching-research.json` | Teaching research joined by `topicId`, with explicit coverage and publication notes (~24 MB). |
| `data/archived-teaching-research.json` | Historical guidance for merged or refocused topics, with original records and current topic associations. |
| `data/manifest.json` | Counts, per-subject breakdown, per-file checksums. |
The standards catalogue includes **620 Australian Curriculum v9 Foundation–Year 6
content descriptions** (`acara-v9`), bringing it to **8 sources / 3,881 standards**.
Australian coverage inclu