Gem

Gem ● ACTIVE

Contract: v0.9.4 • View Schema ↗

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

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

Metadata Properties (metadata)

Field	Type	Required	Description
id	string	Yes	Canonical unique identifier for the recipe (e.g. global.c1.ib.paper2.recipe.v1).
reference_code	string	Yes	Standardized reference code identifying the recipe in the grading compiler.
referenceCode	string	Yes	CamelCase alias for reference_code supported for backward compatibility.
name	string	No	Human-readable name or title of the evaluation recipe.
title	string	No	Descriptive title of the recipe.
version	string	No	Semantic version tag of the recipe.

Specification Body (spec)

Field	Type	Required	Description
exerciseTypeRef	string	No	Reference code to the required interaction format (ExerciseType C1).
rubricRef	string	No	Reference code to the grading rubric (BLOCK_RUBRIC C0/C2).
evaluatorPersonaRef	string	No	Reference to the AI didactic persona or tone profile (Persona C3).
writtenTemplate	string	No	Prompt template used for written student work assessment.
oralTemplate	string	No	Prompt template used for audio/oral student work evaluation.
pedagogicalConfig	object	No	Fine-grained behavioral parameters (e.g. spelling tolerance, CEFR boundary strictness).

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

apiVersion: colabedu.ai/v1beta1
kind: Recipe
metadata:
  id: global.c1.ib.spanish_a.literature.hl.2026.v1.v1.cf8880
  title: "Recipe for IB 2026 - Spanish A Literature HL - Assessment Outline"
  version: "1.0.0"
workflow_parameters:
  scoring: true
  report_format: PDF
pedagogical_assembly:
  rubric:
    layers:
      - level: C0
        block_id: global.c0.ap.spanish_literature.essay.text_comparison.v1.v1.6a4ae1
        status: ACTIVE
spec:
  assembly:
    param_refs:
      - global.exercise_type.free_text.v1
    rubric_refs:
      - global.c0.ap.spanish_literature.essay.text_comparison.v1.v1.6a4ae1
    directive_refs: []

Restricted Resource - Partners Only

Access and configuration of ColabEdu Layer C3 resources (Directives, Personas, and Gems) is restricted to authorized partner organizations (governments, partner publishers, and consultancies).

The Gem resource (AI Module) defines profiles, roles, and core instruction sets (system prompts) for Artificial Intelligence agents within the platform.

---

Curator Gems

The Curator Agent pipeline uses a set of specialized Gems to transform different source types into pedagogical specs. The curator_router classifies each input and delegates to the most appropriate Gem:

Gem	Output	Triggers when
gem.curator_router	— (routes)	Always — classifies input and delegates
gem.curator_c0	BlockRubric	Normative curricular documents
gem.curator_c1	Recipe	Complete didactic units
gem.curator_c2	ExerciseSpec	Exam PDFs, FRQ, problems
gem.curator_lesson	InteractiveLesson	LMS packages (.imscc Canvas, .mbz Moodle)
gem.curator_resource	ResourceLearning	OER APIs: CK-12, Khan Academy, Procomún, Europeana

YAML files for each Gem are stored in ce-specs/catalog/personas/curators/.

Example: gem.curator_lesson

Generates InteractiveLesson specs from the HTML/XML content of an unzipped LMS package:

apiVersion: core.oas.colabedu.io/v1beta1
kind: Gem
metadata:
  name: curator_lesson
  description: |
    Transforms the content of an LMS package (Canvas IMSCC / Moodle MBZ)
    into an InteractiveLesson with structured slides and pedagogical widgets.
spec:
  system_prompt: |
    You are the Interactive Lesson Curator for ColabEdu.
    You will receive content extracted from an LMS package (HTML, XML, assets).

    YOUR TASK:
    Generate a YAML spec of type `InteractiveLesson` with:
    1. `slides[]` — at least 3 slides with title, body, and widget type
    2. `learningObjectives[]` — objectives aligned to the CurricularContext
    3. `lmsSource` — metadata from the original package (url, platform, packageId)

    OUTPUT: Valid OPS YAML only. No additional explanations.

Example: gem.curator_resource

Generates ResourceLearning specs with a 3-dimension qualityScore:

apiVersion: core.oas.colabedu.io/v1beta1
kind: Gem
metadata:
  name: curator_resource
  description: |
    Indexes an OER resource (CK-12, Khan Academy, Procomún, Europeana)
    with a 3-dimension pedagogical qualityScore.
spec:
  system_prompt: |
    You are the Open Educational Resource Curator for ColabEdu.

    YOUR TASK:
    Generate a YAML spec of type `ResourceLearning` with:
    1. `source` — url, title, provider, license, language
    2. `qualityScore` — object with 3 keys (0.0–1.0 each):
       - `alignment`: alignment with the provided CurricularContext
       - `pedagogicalRichness`: variety of activities and content depth
       - `accessibility`: multilingual support, WCAG, alternative formats
    3. `applicableStandards[]` — list of applicable standard referenceCodes

    OUTPUT: Valid OPS YAML only. No additional explanations.

---

Related Pages

• Curator Agent Capabilities — Full pipeline with Gem router
• InteractiveLesson Reference — Output of curator_lesson
• ResourceLearning Reference — Output of curator_resource