neovim
Installation
SKILL.md
Neovim
Use this skill for Neovim Lua work: a user's configuration (the config path, in references/neovim-config.md) or a plugin you are developing, testing, or releasing. It covers plugin structure, Lua module conventions, testing with plenary.nvim, CI with GitHub Actions, documentation with doc/ files, and release automation.
Use this skill when
- Editing, debugging, or validating a Neovim Lua config (
init.lua,lua/,after/, plugin specs, lockfiles, LSP/completion, treesitter, startup behavior), or a checkout loading the wrong config — followreferences/neovim-config.mdand validate withreferences/neovim-config-runtime-checks.md. - Creating a new Neovim plugin from scratch.
- Adding a feature, command, or keymap to an existing Neovim plugin.
- Writing or debugging tests for a Neovim plugin using plenary.nvim.
- Setting up CI for a Neovim plugin (linting with selene/stylua, testing with plenary, release automation).
- Generating or updating plugin documentation (
doc/<plugin>.txt). - Configuring release automation for a Neovim plugin (tags, changelogs, lazy.nvim compatibility).
- Debugging a runtime error in a Neovim plugin (Lua module loading, autocommands, user commands).
Do not use this skill when
- The task is general Lua scripting outside the Neovim plugin API.
- The main task is writing a README or documentation for a non-Neovim project — use
writing-and-editing.