← EduInsightsCONTENT HISTORY

Update to EduInsights

Snapshot Sep 30, 2026 · 22:56 UTC · version 0.2.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "understand-eduinsights-ontology",
  "description": "Explain and apply the EduInsights semantic world model, including canonical entities, identifiers, relationships, native grains, applicability, coverage, source boundaries, and the most important marts. Use for questions about the EduInsights ontology, semantic layer, data model, schema, relationship map, mart meanings, or which mart fits an education, workforce, accreditation, outcome, or AI-use question.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 564
    },
    {
      "relative_path": "references/important-marts.md",
      "size_in_bytes": 12113
    },
    {
      "relative_path": "references/world-model.md",
      "size_in_bytes": 16100
    }
  ],
  "skill_md_contents": "---\nname: understand-eduinsights-ontology\ndescription: Explain and apply the EduInsights semantic world model, including canonical entities, identifiers, relationships, native grains, applicability, coverage, source boundaries, and the most important marts. Use for questions about the EduInsights ontology, semantic layer, data model, schema, relationship map, mart meanings, or which mart fits an education, workforce, accreditation, outcome, or AI-use question.\n---\n\n# Understand the EduInsights ontology\n\nExplain how EduInsights represents the person's question before selecting data. Preserve the question's ordinary meaning while keeping every connection at its supported level of detail.\n\n## Follow this path\n\n1. Identify the requested entity, measure or outcome, population, place, and period.\n2. Read [world-model.md](references/world-model.md) before explaining an entity, relationship, identifier, applicability rule, or coverage state.\n3. Read [important-marts.md](references/important-marts.md) before naming, comparing, or selecting a `marts.*` relation.\n4. When current availability or columns matter, call `edu_describe_data` without a topic. Then inspect the selected relation with `topic: table:marts.<relation>`.\n5. Use the smallest relation at the question's native level of detail. Move across entities only through an explicit identifier or relationship.\n6. State the connection type and the boundary that prevents overinterpretation.\n\nTreat live `edu_describe_data` output as the authority for deployed availability and fields. Its overview can emphasize common starting views rather than print every relation. Treat a curated mart as unavailable only when its direct table description fails. Never query `marts.semantic_catalog` directly.\n\n## Keep the two registers separate\n\nUse exact entity, relationship, identifier, and mart names for builders, data work, and reproducibility. For everyone else, explain the plain meaning first. Add the technical name only when it helps the person inspect or reproduce the result.\n\nFor example, say \"degrees a college reported in a field and year\" before `ProgramAwardCell`. Say why a value is blank instead of exposing a coverage-state code.\n\n## Protect the meaning\n\n- Treat reported awards as historical reporting, not proof of a current catalog program.\n- Treat broader field outcomes as context for a narrower field or program.\n- Treat CIP-to-SOC links as preparation relationships, not observed graduate destinations.\n- Keep occupations, industries, tasks, and skills distinct.\n- Treat observed AI use as behavior in the named product and population, not employment impact or universal capability.\n- Preserve source release, native level of detail, applicability, coverage, and identifier uncertainty.\n- Keep zero distinct from suppressed, uncollected, inapplicable, nonparticipating, stale, or unresolved data.\n\nWhen the person asks for an empirical result rather than an explanation, apply these semantic rules with `$research-with-eduinsights`.\n\n## Finish with a usable map\n\nComplete the answer only when it identifies:\n\n- the person's concept and the matching ontology entity or entities;\n- the relationship path and whether each step is direct, inherited, structural, empirical, or contextual;\n- the best current mart or focused tool and what one row represents;\n- the source, period, coverage, and limitation most likely to change the interpretation.\n"
}

SHA-256: 752ffcca7b8074db1fc238517bb8701f63956fd539050e455d8532d7738ed91e