
Claude Code skill: a local code map (graphify, AST, no LLM) so Claude stops re-reading your whole
Claude Code skill: a local code map (graphify, AST, no LLM) so Claude stops re-reading your whole project. Fewer tokens per question.
·
token gives Claude Code a code map of your project and a rule to ask the map first, so it stops grepping and reading file after file every time you ask "where does X happen?".
The map is built locally by graphify from the AST (tree-sitter, 30 languages). No LLM calls, no API key, nothing leaves your machine. Building a map takes seconds.
/tokenmap: 63 nodes · 176 edges · 8 communities · graph.json 48 KB
tokens: GRAPH_REPORT.md ≈ 651 · raw source ≈ 21551 · query output typically 0.5–4k
freshness: up to date
CLAUDE.md: token rule written → ./CLAUDE.mdOn a code-navigation question, Claude usually explores: grep, open a file, open three more, repeat. On a mid-sized project that can easily be 100k+ tokens of raw source before it answers. A graph query returns the relevant symbols, files and line numbers in a few hundred to a few thousand tokens, and Claude then opens only those lines.
Measured example (one "how does this flow work" question on a real project): ~169k tokens of exploration → ~2.9k tokens with the map.
Savings depend on the task. They are large for "where / what calls this / how does the flow go" questions and small for a one-line fix in a file you already have open.
Running /token in a project:
uv tool install, then pipx, then a private venv in ~/.local/share/token-skill/venv. No sudo.graphify-out/ (AST only). Files with a code extension but an XML body (Tiled tilesets etc.) are added to .graphifyignore first, because they break parsing.CLAUDE.md, in a marked, idempotent block: for code questions, run graphify query before the first grep/read, never cat the whole graph.json, and update the map after changing code.Optional --strict mode installs a Claude Code PreToolUse hook that blocks the first raw file read in a session until a graph query has run.
Requirements: macOS, Linux or Windows (Git Bash or WSL), bash, Python 3.10+, internet for the first install.
git clone https://github.com/WebitroHQ/token-skill.git
bash token-skill/token/scripts/install.shThe install copies the skill to ~/.claude/skills/token/ and sets up graphify. The last line should be ready: type /token in Claude Code. Then restart Claude Code, because skills load at session start.
Check:
~/.local/bin/graphify --version && ls ~/.claude/skills/token/SKILL.md ~/.claude/skills/graphify/SKILL.mdIf graphify is not found, add export PATH="$HOME/.local/bin:$PATH" to your shell profile.
In Claude Code, inside a project:
| You say | What happens |
|---|---|
/token | install/verify, build or update the map, write the CLAUDE.md rule, report |
/token from scratch | full rebuild (--force) |
/token strict | also install the blocking hook |
After that you just ask code questions as usual; the CLAUDE.md rule makes Claude query the map first.
The script also works on its own:
T=~/.claude/skills/token/scripts/token.sh
bash $T status [path] # exists? fresh? token summary (exit 2 = no map, 4 = stale)
bash $T build [path] [--force] # build/update the map
bash $T query "how is auth checked" [path]
bash $T install-project [path] [--strict]~/.claude/skills/token/: this skill~/.claude/skills/graphify/ and a 4-line # graphify block at the end of ~/.claude/CLAUDE.md (added by graphify's own installer)~/.local/bin/graphify (+ graphify-mcp), and ~/.local/share/token-skill/venv if the venv route was usedgraphify-out/ (commit it or add it to .gitignore), .graphifyignore, and the marked block in CLAUDE.mdqueue.advance()). Dart (Flutter) gets definitions and imports only, no call edges at all, so "what happens when X runs" questions don't benefit there. The map still tells Claude which file a class or function lives in.vite.config.ts). graphify warns about them, and they still need a raw read.token.sh query checks this before every query and updates the map first if any code file is newer (seconds on small projects). Tested: rename a function and move its caller to a new file without rebuilding. Before the fix, graphify query answered confidently with the old name and old file:line. With the check, the answer comes back with the new name and correct locations. Calling graphify query directly skips this check.rm -rf ~/.claude/skills/token ~/.local/share/token-skill
uv tool uninstall graphifyy # or: pipx uninstall graphifyyThen remove the # >>> token-skill block from any project CLAUDE.md and delete graphify-out/.
The map itself is graphify (Apache-2.0). This repo is a thin, deterministic wrapper around it for Claude Code, made by Webitro.
Webitro is a custom software studio. We build AI agents, chatbots, automation and e-commerce systems, and we design custom skills and command sets for teams using Claude Code. If you want a skill tailored to your own workflow, get in touch.
This repo does not document an install step we could read. Check the README on GitHub.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/token-skill to learn what the "Token Skill" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/token-skill)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "token-skill" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.