Nexus-skills — インストール & ライブデモ

なぜ使うのか

主な機能

リポジトリごとに永続する .nexus-map/ ナレッジベース
ファイル構造、依存グラフ、import・呼び出し箇所の追跡
変更影響範囲のクエリ
インクリメンタル更新 — 変更されたファイルのみ再実行
ツール呼び出し対応の LLM がマップを利用して正確な質問に回答
Copilot、Cursor、Claude Code、汎用エージェントに対応

ライブデモ

実際の動作

nexus-skill.replay ▶ 準備完了

0/0

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方： Nexus-skills

不慣れなコードベースに素早くオンボーディングする方法

👤 新しいチームに参加するエンジニア、またはコードベースを引き継ぐチーム ⏱ ~60 min intermediate

使うタイミング： 初めて触るリポジトリの初日。変更を加える前にまず全体像を把握したいとき。

フロー

マップを構築する

Use nexus-skills to scan this repo and build .nexus-map/.✓ コピーしました

→ 進捗の出力とマップファイルの生成
全体像を把握する

Using .nexus-map, tell me: entry points, top 10 most-imported modules, and any orphaned files.✓ コピーしました

→ 実際のファイルに基づいたリポジトリ概要
サブシステムを深掘りする

Show me the payments subsystem — files, dependencies, external calls.✓ コピーしました

→ スコープを絞ったサブシステムビュー

結果： 1時間以内にリポジトリの事実に基づいたメンタルモデルが構築できます。

注意点

大規模マージ後にマップが古くなる — nexus update を再実行する（インクリメンタル更新）

コア関数を変更する前に影響範囲を確認する

👤 広く使われているユーティリティに手を入れようとしているエンジニア ⏱ ~30 min intermediate

使うタイミング： 関数のリネームやシグネチャ変更を行う前に、すべての呼び出し箇所を把握したいとき。

前提条件

.nexus-map/ が構築済みであること — リポジトリごとに一度実行すれば、以降はインクリメンタル更新のみ

フロー

影響範囲をクエリする

What calls formatCurrency(), and what would break if I change the signature to accept a locale?✓ コピーしました

→ 呼び出し箇所のリストと、各呼び出し元の想定される破損パターン
マイグレーションを生成する

Produce the minimal diff across all call sites to add the new locale param with a sensible default.✓ コピーしました

→ 複数ファイルにまたがるパッチ

結果： 影響範囲が明確で、差分が準備された状態で変更に臨めます。

デッドコードと未使用エクスポートを検出する

👤 リファクタリング前にコードを整理したいエンジニア ⏱ ~40 min intermediate

使うタイミング： リファクタリングの前に、本当に使われていないコードを把握したいとき。

フロー

マップをクエリする

Using .nexus-map, list files with no imports from elsewhere, and exports with no external references.✓ コピーしました

→ 信頼度付きのランク付けリスト
検証する

For the top 10 candidates, double-check by searching for string-based usage (reflection, dynamic imports).✓ コピーしました

→ 偽陽性の注釈付きフィルタリング済みリスト

結果： 実際にリリース可能なデッドコード削除リストが得られます。

注意点

動的インポートは静的解析ではデッドコードに見える — 削除前に必ず文字列ベースのスキャンを実行する

組み合わせ

他のMCPと組み合わせて10倍の力を

nexus-skill + claude-code-owasp-skill

セキュリティ影響クエリ：汚染された入力はどこに流れるか？

Using nexus-map, trace every call path from the /ingest endpoint into the DB layer. Then OWASP review those paths.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
build_map	repo_root	リポジトリごとに初回に一度実行	compute (local)
update_map	changed_files	大規模マージの後に実行	compute (local)
query_structure	question	構造に関する質問に回答するとき	Claude tokens
change_impact	symbol or file	破壊的変更を行う前	Claude tokens
dead_code	-	リファクタリング前のクリーンアップ時	Claude tokens

コストと制限

運用コスト

APIクォータ: なし
呼び出しあたりのトークン: マップ構築はローカル処理（高速）。クエリは Claude トークンを消費します
金額: 無料
ヒント: 一度構築すれば何度でもクエリ可能。リポジトリ構造が大きく変わったときのみ再構築してください。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： 認証情報は不要です。.nexus-map/ はデフォルトでローカルに保存されます。

データ送信先： マップ構築はローカルで完結します。クエリ時にはマップの一部が Claude に送信されます。

チームで共有する合意がない限り、.nexus-map/ を .gitignore に追加してください — コードベースの詳細なマップが含まれています。

トラブルシューティング

よくあるエラーと対処法

モノレポでマップ構築がクラッシュする

ルートではなくパッケージ単位で実行してください。nexus は scope フラグに対応しています

編集後にクエリが古い結果を返す

変更したファイルに対して nexus update を実行してください。インクリメンタル更新は低コストです

Language not recognized — 言語が認識されない

nexus のドキュメントで対応言語を確認してください。一部のフレームワークでは明示的なパーサーコンフィグが必要です

代替案

Nexus-skills 他との比較

代替案	代わりに使う場面	トレードオフ
SourceGraph / Cody	組織規模でホスト型コードインテリジェンスが必要な場合	有料。ローカルではない
tree-sitter + custom queries	完全な制御が必要な場合	構築時間が大幅に増加する

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る