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…

5.1K ·GitHub
Os-taxonomy
Что это такое?Marble Skill Taxonomy — открытый набор данных, описывающий, чему дети учатся в начальной школе: он разбит на 1 590 мелких микротем, связанных графом предпосылок и привязанных к национальным учебным стандартам вроде NGSS и Common Core.
Это инструмент, который я запускаю, или просто файлы с данными?Это чистые данные: обычные JSON-файлы в data/ плюс JSON-схемы в schema/ — без среды выполнения, библиотек или кода для установки.
Как на практике использовать эти данные?Загружайте JSON-файлы напрямую — topics.json, dependencies.json, curriculum-standards.json, clusters.json и manifest.json лежат в data/ в виде UTF-8 JSON — на любом языке или в любом инструменте по вашему выбору.
Нужны ли какие-то библиотеки для работы с ним?Нет — это обычный JSON без зависимостей от среды выполнения или пакетов; входящему скрипту validate.mjs нужен только Node.js, если хотите проверить структуру и ссылочную целостность.
Что сознательно не включено в набор данных?Marble исключает семантические эмбеддинги, поскольку они производны и вычислимы заново, а также любые данные по отдельным детям или пользователям — такие данные никогда не публикуются.
Есть ли там персональные данные реальных детей?Нет — любые данные по отдельным детям или пользователям в этом релизе сознательно никогда не публикуются.
Каковы условия лицензирования?Лицензий несколько: структура базы данных, идентификаторы и связи — под ODbL 1.0 (свободно для исследований и коммерческого использования, с указанием авторства и share-alike), авторский текст Marble — под CC BY-SA 4.0, а curriculum-standards.json сохраняет собственную исходную лицензию каждого источника.
Можно ли построить на этом коммерческий продукт, не открывая код своего продукта?Да — ODbL требует лишь поделиться улучшениями самой базы таксономии («производной базы данных»); использование внутри продукта, модели или приложения («произведённого произведения») остаётся вашим.
Как устроены микротемы?У каждой темы есть id, описание простым языком, критерии подтверждения освоения, тип (conceptual / procedural / representational / language / meta), предмет и область, примерный возрастной диапазон и ссылки в curriculum-standards.json.
Как визуально изучить таксономию?У Marble есть интерактивный обозреватель на withmarble.com/curriculum, где каждая точка — микротема, окрашенная по предмету, высота означает возраст, а нити показывают предпосылки, которые можно проследить.
С какими учебными стандартами он согласован?Темы ссылаются на исходные стандарты, включая NGSS, Common Core и Национальную учебную программу Великобритании, среди прочих.
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
5.1K
Updated
CommitJul 08
Age
3mo
Commits · 90 Days