agnix について
agnixは、エージェント設定ファイルを検査するコマンドラインリンターです。複数のコーディング・エージェントツールを使うチーム向けに、スキル、フック、MCP、メモリ、プラグイン設定を確認し、安全な修正を適用または事前表示します。
主な機能
- 01エージェント設定ファイルの検査
- 02スキル、フック、MCP、メモリの検証
- 03対象のコーディングツールを指定
- 04安全な修正の適用・プレビュー
- 05ファイル監視とJSON出力
活用シーン
- 01ワークフロー変更前の設定確認
- 02MCP設定ファイルの検証
- 03スキル名や起動条件の問題発見
- 04プロジェクト内の修正を事前確認
MCP 対応
agnixはエージェント設定のリンティングで、*.mcp.jsonなどのMCP設定ファイルを検証します。MCPサーバーやクライアントではありません。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ agent-sh/ agnix --skill agnixインストール後、Claude Code で/agnixを入力して読み込まれたか確認します。
詳細
agnix
ワークフローに支障が出る前に、Claude Code、Codex CLI、OpenCode、Kiro、Cursor、GitHub Copilot などのツールでエージェント設定(スキル、フック、MCP、メモリ、プラグイン)をリントします。
実行
agnix --versionを実行します。インストールされていない場合は、npm install -g agnixまたはcargo install agnix-cliでインストールします。agnix .(またはユーザーが指定したパス)を実行します。- ユーザーが修正を依頼した場合は、
agnix --fix .を実行し、続けて手順 2 をもう一度実行して、残っている問題を確認します。それ以外の場合はファイルを変更せず、agnix --dry-run .で修正内容をプレビューします。
CLI リファレンス
| コマンド | 説明 |
|---|---|
agnix . | 現在のプロジェクトを検証します |
agnix --fix . | 安全な自動修正を適用します |
agnix --dry-run . | 変更せずに、修正される内容を表示します |
agnix --strict . | 警告をエラーとして扱います |
agnix --target claude-code . | 対象ツールを指定します:generic(デフォルト)、claude-code、cursor、codex、kiro |
agnix --watch . | ウォッチモード |
agnix --format json . | JSON 出力 |
対応ファイル
| ファイルの種類 | 例 |
|---|---|
| スキル | SKILL.md |
| メモリ | CLAUDE.md、AGENTS.md |
| フック | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
出力
CLAUDE.md:15:1 warning: Generic instruction 'Be helpful' [fixable]
help: Remove generic instructions. Claude already knows this.
skills/review/SKILL.md:3:1 error: Invalid name [fixable]
help: Use lowercase letters and hyphens only
Found 1 error, 1 warning (2 fixable)
よくある修正
| 問題 | 解決策 |
|---|---|
| スキル名が無効 | 小文字とハイフンを使用します:my-skill |
| 汎用的な指示 | 「be helpful」「be accurate」を削除します |
| トリガーフレーズがない | 説明に「Use when...」を追加します |
| ディレクトリ名と名前が一致しない | name: フィールドに合わせてディレクトリ名を変更します |
リンク
コメント
Markdown 対応