Ontoly software graph

Skill mxyhi/ok-skills/ontoly-software-graph

Curated AI coding agent skills and AGENTS.md playbooks for Codex, Claude Code, Cursor, OpenClaw, and other SKILL.md-compatible tools.

Install

npx -y skills add mxyhi/ok-skills --skill ontoly-software-graph

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Use Ontoly's deterministic Software Graph and MCP capabilities for repository architecture, request tracing, dependency analysis, configuration lookup, and impact analysis before falling back to source search.

SKILL.md

2.7 KB, as published. Nobody here has run it

Ontoly Software Graph

Use this skill when a coding agent needs graph-backed understanding of a TypeScript repository. Ontoly is the source of truth; the skill only teaches the workflow.

When to Use

Explain repository architecture or package/module topology
Trace a route, controller, service, function, or dependency path
Find services, controllers, providers, modules, routes, configuration, or environment variables
Estimate impact before refactoring or deleting code
Audit unresolved imports, circular dependencies, dead code, semantic coverage, or graph quality
Produce onboarding, documentation, or architecture-review notes with deterministic evidence

Workflow

Check whether an Ontoly graph already exists: .ontoly/, SoftwareGraph.json, diagnostics.json, validation reports, graph hash, or MCP setup.
If the graph is missing and local analysis is allowed, run:
```
ontoly build .
```
Inspect graph health before answering: diagnostics, graph hash, semantic coverage, trust or quality score, framework detection, and build timestamp.
Prefer Ontoly CLI or MCP capabilities over repository search for graph-answerable questions.
Search source files only when Ontoly cannot answer, the graph is stale or incomplete, or the user explicitly asks for file-level verification.
Always cite graph evidence: node IDs, edge types, file paths, source locations, diagnostics, framework analyzer output, and confidence.

Capability Map

Architecture review: ExplainArchitecture
Dependency analysis: FindDependencies
Impact analysis: ImpactAnalysis
Request tracing: TraceExecution
Configuration analysis: FindConfigurationUsage
Framework analysis: FrameworkReport
Dead-code review: FindDeadCode

Response Pattern

Return the direct answer first, then evidence:

AuthController handles authentication.

Evidence:
- node: class:src/auth/auth.controller.ts:AuthController
- route edges: HANDLES POST /login and POST /logout
- dependency edges: USES AuthService and JwtService

Confidence: high, because the graph has controller, route, and dependency edges with source locations.

Fallbacks

If the graph is missing, build it first when allowed.
If validation fails, report the graph issue and verify only the affected area with source search.
If several nodes match, show candidates with package/module context.
If nothing matches, return NOT_FOUND with the closest graph evidence instead of inventing an answer.