hashgraph-online/awesome-codex-plugins / plugins/0xsarwagya/ontoly-codex-plugin/skills/ontoly-software-graph
ontoly-software-graph
UnverifiedUse Ontoly Software Graph evidence, CLI reports, MCP, and official Ontoly Agent Skills before searching source files when reviewing architecture, dependencies, request flows, configuration, impact, or security-sensitive ownership in JavaScript, TypeScript, Python, or Go repositories.
Ontoly Software Graph
Use this skill when the user asks Codex to understand a JavaScript, TypeScript, Python, or Go repository's architecture, dependency graph, request flow, service ownership, configuration usage, impact radius, package topology, or security-sensitive code paths.
Ontoly is a deterministic Software Graph compiler. It does not answer questions with AI. It builds graph evidence that Codex can query before falling back to source search.
Workflow
-
Check whether a graph exists:
ontoly-output/SoftwareGraph.json(written byontoly build) or.ontoly/SoftwareGraph.json(written byontoly analyze). Queries read whichever is newer. -
If the graph is missing or stale, ask before installing dependencies or writing generated graph files. Then run:
pnpm add -D @0xsarwagya/ontoly-cli pnpm ontoly build . -
Inspect graph quality before answering:
pnpm ontoly coverage . pnpm ontoly stats . -
Prefer Ontoly graph queries before repository-wide source search:
pnpm ontoly evidence "<question>" pnpm ontoly search <concept> pnpm ontoly architecture --json pnpm ontoly impact <node-id-or-query> pnpm ontoly trace <node-id-or-name> pnpm ontoly report routes --format markdown -
Start Ontoly MCP when the environment supports MCP-backed tools:
pnpm ontoly mcp -
Use source files only when the graph is missing, stale, low confidence, or insufficient for the question.
Common Questions
- "Explain this repository."
- "Which service owns authentication?"
- "Trace the login flow."
- "What breaks if I remove this repository/service/function?"
- "Which packages depend on this module?"
- "Where is this environment variable read?"
- "Which routes are protected by auth?"
Evidence Rules
When answering, cite graph evidence:
- graph hash
- node ids
- relationship types
- source spans when available
- diagnostics or confidence warnings
- fallback reason if source files were inspected
Never claim certainty beyond Ontoly evidence. If graph coverage is incomplete, say exactly which part is inferred or unresolved.
Official Ontoly Skills
Ontoly publishes 14 task-specific Agent Skills in its own repository: architecture-review, codebase-onboarding, configuration-analysis, dead-code-analysis, dependency-analysis, documentation, framework-analysis, impact-analysis, migration-analysis, performance-analysis, refactoring, request-tracing, sdk-generation, and security-review. To inspect or install them with the open skills CLI:
npx skills add 0xsarwagya/ontoly --list
npx skills add 0xsarwagya/ontoly --skill impact-analysis
Use those official skills when the task maps directly to one of their workflows.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |