Nexus-skills — Instalar & Demo ao vivo

Por que usar

Principais recursos

Persistent .nexus-map/ knowledge base per repo
File structure, dependency graph, import + call-site tracking
Change-impact radius queries
Incremental updates — re-run only on changed files
Tool-calling LLMs consume the map to answer precise questions
Works with Copilot, Cursor, Claude Code, and generic agents

Demo ao vivo

Como fica na prática

nexus-skill.replay ▶ pronto

0/0

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: Nexus-skills

How to onboard to an unfamiliar codebase fast

👤 Engineers joining a new team or team inheriting a codebase ⏱ ~60 min intermediate

Quando usar: Day one in a repo you've never seen; you want a map before making changes.

Fluxo

Build the map

Use nexus-skills to scan this repo and build .nexus-map/.✓ Copiado

→ Progress output + map files produced
Get the tour

Using .nexus-map, tell me: entry points, top 10 most-imported modules, and any orphaned files.✓ Copiado

→ Repo overview keyed to actual files
Dig into a subsystem

Show me the payments subsystem — files, dependencies, external calls.✓ Copiado

→ Scoped subsystem view

Resultado: A factual mental model of the repo built in under an hour.

Armadilhas

Map goes stale after big merges — Re-run nexus update; it's incremental

Check blast radius before changing a core function

👤 Engineers about to touch a widely-used utility ⏱ ~30 min intermediate

Quando usar: You're about to rename or change the signature of a function and want to see every call site.

Pré-requisitos

.nexus-map/ already built — Run once per repo; incremental after

Fluxo

Query impact

What calls formatCurrency(), and what would break if I change the signature to accept a locale?✓ Copiado

→ Call-site list with each caller's likely break mode
Generate migration

Produce the minimal diff across all call sites to add the new locale param with a sensible default.✓ Copiado

→ Multi-file patch

Resultado: A change with known blast radius and a prepared diff.

Find dead code and unused exports

👤 Engineers cleaning up before a refactor ⏱ ~40 min intermediate

Quando usar: Before a refactor you want to know what's truly unused.

Fluxo

Query map

Using .nexus-map, list files with no imports from elsewhere, and exports with no external references.✓ Copiado

→ Ranked list with confidence per finding
Verify

For the top 10 candidates, double-check by searching for string-based usage (reflection, dynamic imports).✓ Copiado

→ Filtered list with false-positive caveats

Resultado: A dead-code delete list you can actually ship.

Armadilhas

Dynamic imports look dead statically — Always run the string-based sweep before deleting

Combinações

Combine com outros MCPs para 10× de alavancagem

nexus-skill + claude-code-owasp-skill

Security-impact queries: where does tainted input flow?

Using nexus-map, trace every call path from the /ingest endpoint into the DB layer. Then OWASP review those paths.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
build_map	repo_root	Once per repo initially	compute (local)
update_map	changed_files	After large merges	compute (local)
query_structure	question	Answering structure questions	Claude tokens
change_impact	symbol or file	Before breaking changes	Claude tokens
dead_code	-	Pre-refactor cleanup	Claude tokens

Custo e limites

O que custa rodar

Cota de API: None
Tokens por chamada: Map build is local compute (fast); queries consume Claude tokens
Monetário: Free
Dica: Build once, query often. Re-build only when repo shape changes materially.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials. .nexus-map/ is local by default.

Saída de dados: Map building is local. Querying sends map snippets to Claude.

Add .nexus-map/ to .gitignore unless your team agrees to share it — it's a detailed map of the codebase.

Solução de problemas

Erros comuns e correções

Map build crashes on monorepos

Run per-package rather than on the root; nexus supports a scope flag

Queries return stale results after edits

Run nexus update on the changed files; incremental is cheap

Language not recognized

Check supported languages in nexus docs; some frameworks need explicit parser config

Alternativas

Nexus-skills vs. outros

Alternativa	Quando usar	Troca
SourceGraph / Cody	You need hosted code intelligence at org scale	Paid; not local
tree-sitter + custom queries	You want full control	Much more build time

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills