kg-ontology-designer

Designs code-derived knowledge-graph ontologies and MCP tool tiers validated against real code.

Updated Nov 19, 2020
One-click install
npx skills add https://github.com/kwojtasinski-repo/ECommerceApp --skill kg-ontology-designer-kwojtasinski-repo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kg-ontology-designer
Source: https://github.com/kwojtasinski-repo/ECommerceApp/tree/main/.claude/skills/kg-ontology-designer
Command: npx skills add https://github.com/kwojtasinski-repo/ECommerceApp --skill kg-ontology-designer-kwojtasinski-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing a structural knowledge graph over a real codebase often produces node and edge types based on assumptions rather than verified code, leading to ontologies that drift from the actual architecture. This Skill guides an interactive, evidence-grounded design process for Neo4j-style knowledge graphs and their MCP tool layers, with a mandatory dry-run validation against real code before any ontology file is written. ## Core Features & Use Cases - Demand-driven ontology design: Collects the 5-10 real questions the graph must answer before proposing any node types, relationship triples, or properties. - Mandatory dry-run validation: Manually checks 2-3 real cascades in the actual codebase against declared triples and reports the outcome whether problems are found or the pass is clean. - MCP tool tiering: Maps each target question to a Tier-1 curated tool with typed parameters or an explicit Tier-0 read_cypher fallback, including what an empty result means for each tool. - Use Case: When extending the ECommerceApp knowledge graph (modules, endpoints, entities, Outbox/Inbox message flows), use this Skill to propose only the delta to the confirmed ontology, verify it against the code, and then update tools/kg/seed/ontology.json and .cypher files. ## Quick Start Ask the assistant to design a knowledge-graph ontology for this codebase that answers which modules break when a given message contract changes.

Frequently Asked Questions about kg-ontology-designer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a knowledge graph ontology from an existing codebase?

Start by listing the 5-10 real questions the graph must answer, then propose node types and relationship triples grounded in grepped code evidence. Before writing any ontology file, dry-run 2-3 real cascades against the declared triples and report the result.

How to model a Neo4j graph for microservices or bounded contexts?

Model modules or bounded contexts as nodes with endpoints, entities, and message flows as typed relationships, following a layered ontology pattern. Verify every convention-based claim in the actual repository rather than relying on generic architecture cheat sheets.

What is MCP tool tiering for knowledge graph queries?

Tool tiering maps each target question to either a Tier-1 curated tool with typed parameters and a one-line intent, or an explicit Tier-0 read_cypher escape hatch for open-ended queries. Each tool must define what an empty result means so callers can distinguish no data from a wrong question.

Why should derived facts not be stored as graph edges?

A derived or aggregatable fact stored as its own edge can drift from the edges it is computed from, creating inconsistency. Expose such facts as queries or tools instead, as demonstrated by the GetModuleDependencies worked example in the reference documentation.

When should I not use this ontology design skill?

Do not use it for querying an already-built graph; it is strictly for designing node and edge structure plus MCP tooling. It is also unsuitable when you cannot access the real codebase, since verify-before-trust and dry-run validation against actual code are non-negotiable steps.