os-taxonomy README

The project's README from github.com/withmarbleapp/os-taxonomy. As one markdown file: README.md.

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,590 · Prerequisite edges: 3,221 · Subjects: 8

See it

The taxonomy as a rotating 3D graph: every dot a micro-topic, colored by subject, wired by prerequisites

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:

Subjects

Subject Topics
Science 547
Mathematics 503
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/manifest.json Counts, per-subject breakdown, per-file checksums.

A topic

{
  "id": "mt_N8CpN1EJrP",
  "type": "CONCEPTUAL",
  "subject": "English",
  "domain": "Grammar & Punctuation",
  "name": "Building sentences",
  "description": "Understand that words combine to make sentences — a sentence expresses a complete thought…",
  "ageRangeStart": 4,
  "ageRangeEnd": 6,
  "centrality": 0.257,
  "evidence": [
    "Distinguish between complete sentences and fragments",
    "Compose a complete sentence with a subject and verb"
  ],
  "assessmentPrompt": "If {{name}} says something like \"The dog\", can they tell you that's not a complete sentence…?",
  "standards": ["ccss-ela:L.K.1f", "uk-nc-2013:Eng.App2.Y1.Sent.1"]
}

A dependency

{ "topicId": "mt__00ZSLnB7p", "prerequisiteId": "mt_VBl1T1sFCM", "strength": "hard",
  "reason": "Must understand vibrations make sound before finding volume patterns" }

topicId depends on prerequisiteId. Reverse the edge to get "unlocks".

Using it

Pure data — no runtime, no dependencies. Load the JSON and go.

import topics from './data/topics.json' with { type: 'json' };
import deps from './data/dependencies.json' with { type: 'json' };

const byId = new Map(topics.topics.map(t => [t.id, t]));
const prereqs = deps.dependencies
  .filter(d => d.topicId === 'mt_N8CpN1EJrP')
  .map(d => byId.get(d.prerequisiteId).name);

Validate structure + referential integrity:

node scripts/validate.mjs

License

This dataset is multi-licensed — read this before you use or redistribute it.

Layer License
The database — the collection, structure, IDs, topic↔topic and topic↔standard relationships ODbL 1.0 — free for research and commercial use, attribution required, share-alike (derivative databases must stay open under ODbL).
The textual content Marble authored — topic description/name/evidence/assessmentPrompt, dependency reasons, cluster summarys CC BY-SA 4.0 — same spirit: attribution + share-alike.
curriculum-standards.json — extracted from third-party frameworks Not Marble's to relicense. Each source is under its own upstream license — see PROVENANCE.md.

Why share-alike + still commercial-friendly: ODbL distinguishes a derivative database (extend/modify the taxonomy → must stay open) from a produced work (use it inside a product, model, or app → stays yours). So you can build a commercial product on this without open-sourcing your product; you only owe back improvements to the taxonomy itself.

Attribution

Any use must credit:

Marble Skill Taxonomy (v1) · © Generative Spark, Inc. (Marble) · https://withmarble.com · licensed under ODbL 1.0 (database) and CC BY-SA 4.0 (content).

Plus the upstream notices in PROVENANCE.md for any curriculum standards you use. See CITATION.cff for a formal citation.

What's not here

Deliberately excluded from this release: semantic embeddings (derived, recomputable) and any per-child / user data (never published). See CHANGELOG.md.

os-taxonomy (withmarbleapp/os-taxonomy)

Searching Database…

4.8K ·GitHub
Os-taxonomy
What is this?Marble Skill Taxonomy is an open dataset mapping what children learn in primary/elementary school, broken into 1,590 fine-grained micro-topics linked by a prerequisite graph and aligned to national curriculum standards like NGSS and Common Core.
Is this a tool I run, or just data files?It's pure data: plain JSON files under data/ plus JSON Schemas under schema/, with no runtime, library, or code to install.
How do I actually use the data?Load the JSON files directly — topics.json, dependencies.json, curriculum-standards.json, clusters.json and manifest.json all live in data/ as UTF-8 JSON — in whatever language or tool you want.
Do I need any libraries to work with it?No — it's plain JSON with no runtime or package dependencies; the included validate.mjs script just needs Node.js if you want to check structure and referential integrity.
What's deliberately left out of the dataset?Marble excludes semantic embeddings, since they're derived and recomputable, and any per-child or user data, which is never published.
Does it contain any personal data about real kids?No — any per-child or user data is deliberately never published in this release.
What are the licensing terms?It's multi-licensed: the database structure, IDs and relationships are ODbL 1.0 (free for research and commercial use, attribution + share-alike), Marble's authored text is CC BY-SA 4.0, and curriculum-standards.json keeps each source's own upstream license.
Can I build a commercial product on this without open-sourcing my product?Yes — ODbL only requires you to share back improvements to the taxonomy database itself (a 'derivative database'); using it inside a product, model, or app (a 'produced work') stays yours.
How are the micro-topics structured?Each topic has an id, a plain-language description, mastery evidence criteria, a type (conceptual / procedural / representational / language / meta), a subject and domain, an approximate age range, and links into curriculum-standards.json.
How can I explore the taxonomy visually?Marble has an interactive explorer at withmarble.com/curriculum where every dot is a micro-topic colored by subject, height represents age, and threads show prerequisites you can trace.
Which curriculum standards is it aligned to?Topics link to source standards including NGSS, Common Core, and the UK National Curriculum, among others.
What are similar projects?ajv, react-jsonschema-form, sqlmodel, pkl, prediction-market-analysis, elosys, big-list-of-naughty-strings, exercises-dataset
Which topics is it in?dag, json-schema, metadata, schema, validation, data, graph, knowledge-graph, dataset, academic-research, json, research
Creator
withmarbleapp
Size
5.5 MB
Stars
4.8K
Updated
CommitJul 08
Age
3mo
Commits · 90 Days