← Back to Skills Marketplace
onlyloveher

Ontology

by onlyloveher · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
175
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ontology-clawd
Description
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
Usage Guidance
This skill implements a local, append-only ontology stored on disk and the bundled Python CLI mostly matches the documentation. Before installing or enabling it: (1) Verify which storage path the agent will actually use (SKILL.md uses memory/ontology; skill.yaml sets ~/clawd/ontology) and adjust to a safe directory you control. (2) Confirm your environment runs Python (the implementation is Python) — skill.yaml's Node requirement is incorrect and should be clarified with the author. (3) Do not store secrets directly in the graph — the schema enforces secret_ref, but other skills or users might accidentally write sensitive values; treat the graph files as potentially sensitive and restrict file permissions. (4) Inspect the full scripts/ontology.py (particularly the truncated schema-loading/validation code) for any network I/O before granting broad access. (5) If you need cross-skill sharing, require skills to declare exact read/write contracts per the Skill Contract. These inconsistencies look like sloppy packaging rather than overtly malicious behavior, but confirm the above points before trusting the skill with sensitive data.
Capability Analysis
Type: OpenClaw Skill Name: ontology-clawd Version: 1.0.0 The 'ontology-clawd' skill provides a structured knowledge graph for agent memory, supporting entity CRUD operations, relationship mapping, and schema validation. The implementation in `scripts/ontology.py` follows security best practices, including path traversal protection via a `resolve_safe_path` utility and explicit constraints in `SKILL.md` and `references/schema.md` to prevent the storage of raw secrets (e.g., passwords or tokens). No evidence of malicious intent, data exfiltration, or prompt injection was found.
Capability Assessment
Purpose & Capability
The skill's declared purpose (typed knowledge graph / agent memory) matches the included Python tool and SKILL.md workflows. However skill.yaml claims Node compatibility (node >=18.0.0) while the provided implementation is a Python script (scripts/ontology.py). The SKILL.md uses memory/ontology/graph.jsonl as the default storage path but skill.yaml's ONTOLOGY_PATH default is '~/clawd/ontology' — inconsistent defaults that could cause confusion. Metadata owner IDs/homepage also differ across files. These mismatches are not clearly malicious but are incoherent and warrant clarification.
Instruction Scope
Runtime instructions restrict operations to local graph files (create/query/relate/validate) and emphasize append-only history and a schema that forbids storing secrets directly (Credential.secret_ref). The instructions and script operate on local files (memory/ontology/graph.jsonl and memory/ontology/schema.yaml) and do not instruct network calls or access to unrelated system files. Caution: append-only logs preserve history, so any sensitive data written into entities will remain on disk; the skill explicitly calls out not storing secrets directly but relies on users/other skills to follow that.
Install Mechanism
No install spec is provided (instruction-only), and there are no downloads or package installs. The single bundled script is a plain Python CLI. This is low-install risk.
Credentials
The skill declares no required environment variables or credentials. The only config is an ONTOLOGY_PATH in skill.yaml (a storage path). The code does not require or reference external secrets or cloud credentials. This is proportionate to its stated purpose.
Persistence & Privilege
always is false and the skill is user-invocable; it does normal local storage of its own data and does not request persistent privileges or modify other skills' configs. The append-only storage model gives it persistent local data — ordinary for this functionality.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ontology-clawd
  3. After installation, invoke the skill by name or use /ontology-clawd
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the ontology skill for structured agent memory and composable skill state. - Provides a typed knowledge graph for entities, relations, properties, and constraints. - Supports creation, querying, linking, and validation of core types: Person, Project, Task, Event, Document, etc. - Enforces type and relation constraints, including required fields, enums, relation cardinality, and acyclicity. - Stores data append-only in JSONL files under `memory/ontology` with optional schema support. - Includes CLI for entity and relation CRUD, validation, and simple planning as graph transformations. - Designed for cross-skill data sharing and integration via ontology contracts.
Metadata
Slug ontology-clawd
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Ontology?

Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin... It is an AI Agent Skill for Claude Code / OpenClaw, with 175 downloads so far.

How do I install Ontology?

Run "/install ontology-clawd" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ontology free?

Yes, Ontology is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Ontology support?

Ontology is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Ontology?

It is built and maintained by onlyloveher (@onlyloveher); the current version is v1.0.0.

💬 Comments