smithery.ai

add-nvim-plugin

Add and configure a neovim plugin following the nix-based setup. Use when the user wants to add a new vim/neovim plugin.

First seen Mar 10, 2026

Installation

$ npx skills add https://smithery.ai

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,264 B
  • docs SUMMARY.md 143 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 3 installs

SKILL.md

Add Neovim Plugin

Add the neovim plugin: $ARGUMENTS

Reference Documentation

Follow the patterns documented in @docs/neovim-plugins.md

Steps

  1. Find the plugin: Search nixpkgs for the plugin using nix search nixpkgs vimPlugins.<name>. If not found, check vimExtraPlugins.

- IMPORTANT: vimExtraPlugins uses the naming convention <plugin-name>-<owner> (e.g., trouble-nvim-folke, conform-nvim-stevearc). - Find the exact name in plugins.md.

  1. Fetch plugin info: If a GitHub URL is provided, fetch it to understand dependencies and configuration options.
  1. Add to neovim.nix: Add the plugin to home/neovim.nix in the appropriate category:

- Basic plugins (no config needed) - add to first list - Optional plugins (lazy-loaded, no config file) - add to map optionalPlugin [...] - Configured plugins (with Lua config file) - add to map pluginWithConfig [...]

  1. Handle dependencies: Use pluginWithDeps if the plugin requires other plugins like nvim-web-devicons.
  1. Create Lua config: If needed, create config/nvim/lua/shinzui/<plugin-pname>.lua.

CRITICAL: The filename MUST match the plugin's pname exactly because pluginWithConfig derives the Lua module name from it.

- For nixpkgs plugins: use the plugin name (e.g., telescope-nvim.lua) - For vimExtraPlugins: use the full name with owner (e.g., trouble-nvim-folke.lua, lspsaga-nvim-nvimdev.lua)

Example for vimExtraPlugins (e.g., pkgs.vimExtraPlugins.trouble-nvim-folke): ```lua -- trouble.nvim -- A pretty diagnostics list -- https://github.com/folke/trouble.nvim vim.cmd "packadd trouble-nvim-folke"

require("trouble").setup({}) ```

Example for nixpkgs vimPlugins (e.g., telescope-nvim): ```lua -- telescope.nvim -- https://github.com/nvim-telescope/telescope.nvim vim.cmd "packadd telescope-nvim"

require("telescope").setup({}) ```

  1. Summary: Report what was added and remind to run darwin-rebuild switch --flake .