Nexus Query — Code Structure Lookup
One-command code structure and blast-radius queries to run before you refactor anything.
Dev & CodingIntermediate★ 164⑂ 15AI score 9/10Last updated: Mar 31, 2026
What it does
It extracts your repo into ast_nodes.json and answers structural questions instantly through five query modes:
--file: file skeleton (classes, methods, line numbers, imports)--who-imports: every file importing a module, split into source vs. tests--impact: blast radius asX upstream, Y downstream--hub-analysis: real high-coupling hubs ranked by fan-in/fan-out--summary: structural digest aggregated by top-level directory
Optional git_detective.py adds change-frequency risk data, and .gitignore / --exclude-dirs keep generated and vendored noise out of the graph.
Who it's for
- Developers who want the caller list before changing an interface or signature
- Anyone inheriting a large or unfamiliar legacy codebase
- Tech leads sizing sprint work or prioritizing technical debt with real numbers
Examples
- "What breaks if I delete this interface?" →
--who-importsfor the caller list, then--impactfor the ripple chain. - "Is this change local surgery or full-body surgery?" →
--impact <path> --git-statsshows downstream count plus git hotness. - "Which module is the dangerous center of this repo?" →
--hub-analysis --top 10surfaces actual coupling hubs instead of guessing from folder names.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/Haaaiawd/Nexus-skills/HEAD/skills/nexus-query/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/nexus-query folder from the GitHub repo Haaaiawd/Nexus-skills into my ~/.claude/skills/nexus-query/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/Haaaiawd/Nexus-skills.git /tmp/nexus-skills && mkdir -p ~/.claude/skills && cp -r /tmp/nexus-skills/skills/nexus-query ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Confirm Python 3.10+ is installed locally:
python3 --version - Clone the repo:
git clone https://github.com/Haaaiawd/Nexus-skills.git - Copy the skill into your Claude skills folder:
mkdir -p ~/.claude/skills && cp -r Nexus-skills/skills/nexus-query ~/.claude/skills/ - Install dependencies:
pip install -r ~/.claude/skills/nexus-query/scripts/requirements.txt - Restart Claude Code, then ask something like "who depends on this module?" to confirm the skill triggers.
- On first run, if no AST exists,
extract_ast.pywill generate.nexus-map/raw/ast_nodes.json(takes a few seconds).