Professional Neovim Configuration Setup

This skill helps you set up and configure a professional-grade Neovim development environment based on the youshyee/nvim configuration, featuring comprehensive language support, LSP integration, and productivity-enhancing plugins.

What This Skill Does

Sets up a complete Neovim development environment with:

Multi-language LSP support (Python, TypeScript, Go, Lua, C/C++, LaTeX, and more)

Modern plugin management with vim-plug

Intelligent code completion via CoC (Conquer of Completion)

Git integration and workflow tools

Fuzzy finding, debugging, and formatting capabilities

AI assistant integration (GPT.nvim, GitHub Copilot)

Instructions

1. Verify Prerequisites

Before beginning configuration, check that these dependencies are installed:

**Required system packages:**

`neovim` (version 0.5+)

`ripgrep` - fast search tool

`fzf` - fuzzy finder

`ranger` - file manager

`nodejs` and `npm` - for CoC plugins

`xclip` - clipboard support (Linux)

`figlet` - ASCII art generation

**Required Python packages:**

```bash

pip install pynvim debugpy

npm install -g neovim

```

**Optional but recommended:**

Nerd Fonts for icon support

If dependencies are missing, inform the user and provide installation commands for their platform.

2. Clone or Locate Repository

If the user doesn't have the configuration yet:

Clone from `youshyee/nvim` repository

Or work with their existing Neovim configuration directory at `~/.config/nvim`

3. Understand Configuration Structure

Explain the modular structure:

`init.vim` - main entry point that sources all modules

`plugins.vim` - plugin definitions managed by vim-plug

`general/settings.vim` - core editor settings

`key.vim` - custom key mappings

`functions.vim` - utility functions

`plugconfig/` - individual plugin configurations

`coc-settings.json` - LSP and completion settings

`UltiSnips/` - custom snippet definitions

`_machine_specific.vim` - machine-specific settings (auto-created from default)

4. Install Plugins

Guide the user to:

1. Open Neovim: `nvim`

2. Run `:PlugInstall` to install all plugins defined in `plugins.vim`

3. Wait for installation to complete

4. Restart Neovim

5. Configure CoC Language Servers

Install CoC extensions for desired languages:

```vim

:CocInstall coc-python coc-tsserver coc-json coc-html coc-css coc-go coc-lua coc-sh

```

Key language servers configured in `coc-settings.json`:

**Python**: PyRight LSP

**JavaScript/TypeScript**: tsserver with prettier

**Go**: gopls

**LaTeX**: texlab

**Lua**: lua-lsp

**C/C++**: ccls

**Shell**: bash-language-server

6. Set Up Machine-Specific Configuration

The file `_machine_specific.vim` is auto-created from `default_configs/_machine_specific_default.vim` on first run.

Edit `_machine_specific.vim` to configure:

Python interpreter paths

Custom environment variables

Machine-specific key mappings

Local development paths

7. Configure Optional AI Assistants

**GitHub Copilot:**

Run `:Copilot setup` after installation

Follow authentication prompts

**GPT.nvim:**

Configure API keys in `_machine_specific.vim` if using

8. Verify Installation

Run health checks:

```vim

:checkhealth

:PlugStatus

:CocInfo

```

Address any warnings or errors reported by these commands.

9. Test Key Features

Guide the user to test core functionality:

**Fuzzy finding**: `:Files` or `:Rg`

**Git integration**: `:G` (fugitive status)

**File management**: `:Ranger`

**Code completion**: Start typing in a supported language file

**Formatting**: Save a file to trigger auto-format

**Terminal**: Open floating terminal with floaterm

**Debugging**: Set up vimspector for Python debugging

10. Customize Key Mappings

Review and modify key mappings in:

`key.vim` - general mappings

`plugconfig/*.vim` - plugin-specific mappings

Help user understand the which-key integration for discoverable shortcuts.

Important Notes

**Color scheme**: Default is `kanagawa`, changeable in `init.vim`

**True color support**: Configuration uses `termguicolors` - ensure terminal supports it

**Performance**: First load may be slow while plugins initialize; subsequent loads are fast

**Updates**: Run `:PlugUpdate` regularly to keep plugins current

**Snippets**: Custom snippets in `UltiSnips/` directory can be extended

**Markdown**: Includes spell checking and extensive markdown support

Common Issues

**Issue**: CoC language server not working

**Solution**: Run `:CocInstall <extension>` for the specific language, check `:CocInfo` for errors

**Issue**: Colors appear wrong

**Solution**: Verify terminal supports true color, check `$TERM` environment variable

**Issue**: Clipboard not working

**Solution**: Install `xclip` (Linux) or appropriate clipboard tool for your OS

**Issue**: Plugins not loading

**Solution**: Run `:PlugClean` then `:PlugInstall`, restart Neovim

Example Usage

**User**: "Set up my Neovim for Python and TypeScript development"

**Assistant actions**:

1. Verify prerequisites (neovim, nodejs, pynvim, etc.)

2. Clone or locate configuration

3. Guide through `:PlugInstall`

4. Install `:CocInstall coc-python coc-tsserver coc-prettier`

5. Configure `_machine_specific.vim` with Python interpreter

6. Run health checks

7. Create test Python and TypeScript files to verify LSP functionality

**User**: "Help me customize key mappings for git operations"

**Assistant actions**:

1. Read `key.vim` and `plugconfig/fugitive.vim`

2. Show current git-related mappings

3. Help modify or add new mappings based on user preferences

4. Test new mappings

Constraints

Requires Neovim 0.5 or higher (for LSP support)

Some plugins require specific system packages installed

Machine-specific configuration must be edited for optimal Python debugging

AI assistants (Copilot, GPT.nvim) require additional authentication/API keys

Initial setup requires internet connection for plugin downloads

Professional Neovim Configuration