withmarbleapp/os-taxonomyPublic

AI summary: An open, graph-based taxonomy mapping primary education skills and prerequisites for curriculum development.

Stars
7.8K
+78 today
Forks
1.3K
Watchers
45
Open issues
7
Open PRs
6
Contributors
~5
Commits
215
Branches
181
Views (30d)
6

HTMLODbL-1.0Created Jul 8, 2026Last push 1d ago+104 stars this week+919 this month

Quick answers

What is os-taxonomy?
An open, graph-based taxonomy mapping primary education skills and prerequisites for curriculum development.
What does os-taxonomy do?
Marble Skill Taxonomy is an open-source, structured dataset that decomposes primary and elementary education into a connected graph of learning. Instead of providing a flat list of standards, it breaks down education into 1,590 fine-grained micro-topics, each wired together by over 3,200 prerequisite dependencies. Each topic includes mastery criteria, plain-language descriptions, and direct alignments to national curriculum standards like Common Core and NGSS. This directed acyclic graph allows educators and developers to programmatically trace the exact learning path a student must master before grasping complex concepts.
Who is os-taxonomy for?
This dataset is built for EdTech developers, curriculum designers, and educational researchers looking to build adaptive learning systems or analyze educational pathways. It requires familiarity with JSON or graph data structures to implement programmatically.
How do I get started with os-taxonomy?
https://withmarble.com/curriculum
How popular is os-taxonomy on GitHub?
withmarbleapp/os-taxonomy has 7,792 stars and 1,265 forks on GitHub, and gained 104 stars in the last 7 days.
What license does os-taxonomy use?
withmarbleapp/os-taxonomy is released under the ODbL-1.0 license.

Star history

since Jul 29, 2026
02K4K6KJul 2026Sep 2026Oct 2026Nov 2026
7.8K stars as of Nov 20, 2026. Measured daily since Jul 29, 2026; GitHub no longer exposes earlier star timestamps.

Update history

1 recorded
  • Nov 20, 2026Primary language changed from JavaScript to HTML.

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 0 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 0 commits2026-01-28: 0 commits2026-01-29: 0 commits2026-01-30: 0 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 0 commits2026-02-03: 0 commits2026-02-04: 0 commits2026-02-05: 0 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 0 commits2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 0 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 0 commits2026-03-05: 0 commits2026-03-06: 0 commits2026-03-07: 0 commits2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 0 commits2026-03-12: 0 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 0 commits2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 0 commits2026-03-19: 0 commits2026-03-20: 0 commits2026-03-21: 0 commits2026-03-22: 0 commits2026-03-23: 0 commits2026-03-24: 0 commits2026-03-25: 0 commits2026-03-26: 0 commits2026-03-27: 0 commits2026-03-28: 0 commits2026-03-29: 0 commits2026-03-30: 0 commits2026-03-31: 0 commits2026-04-01: 0 commits2026-04-02: 0 commits2026-04-03: 0 commits2026-04-04: 0 commits2026-04-05: 0 commits2026-04-06: 0 commits2026-04-07: 0 commits2026-04-08: 0 commits2026-04-09: 0 commits2026-04-10: 0 commits2026-04-11: 0 commits2026-04-12: 0 commits2026-04-13: 0 commits2026-04-14: 0 commits2026-04-15: 0 commits2026-04-16: 0 commits2026-04-17: 0 commits2026-04-18: 0 commits2026-04-19: 0 commits2026-04-20: 0 commits2026-04-21: 0 commits2026-04-22: 0 commits2026-04-23: 0 commits2026-04-24: 0 commits2026-04-25: 0 commits2026-04-26: 0 commits2026-04-27: 0 commits2026-04-28: 0 commits2026-04-29: 0 commits2026-04-30: 0 commits2026-05-01: 0 commits2026-05-02: 0 commits2026-05-03: 0 commits2026-05-04: 0 commits2026-05-05: 0 commits2026-05-06: 0 commits2026-05-07: 0 commits2026-05-08: 0 commits2026-05-09: 0 commits2026-05-10: 0 commits2026-05-11: 0 commits2026-05-12: 0 commits2026-05-13: 0 commits2026-05-14: 0 commits2026-05-15: 0 commits2026-05-16: 0 commits2026-05-17: 0 commits2026-05-18: 0 commits2026-05-19: 0 commits2026-05-20: 0 commits2026-05-21: 0 commits2026-05-22: 0 commits2026-05-23: 0 commits2026-05-24: 0 commits2026-05-25: 0 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 0 commits2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 0 commits2026-06-01: 0 commits2026-06-02: 0 commits2026-06-03: 0 commits2026-06-04: 0 commits2026-06-05: 0 commits2026-06-06: 0 commits2026-06-07: 0 commits2026-06-08: 0 commits2026-06-09: 0 commits2026-06-10: 0 commits2026-06-11: 0 commits2026-06-12: 0 commits2026-06-13: 0 commits2026-06-14: 0 commits2026-06-15: 0 commits2026-06-16: 0 commits2026-06-17: 0 commits2026-06-18: 0 commits2026-06-19: 0 commits2026-06-20: 0 commits2026-06-21: 0 commits2026-06-22: 0 commits2026-06-23: 0 commits2026-06-24: 0 commits2026-06-25: 0 commits2026-06-26: 0 commits2026-06-27: 0 commits2026-06-28: 0 commits2026-06-29: 0 commits2026-06-30: 0 commits2026-07-01: 0 commits2026-07-02: 0 commits2026-07-03: 0 commits2026-07-04: 0 commits2026-07-05: 0 commits2026-07-06: 0 commits2026-07-07: 0 commits2026-07-08: 6 commits2026-07-09: 0 commits2026-07-10: 1 commit2026-07-11: 0 commits2026-07-12: 0 commits2026-07-13: 0 commits2026-07-14: 0 commits2026-07-15: 0 commits2026-07-16: 0 commits2026-07-17: 0 commits2026-07-18: 0 commits2026-07-19: 0 commits2026-07-20: 0 commits2026-07-21: 0 commits2026-07-22: 0 commits2026-07-23: 0 commits2026-07-24: 0 commits2026-07-25: 0 commits2026-07-26: 0 commits2026-07-27: 0 commits2026-07-28: 0 commits2026-07-29: 0 commits2026-07-30: 0 commits2026-07-31: 0 commits2026-08-01: 0 commits2026-08-02: 0 commits2026-08-03: 0 commits2026-08-04: 0 commits2026-08-05: 0 commits2026-08-06: 0 commits2026-08-07: 0 commits2026-08-08: 0 commits2026-08-09: 0 commits2026-08-10: 0 commits2026-08-11: 0 commits2026-08-12: 0 commits2026-08-13: 0 commits2026-08-14: 0 commits2026-08-15: 0 commits2026-08-16: 0 commits2026-08-17: 0 commits2026-08-18: 0 commits2026-08-19: 0 commits2026-08-20: 0 commits2026-08-21: 0 commits2026-08-22: 0 commits2026-08-23: 0 commits2026-08-24: 0 commits2026-08-25: 0 commits2026-08-26: 0 commits2026-08-27: 0 commits2026-08-28: 0 commits2026-08-29: 0 commits2026-08-30: 0 commits2026-08-31: 0 commits2026-09-01: 0 commits2026-09-02: 0 commits2026-09-03: 0 commits2026-09-04: 0 commits2026-09-05: 0 commits2026-09-06: 0 commits2026-09-07: 0 commits2026-09-08: 0 commits2026-09-09: 0 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 0 commits2026-09-13: 0 commits2026-09-14: 0 commits2026-09-15: 0 commits2026-09-16: 0 commits2026-09-17: 0 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 0 commits2026-09-23: 0 commits2026-09-24: 0 commits2026-09-25: 0 commits2026-09-26: 0 commits2026-09-27: 0 commits2026-09-28: 0 commits2026-09-29: 0 commits2026-09-30: 0 commits2026-10-01: 0 commits2026-10-02: 0 commits2026-10-03: 0 commits2026-10-04: 0 commits2026-10-05: 0 commits2026-10-06: 0 commits2026-10-07: 0 commits2026-10-08: 0 commits2026-10-09: 0 commits2026-10-10: 0 commits2026-10-11: 0 commits2026-10-12: 0 commits2026-10-13: 0 commits2026-10-14: 0 commits2026-10-15: 0 commits2026-10-16: 0 commits2026-10-17: 0 commits2026-10-18: 0 commits2026-10-19: 9 commits2026-10-20: 28 commits2026-10-21: 24 commits2026-10-22: 9 commits2026-10-23: 8 commits2026-10-24: 4 commits2026-10-25: 0 commits2026-10-26: 0 commits2026-10-27: 2 commits2026-10-28: 5 commits2026-10-29: 1 commit2026-10-30: 0 commits2026-10-31: 0 commits2026-11-01: 0 commits2026-11-02: 4 commits2026-11-03: 3 commits2026-11-04: 2 commits2026-11-05: 0 commits2026-11-06: 0 commits2026-11-07: 0 commits2026-11-08: 1 commit2026-11-09: 8 commits2026-11-10: 3 commits2026-11-11: 7 commits2026-11-12: 11 commits2026-11-13: 1 commit2026-11-14: 0 commits2026-11-15: 1 commit2026-11-16: 3 commits2026-11-17: 0 commits2026-11-18: 3 commits2026-11-19: 8 commits2026-11-20: 0 commits2026-11-21: 0 commits
152 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Actively maintained

    Pushed within 48 hours

  • Continuous integration

    Automated checks passing

  • Repeat trending

    4 trending appearances

What os-taxonomy does

Marble Skill Taxonomy is an open-source, structured dataset that decomposes primary and elementary education into a connected graph of learning. Instead of providing a flat list of standards, it breaks down education into 1,590 fine-grained micro-topics, each wired together by over 3,200 prerequisite dependencies. Each topic includes mastery criteria, plain-language descriptions, and direct alignments to national curriculum standards like Common Core and NGSS. This directed acyclic graph allows educators and developers to programmatically trace the exact learning path a student must master before grasping complex concepts.

This dataset is built for EdTech developers, curriculum designers, and educational researchers looking to build adaptive learning systems or analyze educational pathways. It requires familiarity with JSON or graph data structures to implement programmatically.

  • Micro-topic decomposition: Breaks down general subjects into 1,590 highly specific, teachable ideas with clear mastery criteria.
  • Prerequisite mapping: Connects topics using a directed acyclic graph to explicitly define the required learning path.
  • Standard alignment: Maps every micro-topic directly to established national curricula like Common Core and the UK National Curriculum.
  • Interactive visualization: Provides a comprehensive visual map allowing users to explore subjects and trace prerequisites interactively.
  • Structured data format: Delivers the entire curriculum graph as structured data, making it easy to integrate into educational software.

Where teams use it

EdTech curriculum development

Software developers use the graph data to build adaptive learning platforms that intelligently suggest the next topic for a student.

Lesson planning

Teachers consult the prerequisite map to ensure they cover all necessary foundational skills before introducing a complex subject.

Curriculum alignment auditing

Administrators utilize the taxonomy to verify that their school's syllabus correctly aligns with required national standards.

Educational research

Researchers analyze the graph structure to identify learning bottlenecks and optimize the sequencing of educational materials.

Getting started: https://withmarble.com/curriculum

README

main branch

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,861 · Prerequisite edges: 4,003 · Subjects: 9

Interactive audio lessons and local app

This repository also owns the Marble player and the audio lesson authoring skill. The taxonomy stays in data/ and schema/; the software has its own dependency lock and build inside player/.

Location Responsibility
player/apps/desktop Local Electron app and device permissions
player/apps/player Shared lesson UI, walkie-talkie, typed replies
player/apps/local-service Local APIs, provider calls and session logs
player/packages/lesson-contract, lesson-sdk Portable lesson format and scene bridge
player/packages/teaching-runtime Adaptive tutor orchestration
player/packages/voice, providers Local speech and inference connections
player/lessons Bundled example lessons: cube volume, the Moon in daytime, rainbows
.agents/skills/marble-voice-lesson Research, pedagogy and audio lesson authoring guidance
npm run player:install          # install pinned player dependencies (Node 24+)
npm run player:dev              # browser development at localhost:3235
npm run player:start            # native Electron app, with system sandbox support
npm run player:test
npm run player:test:browser
npm run skill:validate

Configure voice and a tutor connection using player setup. The app is a developer preview; native Linux launch on the current development machine works after the documented AppArmor setup. Models are installed separately, not stored in Git. Local speech can be paired with local inference or an experimental CLI provider. See the README for platform and provider limitations.

The skill references player/ directly. It never maintains a second runtime. Its scripts/create_experience.py creates a content-only lesson package; scripts/create_player.py exports a standalone source starter when needed. Settings, credentials, learner logs, recordings, weights, dependencies and builds are not repository content. For contract changes, update the SDK, affected lesson examples and authoring guidance together in this repo.

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:

  • 1,861 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.
  • 4,003 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. Coverage is partial; 812 topics have no research in this release.
  • Domain clusters — 176 parent-friendly one-paragraph summaries per (subject, domain, age band).

Subjects

Subject Topics
Computing 52
English 339
Geography 22
History 109
Learning to Learn 18
Life Skills 46
Mathematics 581
Personal & Social Development 118
Science 576

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 stable activity/citation identities.
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.
data/curriculum-alignments.json Scoped framework, jurisdiction and global age contexts; source for flat compatibility fields.

The catalogue contains 19 sources / 8,313 standards/source-position records. A separate NCERT NCF-SE October 2024 edition proposal contributes 254 formal stage goals/competencies: 172 Preparatory records shared across Grades 3–5 and 82 Foundational records preserving full ages 3–8 stage scope, without grade clones; the Arts/PE extension preserves nested source-set applicability. The NCERT foundational source contributes 316 positions: 67 Maths, 34 English L2, 66 Physical/Motor, 34 Socio-emotional/Ethical, 30 Arts, 18 Learning Habits and 11 Cognitive positions intersecting Grades 1–2, plus 56 shared-stage positions from the Arts syllabus explicit outcome column without an invented required grade. Shared grade cells and a repeated printed English requirement are preserved; source-position totals count neither distinct skills nor grade memberships. See the NCERT catalogue report and remaining primary scope. It includes 620 Australian Curriculum v9 content descriptions and 3,862 Ontario expectations from nine elementary documents. Ontario is exported as codes and official source links only; ingestion of source expectations is separate from authoring topic coverage. Ontario Grades 1–7 Mathematics have received focused taxonomy authoring passes. The Grade 2 report distinguishes reused claims, extracted elementary claims and the concurrency gap; mappings do not certify learner mastery of every linked topic. The Grade 3 report records reuse of 114 existing topics, the congruence extension and prerequisite repairs; no topics were added. The Grade 4 report records reuse of 126 existing topics, two missing skills, two focused extractions and prerequisite repairs. The Grade 5 report records reuse of 145 existing topics, one missing mathematical representation, one financial/civic concept and one focused extraction. The Grade 6 report records reuse of 173 existing topics and five additions: two procedures, one focused extraction and two financial-content claims. The Grade 7 report records reuse of 171 existing topics and two spatial additions; the square-root proposal was withdrawn.

The NCERT primary alignment stack has proposed review dispositions for all 570 accepted source keys. The final Preparatory TWAU slice reviews 32 records through reuse, completing source-position review after the Maths, language, observation, physical, learning-habit, socio-emotional and Arts slices. Formal stage requirements and suggestive positions remain distinct. Reviewed does not mean all Full, accepted, published or learner attainment: language/art-form bindings, contextual requirements and one unresolved physical musical-scale phrase remain explicit. The first Foundational Maths report retains its initial historical dispositions; later source-fit protocols resolve most performance conditions without country, grade or difficulty clones. Default-branch reconciliation and downstream compatibility remain separate.

Ontario Grade 5 Language adds 306 links across 161 existing topics, with no new topics. The Grade 5 Language report and code-by-code mapping record whole-topic reuse, prerequisite repairs, and the four remaining resource/performance conditions. Coverage links do not certify learner mastery.

Ontario Grade 6 Language adds 313 links across 168 topics, including three new claims and a suffix-evidence correction. The Grade 6 Language report and code-by-code mapping record 55 Full / 4 Partial specific expectations, with resource and performance conditions retained. This Language pass stops at primary Grade 6 (ages 11–12).

The Australian cleanup reviewed all 314 additions and 14 later edited IDs, consolidated repeated skills and redistributed bundled requirements. All 593 selected expectation codes remain linked. Those links do not certify whole-standard coverage: 572 previous Full claims have not been independently recertified. The 27 PE/movement descriptions remain excluded. Read the cleanup report and current area-by-area mapping counts.

See PROVENANCE.md for sources and attribution.

The Ontario primary status inventory separates catalogue ingestion, recorded associations and historical coverage reviews by subject and grade. The Grade 1 Science review accounts for all 55 selected codes, proposing existing-topic associations while retaining coverage conditions and focused decisions for follow-up. The Grade 2 Science review accounts for all 52 selected codes using existing claims, with unresolved source/assessment conditions made explicit. The Grade 3 Science review records all 55 codes, existing-topic reuse and verified Ontario soil examples, with remaining conditions explicit.

Ontario Grade 4 Science has a code-by-code review covering all retained codes with existing-topic reuse and explicit remaining conditions.

Ontario Grade 5 Science has a code-by-code review covering all retained codes with existing-topic reuse and explicit remaining conditions.

Ontario Grade 6 Science has a code-by-code review covering all retained codes; primary Science review has explicit dispositions through Grade 6.

These grade reports retain their historical authoring bases. The current integration delivers their reviewed changes together after Grade 1 reached main.

The cross-grade Science residual review groups remaining conditions across all primary grades without treating Partial judgments as new topics.

Adding curricula

For human-readable curation decisions, see the curation principles, ingestion and alignment guidelines and reviewed examples. Agents can use the taxonomy-curation skill, for example: Use $taxonomy-curation to audit the remaining primary-school Ontario alignments. The skill is optional; contributors submit the actual change in an ordinary PR and need no private account. Hosted builders must explicitly load these versioned instructions; adding the skill here does not change their runtime configuration.

The public alignment contract now has a reviewed baseline of 3,733 contexts. Edit data/curriculum-alignments.json for associations and their ages; keep topic claims in data/topics.json. The version 2 scope model preserves global guidance, international frameworks and separate jurisdiction age intervals on one topic; version 1 remains supported by the codec.

Run npm run alignments:generate, npm run validate, npm run alignments:generated-check and npm test, then submit the actual data change in a normal PR. Generation refreshes flat topic standards/ages, the research file's topic checksum binding and manifest checksums/counts. It uses only public local files and preserves original timestamps; no private account is needed. Authored research and its coverage must already be valid; this bounded command does not author research or repair unrelated artifacts.

The authoring and publication design describes downstream application deployment. This public baseline does not apply changes to a live DB, migrate agent tools or activate the future publisher.

Curricula map onto one shared taxonomy. Keep subjects and domains consistent across countries; a curriculum's learning-area labels do not create separate subject trees.

  • Reuse a topic when it assesses the same concept or operation. Add local examples without changing what mastery means.
  • Review affected assessment guidance and learner estimates before changing a mastery claim. Assess independent procedures separately; topics do not track multiple difficulty levels.
  • Record whole-expectation, component and prerequisite contributions explicitly. A topic–code link alone does not establish Full coverage.
  • Reuse existing domains before adding a distinct new domain. Keep names consistent and avoid parallel country-specific domain trees.
  • Keep each topic focused on a teachable concept or skill. A standard can link to several topics; its bundled requirements need not become one topic.
  • Add country-specific topics where the knowledge genuinely differs, such as a country's history or constitutional arrangements. Use shared topics for common concepts and skills, with local examples where useful.

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"]
}
  • id — stable identifier (mt_…), referenced by dependencies and by neighbours.
  • standards — keys into curriculum-standards.json ("<curriculum-slug>:<code>").
  • assessmentPrompt — a natural-language check for the idea. Contains a {{name}} placeholder (the child's name); substitute or strip before display.

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".

Teaching research

data/teaching-research.json adds how a topic might be taught to the graph of what children learn. It contains 1,097 active topic records. coverage.missingTopicIds and per-subject counts make the 815 topics without research explicit; absence is not a judgement about whether a topic can be taught.

archived-teaching-research.json preserves five historical records excluded from active coverage after a topic merge and a change in learning scope. Each entry includes the original topic and research record, its archive reason, and related current topic IDs. The archive retains seven historical prerequisite-reference repair mappings with stable diagnostic IDs; active records need no runtime repair.

The active teaching-research.json file has schemaVersion: 2 and taxonomy version: "v1". Each records[] entry joins topics.json through topicId and contains:

Field Meaning
pedagogy Original teaching summary, practices, representations and misconceptions.
learn Portable learning guidance (schemaVersion: 2): a summary, activities, educational constraints and review notes.
learn.activities[] Learner actions, intended insight, feedback, rationale and supporting citation IDs. No product artifact types or fit rankings.
assess Original diagnostic/task, response levels, error patterns and next teaching moves; nullable in the public interface.
sources Claim, named source, optional URL and the original author's verification flag.
confidence Original authoring confidence; not an independent quality score.
authorship.attribution Retained original authoring credit. Legacy timestamps and notes are stored in the separate public migration inventory.

Activities link to sources[].id through stable sourceIds; diagnostics and activities also retain stable IDs. See the canonical research contract and migration. A source may support a general principle or curriculum alignment; this does not mean the proposed activity was tested. Some activities have no directly linked citation.

These records were agent-authored. The learning guidance was rewritten for portability, checked by a separate factual critic, and sampled by a second agent. Most original pedagogy and assessment were retained and may contain claims that the updated guidance qualifies; chart-specific alignment repairs after #30 are recorded in the affected learning-guidance review notes; read the constraints and review notes alongside them. Sources were not re-fetched or re-verified for the initial publication; later nutrition-guide checks are recorded in the affected review notes. Historical verified: true and confidence: "high" are not new evidence ratings. Activities are research-informed proposals, not empirically validated interventions.

Nutrition terminology corrections in #63 update the existing Animal Nutrition, Balanced Diet & Food Groups, and Nutrients in a Healthy Diet guidance, activities and assessment to distinguish nutrients from food groups. Balanced-plate activities use food groups in a local guide; the records retain their identities. See the review note.

Some original research quoted restricted curriculum standards. Matched passages are replaced with inline curriculum references, including inside citation claims; all transformed paths are listed in publicationNotes. This is a conservative mechanical omission pass, not comprehensive rights clearance. Consult the linked upstream sources for their wording and terms. See PROVENANCE.md.

After the chart split in #30, mt_bESTSBB0wK covers pie charts, mt_H6LlpWgEYS covers earlier line-graph problem-solving, and mt_HlNSurPVDp has a separate construction-and-interpretation record. The new record adapts existing graph research; it is not a fresh literature review, and all reused source-verification flags are false. Its assessment requires a complete constructed graph. The later grouped-charts assessment routes graph-choice errors to data presentation and sector-angle errors to pie charts.

The file is bound to the exact topics.json bytes through topicFileSha256. Regenerate the research projection when the canonical topic file changes, even when topic IDs remain stable.

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);

Join teaching guidance to a topic:

import research from './data/teaching-research.json' with { type: 'json' };

const guidanceByTopic = new Map(research.records.map(r => [r.topicId, r]));
const guidance = guidanceByTopic.get('mt_N8CpN1EJrP'); // undefined: English is not covered yet
const activities = guidance?.learn.activities ?? [];

Validate structure, research coverage, evidence links and checksums:

node scripts/validate.mjs
node --test scripts/teaching-research.test.mjs

Marble Builder

The marble-builder agent skill helps turn a child's age and a user-confirmed goal into a standalone HTML learning experience that works offline by default. It uses topic prerequisites and available teaching research, develops a targeted research brief when needed, and agrees a concept with you before building. Experiences use visual interactions, scaffolding, UI-assessed transfer tasks and optional extensions. Spatial topics use Three.js with direct scene manipulation and a crafted cel-shaded look with flat colors and black outlines. Visual simulations must meet a beauty, craft and polish bar as well as work correctly. The public skill includes Marble-derived UI tokens, tactile controls refined in Moon Visit and Sky Colour Explorer, and the openly licensed Baloo 2 font, with one title and one instruction visible at a time: a small top-left title and a large, prominent instruction or explanation, plus concise button labels paired with icons. Water Lab is the visual quality reference. The agent renders, inspects and iterates in the browser rather than stopping at the first working HTML file.

The skill includes five runnable examples with readable source, key-state screenshots and design notes: Moon Visit, Sky Colour Explorer, Hidden Cubes, Bee Builder and Otter Forest. The notes explain what to borrow and where each prototype has limits or exceptions.

Optional connected LLM mode requires explicit author approval and a learning goal whose open-ended reasoning or text production cannot be adequately supported locally. That mode requires internet and a separate account connection; ChatGPT plan usage is a preview option for eligible local/open-source integrations.

In Codex, open this repository and invoke $marble-builder, for example:

Use $marble-builder to help my 8-year-old understand why equivalent fractions represent the same quantity.

Other agents can follow the linked SKILL.md directly. No Marble account or hosting is required. New reusable teaching research can optionally be proposed as a separate PR, with no child-specific information included.

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, original teaching-research prose CC BY-SA 4.0 — same spirit: attribution + share-alike.
Marble-authored learning examples — application source, original artwork, captures and design notes CC BY-SA 4.0. Bundled Three.js and Baloo 2 retain their separate MIT and OFL licenses and notices.
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.

View on GitHub

Recent activity

commits and pull requests

Recent open issues

view all

Code frequency

additions and deletions
+385.5K-385.5KWeek of 2026-07-05: +90,311 linesWeek of 2026-07-05: -8 linesWeek of 2026-07-12: +0 linesWeek of 2026-07-12: -0 linesWeek of 2026-07-19: +0 linesWeek of 2026-07-19: -0 linesWeek of 2026-07-26: +0 linesWeek of 2026-07-26: -0 linesWeek of 2026-08-02: +0 linesWeek of 2026-08-02: -0 linesWeek of 2026-08-09: +0 linesWeek of 2026-08-09: -0 linesWeek of 2026-08-16: +0 linesWeek of 2026-08-16: -0 linesWeek of 2026-08-23: +0 linesWeek of 2026-08-23: -0 linesWeek of 2026-08-30: +0 linesWeek of 2026-08-30: -0 linesWeek of 2026-09-06: +0 linesWeek of 2026-09-06: -0 linesWeek of 2026-09-13: +0 linesWeek of 2026-09-13: -0 linesWeek of 2026-09-20: +0 linesWeek of 2026-09-20: -0 linesWeek of 2026-09-27: +0 linesWeek of 2026-09-27: -0 linesWeek of 2026-10-04: +0 linesWeek of 2026-10-04: -0 linesWeek of 2026-10-11: +0 linesWeek of 2026-10-11: -0 linesWeek of 2026-10-18: +385,489 linesWeek of 2026-10-18: -76,148 linesWeek of 2026-10-25: +13,235 linesWeek of 2026-10-25: -8,999 linesWeek of 2026-11-01: +51,065 linesWeek of 2026-11-01: -2,365 linesWeek of 2026-11-08: +355,699 linesWeek of 2026-11-08: -10,407 linesWeek of 2026-11-15: +329,852 linesWeek of 2026-11-15: -41,863 linesJul 5, 2026Nov 15, 2026
+1.2M lines added, -139.8K removed over the last year.

Commits per week

last 52 weeks
820Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 0 commitsWeek of 2026-01-25: 0 commitsWeek of 2026-02-01: 0 commitsWeek of 2026-02-08: 0 commitsWeek of 2026-02-15: 0 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 0 commitsWeek of 2026-03-08: 0 commitsWeek of 2026-03-15: 0 commitsWeek of 2026-03-22: 0 commitsWeek of 2026-03-29: 0 commitsWeek of 2026-04-05: 0 commitsWeek of 2026-04-12: 0 commitsWeek of 2026-04-19: 0 commitsWeek of 2026-04-26: 0 commitsWeek of 2026-05-03: 0 commitsWeek of 2026-05-10: 0 commitsWeek of 2026-05-17: 0 commitsWeek of 2026-05-24: 0 commitsWeek of 2026-05-31: 0 commitsWeek of 2026-06-07: 0 commitsWeek of 2026-06-14: 0 commitsWeek of 2026-06-21: 0 commitsWeek of 2026-06-28: 0 commitsWeek of 2026-07-05: 7 commitsWeek of 2026-07-12: 0 commitsWeek of 2026-07-19: 0 commitsWeek of 2026-07-26: 0 commitsWeek of 2026-08-02: 0 commitsWeek of 2026-08-09: 0 commitsWeek of 2026-08-16: 0 commitsWeek of 2026-08-23: 0 commitsWeek of 2026-08-30: 0 commitsWeek of 2026-09-06: 0 commitsWeek of 2026-09-13: 0 commitsWeek of 2026-09-20: 0 commitsWeek of 2026-09-27: 0 commitsWeek of 2026-10-04: 0 commitsWeek of 2026-10-11: 0 commitsWeek of 2026-10-18: 82 commitsWeek of 2026-10-25: 8 commitsWeek of 2026-11-01: 9 commitsWeek of 2026-11-08: 31 commitsWeek of 2026-11-15: 15 commitsNov 23, 2025Nov 15, 2026
152 commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 0 commitsSun 1:00 — 0 commitsSun 2:00 — 0 commitsSun 3:00 — 0 commitsSun 4:00 — 0 commitsSun 5:00 — 0 commitsSun 6:00 — 0 commitsSun 7:00 — 0 commitsSun 8:00 — 0 commitsSun 9:00 — 1 commitsSun 10:00 — 0 commitsSun 11:00 — 0 commitsSun 12:00 — 0 commitsSun 13:00 — 0 commitsSun 14:00 — 1 commitsSun 15:00 — 0 commitsSun 16:00 — 0 commitsSun 17:00 — 0 commitsSun 18:00 — 0 commitsSun 19:00 — 0 commitsSun 20:00 — 0 commitsSun 21:00 — 0 commitsSun 22:00 — 0 commitsSun 23:00 — 0 commitsMon 0:00 — 0 commitsMon 1:00 — 0 commitsMon 2:00 — 0 commitsMon 3:00 — 0 commitsMon 4:00 — 0 commitsMon 5:00 — 0 commitsMon 6:00 — 0 commitsMon 7:00 — 0 commitsMon 8:00 — 0 commitsMon 9:00 — 0 commitsMon 10:00 — 2 commitsMon 11:00 — 2 commitsMon 12:00 — 1 commitsMon 13:00 — 1 commitsMon 14:00 — 1 commitsMon 15:00 — 2 commitsMon 16:00 — 2 commitsMon 17:00 — 0 commitsMon 18:00 — 4 commitsMon 19:00 — 1 commitsMon 20:00 — 0 commitsMon 21:00 — 5 commitsMon 22:00 — 3 commitsMon 23:00 — 0 commitsTue 0:00 — 0 commitsTue 1:00 — 1 commitsTue 2:00 — 0 commitsTue 3:00 — 0 commitsTue 4:00 — 0 commitsTue 5:00 — 0 commitsTue 6:00 — 0 commitsTue 7:00 — 0 commitsTue 8:00 — 0 commitsTue 9:00 — 1 commitsTue 10:00 — 2 commitsTue 11:00 — 5 commitsTue 12:00 — 2 commitsTue 13:00 — 0 commitsTue 14:00 — 1 commitsTue 15:00 — 9 commitsTue 16:00 — 3 commitsTue 17:00 — 2 commitsTue 18:00 — 2 commitsTue 19:00 — 2 commitsTue 20:00 — 2 commitsTue 21:00 — 2 commitsTue 22:00 — 1 commitsTue 23:00 — 1 commitsWed 0:00 — 0 commitsWed 1:00 — 0 commitsWed 2:00 — 0 commitsWed 3:00 — 0 commitsWed 4:00 — 0 commitsWed 5:00 — 0 commitsWed 6:00 — 0 commitsWed 7:00 — 0 commitsWed 8:00 — 0 commitsWed 9:00 — 1 commitsWed 10:00 — 6 commitsWed 11:00 — 5 commitsWed 12:00 — 2 commitsWed 13:00 — 1 commitsWed 14:00 — 3 commitsWed 15:00 — 5 commitsWed 16:00 — 6 commitsWed 17:00 — 4 commitsWed 18:00 — 3 commitsWed 19:00 — 2 commitsWed 20:00 — 1 commitsWed 21:00 — 5 commitsWed 22:00 — 3 commitsWed 23:00 — 0 commitsThu 0:00 — 0 commitsThu 1:00 — 0 commitsThu 2:00 — 0 commitsThu 3:00 — 0 commitsThu 4:00 — 0 commitsThu 5:00 — 0 commitsThu 6:00 — 0 commitsThu 7:00 — 2 commitsThu 8:00 — 11 commitsThu 9:00 — 4 commitsThu 10:00 — 1 commitsThu 11:00 — 2 commitsThu 12:00 — 2 commitsThu 13:00 — 1 commitsThu 14:00 — 3 commitsThu 15:00 — 1 commitsThu 16:00 — 0 commitsThu 17:00 — 0 commitsThu 18:00 — 0 commitsThu 19:00 — 1 commitsThu 20:00 — 0 commitsThu 21:00 — 1 commitsThu 22:00 — 0 commitsThu 23:00 — 0 commitsFri 0:00 — 0 commitsFri 1:00 — 0 commitsFri 2:00 — 0 commitsFri 3:00 — 0 commitsFri 4:00 — 0 commitsFri 5:00 — 0 commitsFri 6:00 — 0 commitsFri 7:00 — 0 commitsFri 8:00 — 0 commitsFri 9:00 — 0 commitsFri 10:00 — 0 commitsFri 11:00 — 0 commitsFri 12:00 — 0 commitsFri 13:00 — 0 commitsFri 14:00 — 1 commitsFri 15:00 — 1 commitsFri 16:00 — 1 commitsFri 17:00 — 1 commitsFri 18:00 — 1 commitsFri 19:00 — 0 commitsFri 20:00 — 0 commitsFri 21:00 — 3 commitsFri 22:00 — 1 commitsFri 23:00 — 1 commitsSat 0:00 — 0 commitsSat 1:00 — 0 commitsSat 2:00 — 0 commitsSat 3:00 — 0 commitsSat 4:00 — 0 commitsSat 5:00 — 0 commitsSat 6:00 — 0 commitsSat 7:00 — 0 commitsSat 8:00 — 1 commitsSat 9:00 — 0 commitsSat 10:00 — 0 commitsSat 11:00 — 0 commitsSat 12:00 — 0 commitsSat 13:00 — 0 commitsSat 14:00 — 1 commitsSat 15:00 — 0 commitsSat 16:00 — 0 commitsSat 17:00 — 1 commitsSat 18:00 — 1 commitsSat 19:00 — 0 commitsSat 20:00 — 0 commitsSat 21:00 — 0 commitsSat 22:00 — 0 commitsSat 23:00 — 0 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
Oct 21, 2026daily#6+284
Oct 20, 2026daily#6+284
Oct 19, 2026daily#6+427
Jul 9, 2026daily#25+3
  • ripienaar/free-for-dev

    A list of SaaS, PaaS and IaaS offerings that have free tiers of interest to devops and infradev

    143.3K stars · HTML

  • shanraisshan/claude-code-best-practice

    from vibe coding to agentic engineering - practice makes claude perfect

    69.3K stars · HTML

  • cathrynlavery/diagram-design

    Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

    68.1K stars · HTML

  • op7418/guizang-ppt-skill

    AI-agent Skill for generating polished HTML slide decks: editorial magazine and Swiss layouts, image prompts, social covers, and a WebGL/low-power presentation runtime.

    30.1K stars · HTML

  • alchaincyf/huashu-design

    Huashu Design 3.0 · 在 agent 里打一句话,拿回能交付的设计:网页 / App 原型 / 可编辑 PPTX / 动画 / 信息图 · 六个候选挑三个方向 · 84 种带样张的风格库 · 越用越懂你的外观账本与设计体检 · HTML-native design skill for Claude Code, Codex, Cursor & any agent

    29.8K stars · HTML

  • hasaneyldrm/exercises-dataset

    1,324-exercise fitness dataset — animation GIFs, 180×180 thumbnails, muscle-group & equipment data, and step-by-step instructions in 6 languages. The exercise data layer behind the LogPress app.

    23.9K stars · HTML