jpskill.com
🛠️ 開発・MCP コミュニティ

config-auditing

Neovim configuration audit knowledge base. Use when: reviewing config files for issues, checking deprecated APIs, optimizing settings, or performing health checks. Provides checklists, best practices, and version-specific deprecated API detection patterns.

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o config-auditing.zip https://jpskill.com/download/17540.zip && unzip -o config-auditing.zip && rm config-auditing.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/17540.zip -OutFile "$d\config-auditing.zip"; Expand-Archive "$d\config-auditing.zip" -DestinationPath $d -Force; ri "$d\config-auditing.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して config-auditing.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → config-auditing フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Neovim 設定監査スキル

Neovim の設定における問題点、最適化、および非推奨 API の使用を特定するための体系的な設定分析。

関連ドキュメント

ドキュメント 目的 使用するタイミング
audit-checklist.md 検出パターンを含む構造化された監査カテゴリ 体系的な設定レビュー
best-practices.md lazy.nvim のパターン、vim.opt の使用法、キーマップの規則 最適化の提案
deprecated-apis.md grep パターンを含むバージョン固有の非推奨 API 互換性チェック

クイック検証コマンド

迅速な評価のために、これらのヘッドレスコマンドを実行します。

# Neovim のバージョンを取得
nvim --version | head -1

# 設定ファイルのパスを取得
nvim --headless -c "lua print(vim.fn.stdpath('config'))" -c "qa" 2>&1

# 設定ファイル内の Lua ファイル数をカウント
find ~/.config/nvim -name "*.lua" 2>/dev/null | wc -l

# プラグイン数をカウント (lazy.nvim)
ls ~/.local/share/nvim/lazy 2>/dev/null | wc -l

# 非推奨の vim.api.nvim_buf_set_option の使用をチェック
grep -rn "nvim_buf_set_option\|nvim_win_set_option" ~/.config/nvim --include="*.lua" 2>/dev/null | head -10

# 起動時間をチェック
nvim --startuptime /tmp/nvim-startup.log +q && tail -5 /tmp/nvim-startup.log

# 設定ファイル内の Lua 構文を検証
nvim --headless -c "lua dofile(vim.fn.stdpath('config')..'/init.lua')" -c "qa" 2>&1

# 起動時のエラーをチェック
nvim --headless -c "qa" 2>&1 | head -20

採点基準

問題の重大度と数に基づいてグレードを割り当てます。

グレード 基準 説明
A 重大度: 0件、警告: 0-2件 優秀 - 本番環境対応
B 重大度: 0件、警告: 3-5件 良好 - 改善の余地あり
C 重大度: 0件、警告: 6件以上 OR 重大度: 1件 許容範囲 - 注意が必要
D 重大な問題: 2-3件 不良 - 重大な問題あり
F 重大な問題: 4件以上 不合格 - 直ちに修正が必要

問題の重大度の定義

重大: セキュリティリスク、破壊的な非推奨 API (現在のバージョンで削除済み)、ランタイムエラー 警告: パフォーマンスの問題、非推奨 API (まだ動作する)、コーディングスタイルの違反 提案: オプションの改善、最新の代替手段、構成のヒント

監査ワークフロー

  1. 環境情報を収集

    • Neovim のバージョン (適用される非推奨 API を決定)
    • プラグインマネージャーの種類 (lazy.nvim, packer.nvim など)
    • 設定ファイルの構造 (単一ファイル vs モジュール式)

  2. カテゴリ監査を実行

    • audit-checklist.md のカテゴリ順に従う
    • grep パターンを使用して問題をプログラムで検出
    • 各発見事項の重大度を記録

  3. バージョンの互換性を確認

    • ユーザーの Neovim バージョンについて deprecated-apis.md を参照
    • そのバージョンで非推奨または削除された API にフラグを立てる

  4. ベストプラクティスを適用

  5. グレードを計算

    • 重大/警告/提案の問題をカウント
    • 上記の採点基準を適用
    • 全体的な健全性評価を提供する

出力テンプレート

<audit_report>
## Summary
- **Grade**: [A-F]
- **Neovim Version**: [検出されたバージョン]
- **Config Location**: [パス]
- **Plugin Count**: [数]

## Critical Issues
[ファイル:行 と修正を含む各重大な問題をリスト]

## Warnings
[ファイル:行 と推奨事項を含む各警告をリスト]

## Suggestions
[オプションの改善をリスト]

## Statistics
| Metric | Value |
|--------|-------|
| Total Lua files | X |
| Total lines | Y |
| Plugins | Z |
| Startup time | Nms |
| Deprecated APIs | N |
</audit_report>
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Neovim Configuration Auditing Skill

Systematic configuration analysis for identifying issues, optimizations, and deprecated API usage in Neovim setups.

Supporting Documents

Document Purpose When to Use
audit-checklist.md Structured audit categories with detection patterns Systematic config review
best-practices.md lazy.nvim patterns, vim.opt usage, keymap conventions Optimization suggestions
deprecated-apis.md Version-specific deprecated APIs with grep patterns Compatibility checks

Quick Validation Commands

Run these headless commands for rapid assessment:

# Get Neovim version
nvim --version | head -1

# Get config path
nvim --headless -c "lua print(vim.fn.stdpath('config'))" -c "qa" 2>&1

# Count Lua files in config
find ~/.config/nvim -name "*.lua" 2>/dev/null | wc -l

# Count plugins (lazy.nvim)
ls ~/.local/share/nvim/lazy 2>/dev/null | wc -l

# Check for deprecated vim.api.nvim_buf_set_option usage
grep -rn "nvim_buf_set_option\|nvim_win_set_option" ~/.config/nvim --include="*.lua" 2>/dev/null | head -10

# Check startup time
nvim --startuptime /tmp/nvim-startup.log +q && tail -5 /tmp/nvim-startup.log

# Validate Lua syntax in config
nvim --headless -c "lua dofile(vim.fn.stdpath('config')..'/init.lua')" -c "qa" 2>&1

# Check for error on startup
nvim --headless -c "qa" 2>&1 | head -20

Scoring Criteria

Assign grades based on issue severity and count:

Grade Criteria Description
A 0 Critical, 0-2 Warnings Excellent - Production ready
B 0 Critical, 3-5 Warnings Good - Minor improvements possible
C 0 Critical, 6+ Warnings OR 1 Critical Acceptable - Needs attention
D 2-3 Critical issues Poor - Significant problems
F 4+ Critical issues Failing - Requires immediate fixes

Issue Severity Definitions

Critical: Security risks, breaking deprecated APIs (removed in current version), runtime errors Warning: Performance issues, deprecated APIs (still working), code style violations Suggestion: Optional improvements, modern alternatives, organization tips

Audit Workflow

  1. Gather Environment Info

    • Neovim version (determines which deprecated APIs apply)
    • Plugin manager type (lazy.nvim, packer.nvim, etc.)
    • Config structure (single file vs modular)

  2. Run Category Audits

    • Follow audit-checklist.md categories in order
    • Use grep patterns to detect issues programmatically
    • Note severity for each finding

  3. Check Version Compatibility

    • Reference deprecated-apis.md for user's Neovim version
    • Flag APIs deprecated OR removed in their version

  4. Apply Best Practices

  5. Calculate Grade

    • Count Critical/Warning/Suggestion issues
    • Apply scoring criteria above
    • Provide overall health assessment

Output Template

<audit_report>
## Summary
- **Grade**: [A-F]
- **Neovim Version**: [detected version]
- **Config Location**: [path]
- **Plugin Count**: [count]

## Critical Issues
[List each critical issue with file:line and fix]

## Warnings
[List each warning with file:line and recommendation]

## Suggestions
[List optional improvements]

## Statistics
| Metric | Value |
|--------|-------|
| Total Lua files | X |
| Total lines | Y |
| Plugins | Z |
| Startup time | Nms |
| Deprecated APIs | N |
</audit_report>