by ruc-datalab
EvoOntology: A Self-Evolving Ontology Layer for Data Agents ⚙️ EvoOntology插件为Claude Code/Codex 建立&进化本体层
# Add to your Claude Code skills
git clone https://github.com/ruc-datalab/EvoOntologySee how EvoOntology compares with popular alternatives.
EvoOntology is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ruc-datalab. EvoOntology: A Self-Evolving Ontology Layer for Data Agents ⚙️ EvoOntology插件为Claude Code/Codex 建立&进化本体层. It has 52 GitHub stars.
EvoOntology's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/ruc-datalab/EvoOntology" and add it to your Claude Code skills directory (see the Installation section above).
EvoOntology is primarily written in Python. It is open-source under ruc-datalab on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh EvoOntology against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
Authors: Meiduo Chong, Shaolei Zhang*, Ju Fan, Xiaoyong Du Renmin University of China
EvoOntology bridges the agent-data gap over heterogeneous tables, files, and databases. It exposes a versioned Ontology Layer through MCP tools, grounds that layer in real workload evidence, and continuously adapts it from execution trajectories.
The Codex and Claude Code plugins build and evolve ontology layers over your data.
https://github.com/user-attachments/assets/85b84bd8-0673-4477-9298-dae0e6565b82
| Principle | Core idea |
|---|---|
| Active access | Retrieve only the semantics needed for the current step through MCP tools instead of injecting the full ontology. |
| Grounded construction | Build around the workload and commit semantic objects only after verification against the underlying data. |
| Targeted evolution | Diagnose interaction trajectories and apply localized updates to the interconnected Content, Schema, and Tool Layers. |
| Gated versioning | Publish a Candidate only when paired evaluation shows a reproducible improvement over its Parent. |
| Agent integration | Connect the ontology workspace and MCP runtime directly to supported agents through plugins. |
EvoOntology treats the Ontology Layer as trainable agent state—not model weights. A builder initializes grounded semantic objects from the workload and underlying data; an evolution agent then uses historical interactions to propose bounded updates and validates every Candidate against its Parent.
Three interconnected layers define the ontology's knowledge, representation rules, and runtime access:
| Layer | Role |
|---|---|
| Content Layer | A typed semantic graph with four node families: Terms, Mappings, Constraints, and Evidence. Semantic Relations connect Terms, while Structural References link Terms to Mappings and attach Constraints or Evidence to the objects they govern or support. |
| Schema Layer | Defines the fields of the four node families, the allowed Semantic Relation types, and the permitted Structural Reference patterns, thereby setting the ontology's representational boundaries. |
| Tool Layer | Exposes the ontology through browse_semantics, resolve_semantics, and a compact session manifest. The manifest initializes the session; detailed records and linked objects are retrieved on demand. |
ontology_v0.ontology_vN+1; otherwise retain the Parent and use the result in the next round.Install the plugin from the GitHub marketplace—no repository clone, virtual environment, or separate pip install is required.
claude plugin marketplace add MeiduoChong/EvoOntology
claude plugin install evoontology@evoontology
claude plugin list
Start a new session, then run:
/evo-build
/evo-evolve
/evo-visualize
codex plugin marketplace add MeiduoChong/EvoOntology
codex plugin add evoontology-codex@evoontology
codex plugin list
Start a new thread, then ask Codex to use:
$evo-build
$evo-evolve
$evo-visualize
Once built, the Data Agent can call browse_semantics and resolve_semantics without additional ontology configuration. See the usage guide for the full workflow and data boundaries.
Across the four-backbone analysis subset, the builder-constructed Initial Ontology Layer improves over ReAct without an Ontology Layer, and self-evolution produces a further gain with EvoOntology on all three benchmarks.
| Benchmark | Primary metric | ReAct without Ontology Layer | Initial Ontology Layer | EvoOntology | Gain over ReAct |
|---|---|---|---|---|---|
| DDR-Bench (10-K) | Trajectory-Wise | 69.5 | 81.8 | 89.5 | +20.0 |
| InsightBench | Insight | 53.2 | 54.0 | 54.2 | +1.0 |
| BIRD | Execution Accuracy (EX) | 63.6 | 68.7 | 72.4 | +8.8 |
EvoOntology includes self-contained adapters for three complementary Data Agent settings:
| Benchmark | Task | Directory |
|---|---|---|
| BIRD | Text-to-SQL over real-world databases | benchmarks/bird/ |
| DDR-10K | Open-ended research over heterogeneous financial data | benchmarks/ddr_10k/ |
| InsightBench | Iterative business analysis and insight generation | benchmarks/insightbench/ |
Each environment implements an EvolutionAdapter and preserves its native rollout and evaluation protocol. List registered environments with python -m benchmarks list; see Adding a benchmark for the integration contract.
| Path | Purpose |
|---|---|
assets/ |
README media, framework figures, and ontology-layer interface screenshots. |
evoontology/ |
Deterministic core: ontology store, runtime/MCP, trajectories, triggers, evaluation, evolution state, validation, an |