MCP Server Builder
anthropics/skills
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
AST-based code graph for fast symbol lookup, dependency analysis, and blast radius via codebase-memory-mcp MCP server
Install Code Graph
$ npx skills add alinaqi/maggy --skill code-graph -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install alinaqi/maggy code-graph --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/code-graph .claude/skills/code-graph && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "code-graph" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/code-graph into .claude/skills/code-graph/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-graph", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/alinaqi/maggy/tree/main/skills/code-graphType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add alinaqi/maggy --skill code-graph -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install alinaqi/maggy code-graph --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/code-graph .agents/skills/code-graph && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "code-graph" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/code-graph into .agents/skills/code-graph/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-graph", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alinaqi/maggy --skill code-graph -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install alinaqi/maggy code-graph --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/code-graph .cursor/skills/code-graph && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "code-graph" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/code-graph into .cursor/skills/code-graph/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-graph", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/alinaqi/maggy.git --path skills/code-graph--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add alinaqi/maggy --skill code-graph -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install alinaqi/maggy code-graph --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/code-graph .gemini/skills/code-graph && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "code-graph" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/code-graph into .gemini/skills/code-graph/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-graph", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install alinaqi/maggy code-graphInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add alinaqi/maggy --skill code-graph -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/code-graph .github/skills/code-graph && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "code-graph" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/code-graph into .github/skills/code-graph/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-graph", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alinaqi/maggy --skill code-graph -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install alinaqi/maggy code-graph --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alinaqi/maggy.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/code-graph .opencode/skills/code-graph && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "code-graph" agent skill from https://github.com/alinaqi/maggy/tree/main/skills/code-graph into .opencode/skills/code-graph/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-graph", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
code-graph- GitHub stars
- 707
- Token cost
- ~2k tokens
- SKILL.md length
- 663 words
- Files
- 1
- Skills in repo
- 71
- Repo updated
- First seen
- Licence
- MIT
At a glance
AST-based code graph for fast symbol lookup, dependency analysis, and blast radius via codebase-memory-mcp MCP server
- Tasks that involve MCP servers
- SKILL.md covers Core Principle, When to Use Graph vs Direct Read, Available MCP Tools and Workflow: Before Any Code Change, plus 4 more sections
- Calls git
What it does
Code Graph is an agent skill from alinaqi/maggy. AST-based code graph for fast symbol lookup, dependency analysis, and blast radius via codebase-memory-mcp MCP server
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: What started as an opinionated Claude Code setup kit is now an autonomous AI engineering command center. The licence is MIT.
When your agent uses it
- Tasks that involve MCP servers
Example prompts
- “/code-graph”
What it can do on your machine
Read from SKILL.md and the folder at commit 72a456e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Code Graph loads about 2k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 663 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from alinaqi/maggy at commit 72a456e, republished under its MIT licence (© alinaqi). 663 words, ~2,033 tokens.
Download SKILL.mdSave it as
.claude/skills/code-graph/SKILL.md (or your agent's skills folder).- name
- code-graph
- description
- AST-based code graph for fast symbol lookup, dependency analysis, and blast radius via codebase-memory-mcp MCP server
- when-to-use
- Before reading files — query the graph first for symbol lookup, call tracing, and blast radius
- user-invocable
- false
- effort
- medium
Code Graph Skill
Purpose: Use the code graph (codebase-memory-mcp) for sub-millisecond symbol lookup, function search, dependency analysis, and blast radius detection. This replaces brute-force grep and file reading for code navigation.
Core Principle
Graph first, file second. Before reading files or grepping, query the code graph. Only read full files when you need to modify them or need context beyond what the graph provides.
Consider graph when planning. When planning any change — feature, refactor, bug fix — start by querying the graph to understand scope, dependencies, and blast radius. This applies to thinking and planning phases, not just implementation. Grep is still the right tool for searching string literals, log messages, config values, and content that lives outside code structure.
┌────────────────────────────────────────────────────────────────┐
│ GRAPH FIRST, FILE SECOND │
│ ─────────────────────────────────────────────────────────────│
│ The code graph indexes your entire codebase as a persistent │
│ knowledge graph. Claude queries it via MCP for instant │
│ symbol lookup, dependency chains, and blast radius — instead │
│ of reading hundreds of files. │
│ │
│ 14 MCP tools │ 64 languages │ sub-ms queries │ zero deps │
│ ~99% fewer tokens for navigation vs brute-force file reads │
├────────────────────────────────────────────────────────────────┤
│ AUTO-UPDATED │
│ ─────────────────────────────────────────────────────────────│
│ File watcher keeps graph in sync. Post-commit hook ensures │
│ freshness. No manual rebuild needed. │
└────────────────────────────────────────────────────────────────┘When to Use Graph vs Direct Read
| Task | Use Graph Tool | Use Direct Read? |
|---|---|---|
| Find function/class definition | search_graph | No |
| Get function signature + docs | get_code_snippet | No |
| Find all callers of a function | trace_call_path | No |
| Trace dependency chain | query_graph | No |
| Determine blast radius of change | detect_changes | No |
| Understand project architecture | get_architecture | No |
| Search for code patterns | search_code | No |
| Read full implementation to modify | search_graph to locate, then Read file | Yes |
| Understand business logic context | get_code_snippet for overview, then Read | Yes |
Rule: If a graph tool can answer the question, use it. Only open files when you need the full source to make edits.
Available MCP Tools
Indexing & Status
| Tool | Purpose | When to Use |
|---|---|---|
index_repository | Build/rebuild graph for a project | First setup, or after major restructure |
index_status | Check if graph is current | Before querying, if unsure of freshness |
list_projects | List all indexed projects | Multi-project navigation |
Querying & Navigation
| Tool | Purpose | When to Use |
|---|---|---|
search_graph | Find symbols by name (fuzzy) | "Find auth-related functions" |
search_code | Text search across indexed codebase | "Find TODO comments", pattern matching |
get_code_snippet | Get source code for a specific symbol | Need signature, docstring, implementation |
get_graph_schema | Understand graph structure and relationships | Exploring what data is available |
query_graph | Run structured graph queries | Complex dependency/relationship queries |
Analysis
| Tool | Purpose | When to Use |
|---|---|---|
trace_call_path | Trace caller/callee chains | "Who calls sendEmail?", "What does init() trigger?" |
detect_changes | Identify changed files and blast radius | Before/after code changes, PR review |
get_architecture | High-level module/package structure | Onboarding, understanding project layout |
Management
| Tool | Purpose | When to Use |
|---|---|---|
delete_project | Remove a project from the graph | Cleanup, project restructure |
manage_adr | Architecture decision records | Document architectural decisions |
ingest_traces | Import runtime traces | Performance analysis, dead code detection |
Show full SKILL.md (275 more words)Show less
Workflow: Before Any Code Change
0. PLAN → get_architecture + search_graph to understand scope before planning
1. LOCATE → search_graph to find the symbol
2. UNDERSTAND → get_code_snippet for context
3. BLAST → detect_changes to assess impact
4. TRACE → trace_call_path to find all affected callers
5. CHANGE → Read file, make edit
6. VERIFY → detect_changes again to confirm scopeStep 0 applies to planning, not just coding. When the user asks you to plan a feature, refactor, or fix — query the graph first to understand what exists, what depends on what, and what the scope looks like. This prevents plans based on wrong assumptions about the codebase.
Never skip step 3. Blast radius analysis prevents unexpected breakage from changes to shared code.
Graph Data & Freshness
The graph stays fresh automatically through 3 layers — no manual rebuild needed:
| Layer | Trigger | What Happens |
|---|---|---|
| File watcher | Every file save | codebase-memory-mcp detects changes and re-indexes affected files in real-time |
| Auto-index | Session start | auto_index: true ensures graph is current when Claude Code starts |
| Post-commit hook | Every git commit | Touches .code-graph/.needs-update marker — file watcher picks it up (~10ms, non-blocking) |
You do NOT need to manually re-index unless you do a major restructure
(rename entire directories, switch branches with massive diffs). In that
case: index_repository once, then the 3 layers keep it fresh.
- Storage:
.code-graph/directory (auto-created, gitignored) - MCP config:
.mcp.jsonat project root (committed, shared with team)
MCP Configuration
The code graph MCP server is configured in .mcp.json at project root:
{
"mcpServers": {
"codebase-memory": {
"command": "codebase-memory-mcp",
"args": []
}
}
}Installation: ~/.claude/install-graph-tools.sh
Decision Framework
Need to find a symbol/function?
→ search_graph (sub-ms, structured result)
→ NOT: grep -r "functionName" (slow, unstructured)
Need to understand dependencies?
→ query_graph or trace_call_path (complete, traversable)
→ NOT: manually reading import statements
Need to assess change impact?
→ detect_changes (comprehensive, instant)
→ NOT: searching for usages manually across files
Need to understand architecture?
→ get_architecture (high-level overview)
→ NOT: reading every directory listing
Need to read/modify code?
→ search_graph to locate, then Read the specific file
→ NOT: reading entire directories hoping to find itAnti-Patterns
| Anti-Pattern | Do This Instead |
|---|---|
| Grepping for function names | search_graph with the function name |
| Reading entire files to find a signature | get_code_snippet for the specific symbol |
| Manually tracing import chains | trace_call_path or query_graph |
| Making changes without checking impact | detect_changes before every edit to shared code |
| Reading all files in a directory | get_architecture for structure, search_graph for specifics |
| Ignoring graph staleness warnings | Check index_status, re-index if needed |
| Re-indexing on every query | Trust the file watcher; only manual re-index after major restructure |
© alinaqi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/code-graph of alinaqi/maggy.
Open the folder on GitHubat commit 72a456e
Compare with similar skills
Code Graph next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Code Graph this skillalinaqi/maggy | 707 | — | ~2k | Automated safety check: Pass | MIT | |
| MCP Server Builderanthropics/skills | 180k | 64 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| MCP Server BuildershareAI-lab/learn-claude-code | 78k | 5 repos | ~1.2k | Automated safety check: Pass | MIT | |
| MCP Integration for Pluginsanthropics/claude-plugins-official | 38k | 11 repos | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Fastmcp Client CLIPrefectHQ/fastmcp | 28k | 1 repos | ~823 | Automated safety check: Pass | Apache-2.0 | |
| Crush Configurationcharmbracelet/crush | 29k | — | ~3.7k | Automated safety check: Pass | Custom licence |
Similar skills
- Official
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
- Official
MCP Integration for Plugins
anthropics/claude-plugins-official
Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.
Fastmcp Client CLI
PrefectHQ/fastmcp
Query and invoke tools on MCP servers using fastmcp list and fastmcp call.
Crush Configuration
charmbracelet/crush
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
Context Mode Output Sandbox
mksglu/context-mode
Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.
More from alinaqi/maggy
All 71 skills in this repoAI Models
alinaqi/maggy
Latest AI models reference - Claude, OpenAI, Gemini, Eleven Labs, Replicate
Azure Cosmosdb
alinaqi/maggy
Azure Cosmos DB partition keys, consistency levels, change feed, SDK patterns
LLM Patterns
alinaqi/maggy
AI-first application patterns, LLM testing, prompt management
Woocommerce
alinaqi/maggy
WooCommerce REST API - products, orders, customers, webhooks
Aeo Optimization
alinaqi/maggy
AI Engine Optimization - semantic triples, page templates, content clusters for AI citations
Agent Teams
alinaqi/maggy
Claude Code Agent Teams - default team-based development with strict TDD pipeline enforcement
Related
Works with
Categories
Questions about Code Graph
What does Code Graph do?
AST-based code graph for fast symbol lookup, dependency analysis, and blast radius via codebase-memory-mcp MCP server. Code Graph is an agent skill from alinaqi/maggy.
When should I use Code Graph?
Code Graph fits situations like: tasks that involve MCP servers.
How do I install Code Graph in Claude Code?
Run `npx skills add alinaqi/maggy --skill code-graph -a claude-code`. Or copy the skill folder (skills/code-graph in alinaqi/maggy) into .claude/skills/code-graph in your project. Claude Code loads it when a task matches its description.
How do I install Code Graph in Codex?
Run `npx skills add alinaqi/maggy --skill code-graph -a codex`. Or copy the skill folder (skills/code-graph in alinaqi/maggy) into .agents/skills/code-graph in your project. Codex loads it when a task matches its description.
Can I use Code Graph in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alinaqi/maggy --skill code-graph -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-graph, .gemini/skills/code-graph, .github/skills/code-graph and .opencode/skills/code-graph in your project.
What does Code Graph need to run?
Going by SKILL.md and its folder, Code Graph needs the command-line tools its instructions call (git).
Does Code Graph access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Code Graph safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Code Graph use?
Code Graph is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Code Graph use?
About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Code Graph?
Skills that share tags, products or a category with Code Graph: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Code Graph?
alinaqi (a GitHub user) maintains it in alinaqi/maggy, which has 707 GitHub stars. The repository holds 71 skills in this directory. The repository was last updated on September 24, 2026.
Source: alinaqi/maggy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.