ResourceLearning

ResourceLearning ● ACTIVE

Contract: v0.9.4 • View Schema ↗

Specification Standard: Open Pedagogy Specification (OPS) ce-specs-registry: schemas/lms/resource_learning.schema.yaml

⚡ Live Schema Contract Definition (Auto-synced from schemas/lms/resource_learning.schema.yaml) ▼

Metadata Properties (metadata)

Field	Type	Required	Description
name	string	Yes	Standard resource identifier code (e.g. oer.ck12.biology.cell_structure.v1).
id	string	Yes	Unique resource identifier.
displayName	string	No	Resource title displayed in student curriculum lists and search.
description	string	No	Summary of educational resource content and topics covered.
tags	array	No	Curriculum keywords, CEFR levels, and taxonomy tags.

Specification Body (spec)

Field	Type	Required	Description
source	object	Yes	Provenance and licensing metadata for the Open Educational Resource.
qualityScore	object	No	—

📦 Canonical YAML Example (Auto-synced from examples/lms/resource_learning.example.yaml) ▼

apiVersion: core.oas.colabedu.io/v1beta1
kind: ResourceLearning
metadata:
  name: "global.res.ck12.bio.mitosis.v1"
  displayName: "Mitosis — CK-12 Biology FlexBook"
  description: "Curated open educational resource covering cellular division, stages of mitosis, and spindle apparatus formation."
  tags:
    - biology
    - open-education
    - ck12

spec:
  source:
    url: "https://www.ck12.org/biology/mitosis/"
    provider: "ck12"
    title: "Mitosis — CK-12 Biology FlexBook"
    license: "CC BY-NC 3.0"
    language: "en"
    contentType: "article"
    importedAt: "2026-06-09T00:00:00Z"

  qualityScore:
    alignment: 0.85
    pedagogicalRichness: 0.70
    accessibility: 0.60
    overall: 0.76

  applicableStandards:
    - "es.lomloe.bach.1.bio"
    - "us.ap.biology"

  curricularContext:
    standard: LOMLOE
    level: "1 BACH"
    subject: "biology"
    referenceCode: "es.lomloe.bach.1.bio"

ResourceLearning

ResourceLearning is a pedagogical spec type generated by the Curator Agent from open educational resources (OER). It indexes the resource with a 3-dimension qualityScore that evaluates its suitability for a specific curricular context.

Note

ResourceLearning is stored as BLOCK_CONTENT with kind: ResourceLearning in the SpecManager. No DDL schema changes are required.

---

Use Cases

Source	Tool	Output
CK-12 FlexBook (JSON)	curator curate --source-type OER_RESOURCE	ResourceLearning
Khan Academy (JSON/API)	curator curate --source-type OER_RESOURCE	ResourceLearning
Procomún / INTEF (MEC)	docs discover --source mec-procomun + batch	ResourceLearning
Europeana Education	docs discover --source europeana-edu + batch	ResourceLearning

---

Quality Evaluation

The curator_resource Gem evaluates each resource using a 3-dimension rubric:

Dimension	Weight	What it evaluates
alignment	50%	How well the content aligns with the CurricularContext (standard, level, subject)
pedagogicalRichness	30%	Variety of activities, conceptual depth, progressive scaffolding
accessibility	20%	Multilingual support, subtitles, WCAG 2.1 AA, alternative formats

The overall field is the weighted average. Resources with overall < 0.5 are flagged as status: LOW_QUALITY and excluded from teacher recommendations.

spec.applicableStandards[]

List of curricular standard referenceCode values applicable to the resource. This enables the SpecManager recommendation engine to filter relevant resources for a specific course.

---

CLI Ingestion

# Single OER resource in sandbox
curator curate \
  --source ce-specs/sources/oer/ck12/ck12_bio_mitosis_smoke.json \
  --source-type OER_RESOURCE \
  --output-type RESOURCE_LEARNING \
  --sandbox

# Batch from Procomún
docs discover --source mec-procomun --subject language --output mec.yaml
docs download --list mec.yaml --local-dir ce-specs/sources/oer/mec-procomun/
curator batch --manifest ce-specs/tests/lms_batch_manifest.yaml

# OER tests
curator test --lms --case ck12_oer_bio_resource
curator test --lms --all --threshold 70

---

Environment Variables for OER Sources

Variable	Source
COLABEDU_API_KEY_EUROPEANA	Europeana Education API (wskey)
COLABEDU_API_KEY_CANVAS	Canvas Commons API token

Sources ck12, khan-academy, and mec-procomun do not require an API key.

---

Related Pages

• Curator Agent Capabilities
• CLI Tutorial
• InteractiveLesson Reference
• Gem Reference