Schema (schemapedia)

SkillDev tools

Schemapedia — schema plugins, families, gateways, formats.yml, mechanism_relations; self-object kernel; delegates to sibling skills.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Schema (schemapedia) skill

What this skill tells your AI

The instructions your AI receives, as published by simhacker/moollm in skills/schema/SKILL.md and read by ahel’s review.

MOOLLM schemapedia is unrelated to the legacy Schemapedia product listed on the W3C Wiki (Ontology repositories).

“Schema” is overloaded. This skill is the single index for MOOLLM: families of mechanisms (interchange, notation, causal, situational, activation, relational, execution, introspection, component_interop, meta-model, registry_meta), nomenclature, spec and skill pointers, optional CLI affordances per plugin, and gateways between senses. It registers cursor-mirror with the Cursor SQLite + YAML data model (CURSOR-SQLITE-MODEL.yml, DATA-SCHEMAS.yml, …) alongside JSON Schema, SQLite, shell orchestration, and com-xpcom (COM / XPCOM history).

Supersession (multi-axis + relations): schemas/supersession-suggestions.yml lists legacy clusters with axes toward_now, upwardish, sideways, roots_downward, plus relation_semantics defining predicates (replaces, variant_of, ancestor_of, complementary_to, opposite_of, intersects, …) and per-cluster why blocks (removes / adds / trades_away). Goal-relative, not a universal ranking. Complements gateways.yml, not a replacement.

Treat schemapedia as a network topology: mechanisms in registry.yml are nodes; gateways.yml bridges and optional mechanism_relations in each MECHANISM.yml are edges (translations, complements, application bridges). That graph is meant to drive code generation, validation across layers (wire payloads, world models, plans), and execution composition—provided every edge’s fidelity and canonical source of truth stay explicit.

Part of MOOLLM

Repo README, skills/README.md, README.md (narrative).

Families (what the registry sorts)

FamilyWhat it coversDelegates to (examples)
interchangeWire/instance shapes and validatorsJSON Schema, Zod, RELAX NG, XSD profiles
notationAuthoring YAML with semantic comments (YAML Jazz)yaml-jazz skill — schema plugin in this registry
causalDrescher Context → Action → Resultschema-mechanism, schema-factory
situationalMinsky frames (slots, defaults)knowledge-frames
activationK-lines / protocol symbolsk-lines, PROTOCOLS.yml
prototypeSelf object model: delegation, receivers (Ungar & crew); MOOLLM kernelself mechanism → prototype skill (DOP, ordered PROTOTYPES.yml, multiple parents including Self as lineage)
relationalTables, constraints, dialects, DDLsql, postgres, sqlite, datasette — skills wrap CLI + file ecosystems; datasette = SQLite publish (incl. cursor-mirror export); postgres-optimization (advanced PG tuning)
executionShell + sister scripts + orchestration (bash-shaped automation)shell-orchestrationsister-script, plan-then-execute, mooco, runtime
introspectionCursor session DB + reverse-engineered modelcursor-mirrorcursor-mirror skill + reference/universal/CURSOR-SQLITE-MODEL.yml et al.
vcsVersion control, commit DAG, diffs, hooks, provenancegit — object model and repo timeline
collaborationForges: APIs, issues/PRs, social graph, CI over gitgithub — REST/GraphQL + multi-facet hub; branch-as-object and Issue_<id> delegated to moocroworld + moo
component_interopBinary component models (COM, XPCOM), IDL-era interfacescom-xpcom — Microsoft COM / Mozilla XPCOM; deCOM history (see mechanism README)
meta_modelSociety of Mind (agents, architecture)society-of-mind
registry_metaSchemapedia plugin model (MECHANISM.yml, augment, templates)mechanism → this skill

Deep theory stays in sibling skills; registry.yml holds ids, summaries, delegate_skills.

Interchange vs notation vs causal vs relational

  • Interchange — wire/config bytes; JSON (RFC 8259) is tree-only, no comment syntax (by design). XML / lexical HTML have lexical <!-- --> comments and a DOM that can keep comments and (per infoset/HTML rules) whitespace—unlike JSON-only APIs.
  • Notationyaml-jazz: same YAML tree as interchange for data, plus COP in comments (comment-preserving parsers). Pair with JSON Schema via gateways.yml json-schema-with-yaml-jazz. For document-shaped artifacts, XML or HTML can be the practical move when markup-native tooling matters.
  • Causal — Drescher-style pipelines; schema-factory.
  • Relationalsql, sqlite; postgres is not its own row—use sql + postgres-optimization for deep PG tuning. Here: docs and gateway patterns, not shipping engines.

Pantheon: self-object system, formats, COP, and XML

Self-object system: skills are prototypes; repo files/dirs instantiate them. Schemapedia is composition over mechanism families, on top of that kernel.

COP: not a registry row; yaml-jazz carries COP in YAML comments. PostScript DSC (%% comments, %!PS-Adobe-) is the same pattern: parallel lane beside the executable. XML/HTML: lexical comments + DOM—not yaml-jazz, same idea. Details: schemas/formats.yml comment_oriented_programming.

Literate vs COP: Literate WEB-style weave/tangle makes prose and code co-primary; YAML Jazz keeps the tree authoritative and comments as a second channel (closer to DSC than to weave). Fenced Markdown blocks + plugins (MDX, Quarto, …) are polyglot at block scopenot COP-in-YAML, same family: human surface beside machine fragments.

Documents vs payloads: Prefer XML/HTML when the artifact is markup-first; Svelte .svelte is the same shape (regions + script/style).

Formats ↔ mechanisms: schemas/formats.yml maps lexical formats (text, CSV, JSON, YAML, XML, SGML) → mechanism ids (interchange, yaml-jazz, relational, …).

Policy: Mechanisms = registry.yml vertices with schemas/mechanisms/<id>/MECHANISM.yml. Formats = syntax; do not duplicate e.g. JSON as a row when json-schema is the contract. CSV = format + relational + project rules until a real interchange layer warrants a plugin. formats_index in registry.yml.

CLI toolchains: formats.yml interoperable_toolchainsjq, ajv-cli, yq, xmllint, jing, trang, … aligned with gateways.yml.

XML: one syntax; many mechanisms (xml-schema, relax-ng, …); gateways.yml has bridges—do not treat “XML” as one schema.

Git / GitHub: git (vcs), github (collaboration); see systems.yml, schemas/mechanisms/github/MECHANISM.yml.

SQL and SQLite in MOOLLM

How well we support them: as first-class registry entries with stubs you extend (schemas/mechanisms/sql/MECHANISM.yml, schemas/mechanisms/sqlite/MECHANISM.yml). Typical integrations:

  • DDL + migrations as the schema artifact; link to interchange (JSON Schema) at boundaries (HTTP body vs row).
  • SQLite specifically: type affinity, STRICT, sqlite_master, pragma user_version, JSON1 for hybrid document-in-table.
  • Gateways in gateways.yml: JSON Schema ↔ table design, sqlsqlite dialect, optional Drescher logs → tables.

What we do not claim: one automatic mapping from JSON Schema to correct SQLite DDL for every domain—that remains application design.

Registry layout

FilePurpose
schemas/README.mdDirectory tour: root schemas/*.yml vs mechanisms/<id>/.
schemas/mechanisms/README.mdIndex of every mechanism (MECHANISM.yml per directory).
templates/MECHANISM.ymlTemplate for MECHANISM.yml: layout, defaults, facets, hooks (see file header).
schemas/registry.ymlMaster index: families + mechanisms.
schemas/gateways.ymlCross-mechanism bridges (including relational).
schemas/mechanisms/<id>/MECHANISM.ymlPer-mechanism profile; optional SCHEMAPEDIA-*-AUGMENT.yml (extended refs + improvisation).
schemas/plugin-convention.ymlNormative: standalone vs ensemble, deeper_skills, optional cli_tools.
schemas/drescher-mapping.ymlOptional Drescher ↔ interchange serialization.
schemas/formats.ymlFormats ↔ mechanisms; self-object system; COP placement; XML many grammars.
schemas/systems.ymlSystems beyond formats—git, GitHub, facets (VCS, APIs, social, timelines).

Add mechanisms by new directory schemas/mechanisms/<id>/ with MECHANISM.yml + registry entry under the right family.

Plugin shapes: one directory, depth optional

A mechanism plugin is always schemas/mechanisms/<id>/MECHANISM.yml. The directory name matches the registry id. What varies is whether that file is enough on its own or indexes deeper work:

ShapeMeaningdeeper_skills
StandaloneSpecs, nomenclature, and hooks live in this file; no MOOLLM skill is required for the registry to be useful.[] (empty or omitted)
EnsembleThe theory is bigger than a single schema-type plugin; this file points at one or more MOOLLM skills (single or ensemble) for full depth.One or more skill ids (same list mirrored as delegate_skills on the mechanism in registry.yml).

Normative: schemas/plugin-convention.yml. Keep registry.yml delegate_skills and MECHANISM.yml deeper_skills aligned.

Mechanism ↔ mechanism: a peer mechanism is not placed inside another mechanism’s directory (shared mechanisms are referenced by id; many profiles may point at the same bridge). Use gateways.yml for the canonical list of bridges (from, to, tools, fidelity). Each MECHANISM.yml may also declare mechanism_relations (see plugin-convention.yml) with: target mechanism id, kind, protocol (human-readable contract), optional gateway_ref (same id as a bridge in gateways.yml), and optional parameters (knobs, boundaries, ordering).

Mechanism relations (composition protocols)

mechanism_relations in each MECHANISM.yml declare how mechanisms compose (complements, bridges, parameters)—meta wiring, not a replacement for gateways.yml or validators.

Plugin checklist

  1. Pick family and id (kebab-case).
  2. Copy templates/MECHANISM.yml to schemas/mechanisms/<id>/MECHANISM.yml and edit.
  3. Choose standalone vs ensemble; set deeper_skills and registry delegate_skills accordingly.
  4. Add profile path and summary in registry.yml.
  5. Extend gateways.yml when two mechanisms meet in real pipelines; add matching mechanism_relations rows on each side (with gateway_ref) when the edge is stable.
  6. For relational engines, document dialect, artifacts, and migration tool examples in the profile.
  7. Optionally list cli_tools (name + role) so agents know which CLIs pair with the plugin (jq, sqlite3, yq, …).

Current plugins (registry mechanisms)

idfamilyNotes
json-schema, zodinterchangeWire validation; see cli_tools in profiles (e.g. jq, ajv-cli).
relax-ng, xml-schemainterchangeXML stacks; xmllint, trang, etc.
dreschercausalEnsemble: schema-mechanism, schema-factory.
minsky-framesituationalknowledge-frames.
k-linesactivationk-lines skill.
society-of-mindmeta_modelsociety-of-mind skill.
mechanismregistry_metaMeta: plugin shape, templates/MECHANISM.yml, plugin-convention.yml; delegates here (schema skill).
sql, sqliterelationalDDL; sqlite3, dialect clients.
yaml-jazznotationSemantic YAML; yq when transforming.
shell-orchestrationexecutionCursor / terminal agents: compose docs → commands → scripts; ensemble below.
cursor-mirrorintrospectionCursor SQLite + model YAML: chats, tools, thinking, context; see schemas/mechanisms/cursor-mirror/MECHANISM.yml.
gitvcsObjects, DAG, hooks, diffs; repo timeline—pairs with shell-orchestration for hooks.
githubcollaborationAPIs, issues/PRs, social, Actions—gateways.yml github-over-git, github-api-json-schema; delegate_skills: moocroworld, moo.
com-xpcomcomponent_interopCOM / XPCOM binary interfaces; Mozilla decomification / decomtamination—curated links in mechanisms/com-xpcom/README.md.

shell-orchestration ensemble: sister-script, plan-then-execute, mooco, runtime — see schemas/mechanisms/shell-orchestration/MECHANISM.yml.

CLI affordances

cli_tools in MECHANISM.yml: { name, role } per plugin-convention.yml (e.g. jq, sqlite3, yq).

Credits

MOOLLM registry. SQL/SQLite specs: ISO/ANSI, sqlite.org.

License: MIT

Tags: schemapedia, registry, interchange, execution, cli_tools, drescher, frames, k-lines, sql, sqlite, gateways

Related skills: schema-mechanism, schema-factory, knowledge-frames, k-lines, society-of-mind, yaml-jazz, sister-script, plan-then-execute, mooco, runtime, cursor-mirror

Signals

GitHub stars
52
Forks
5
Last commit
Sep 2026
Hacker News mentions
20
Advanced
Catalog kind
skill
Gateway key
schema-simhacker
Source
github.com/simhacker/moollm