using-nvim
Reference Warren's Neovim configuration (~/.config/nvim) with LSP, plugins, and directory structure.
When & Why to Use This Skill
This Claude skill enables the agent to access and interpret a specific Neovim configuration environment. By analyzing the ~/.config/nvim directory—including LSP settings, plugin specifications via lazy.nvim, and custom Lua scripts—it ensures that technical support and coding assistance are perfectly aligned with the user's actual development setup rather than generic assumptions.
Use Cases
- Configuration Debugging: Identify and resolve errors within init.lua or plugin-specific files by analyzing the actual directory structure and load order.
- LSP & Environment Tuning: Tailor Python development workflows by referencing existing Pyright settings, extraPaths, and virtual environment detection logic.
- Plugin Management: Receive guidance on adding, removing, or updating plugins while maintaining consistency with the current lazy.nvim architecture.
- Environment Documentation: Generate explanations or documentation for custom helper utilities and directory structures within the Neovim setup for better maintainability.
| name | "Using Nvim" |
|---|---|
| description | "Reference Warren's Neovim configuration (~/.config/nvim) with LSP, plugins, and directory structure." |
Using Nvim
Warren's Neovim: ~/.config/nvim
Critical Rule
BEFORE answering Neovim questions:
- Read config files from ~/.config/nvim/
- Understand Warren's setup, plugins, settings
- Base answers on actual config, not assumptions
Directory Structure
~/.config/nvim/
├── init.lua # Entry point
├── lua/
│ ├── plugins/ # Plugin configs
│ │ ├── lsp.lua # LSP (pyright)
│ │ ├── treesitter.lua # Syntax
│ │ └── telescope.lua # Fuzzy finder
│ ├── config/ # Custom settings
│ └── utils/ # Helpers
└── after/ # After-load
Standard Directories
- Config: ~/.config/nvim/
- Data: ~/.local/share/nvim/ (plugins, state, shada)
- Cache: ~/.cache/nvim/ (temp, swap)
- State: ~/.local/state/nvim/ (persistent)
LSP & Plugins
- Python LSP: pyright (in lua/plugins/lsp.lua)
- Auto venv: checks venv/, .venv/, env/, virtualenv/, $VIRTUAL_ENV
- Custom paths: pyrightconfig.json with
extraPaths: ["."] - Plugin specs: lua/plugins/*.lua (lazy.nvim)
- Plugin data: ~/.local/share/nvim/lazy/