Name: CodeGraph-first code exploration
Author: metaphy6

Instruction file imported from metaphy6/knowoff (.github/instructions/codegraph.instructions.md). Copyright stays with the author.

CodeGraph-first exploration

This repository is indexed by CodeGraph. For any question about source code — how a symbol works, where it is defined, what calls it, or what it affects — use the appropriate mcp_codegraph_* tool first:

Intent	Tool
"How does X work?" / surveying an area	`mcp_codegraph_explore`
"Where is the symbol named X?"	`mcp_codegraph_search`
"What calls this?" / blast radius	`mcp_codegraph_callers`
"What is this symbol — source + caller/callee trail?"	`mcp_codegraph_node`
Reading an indexed source file	`mcp_codegraph_node` with `file=...`

Do not start with read_file or grep_search for symbol lookup, call-graph questions, or understanding how code works. Fall back to raw reads/searches only for files CodeGraph does not index (configs, docs, build scripts), or when a tool response flags the file as stale.

Trust CodeGraph results — they come from a full AST parse. Re-index via make codeg when the index is stale or missing; record the re-index as a tracking note. Full procedure: codegraph-management skill.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Install CodeGraph-first code exploration and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "metaphy6-knowoff-codegraph-instructions", "kind": "skill", "name": "CodeGraph-first code exploration", "description": "Use CodeGraph as the first tool for code questions in this repo", "publisher": "metaphy6", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use CodeGraph as the first tool for code questions in this repo" ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/metaphy6/knowoff", "path": ".github/instructions/codegraph.instructions.md", "ref": "bf858ad3adaf0d7cc029ab191e3a63cf2b2d2c04", "url": "https://github.com/metaphy6/knowoff/blob/bf858ad3adaf0d7cc029ab191e3a63cf2b2d2c04/.github/instructions/codegraph.instructions.md", "key": "metaphy6/knowoff/.github/instructions/codegraph.instructions.md" }, "applies_to": "**/*.{go,dart,py,sh}" }, "instructions": "# CodeGraph-first exploration\n\nThis repository is indexed by CodeGraph. For any question about source code —\nhow a symbol works, where it is defined, what calls it, or what it affects —\nuse the appropriate `mcp_codegraph_*` tool first:\n\n| Intent | Tool |\n|---|---|\n| \"How does X work?\" / surveying an area | `mcp_codegraph_explore` |\n| \"Where is the symbol named X?\" | `mcp_codegraph_search` |\n| \"What calls this?\" / blast radius | `mcp_codegraph_callers` |\n| \"What is this symbol — source + caller/callee trail?\" | `mcp_codegraph_node` |\n| Reading an indexed source file | `mcp_codegraph_node` with ", "cost": { "context_tokens": 287 } }

CodeGraph-first code exploration

About

CodeGraph-first exploration

Use it

Install CodeGraph-first code exploration and it becomes one more candidate the router can pick - when it fits.

Manifest

Reviews