Neovim Agent Skills Pack

-- AI-assisted plugin development with expert knowledge

local M = {}

-- Agent knows: setup() pattern, vim.tbl_deep_extend, config validation
M.setup = function(opts)
  M.config = vim.tbl_deep_extend("force", defaults, opts or {})
  -- Proper autocommand groups, not global pollution
  local group = vim.api.nvim_create_augroup("MyPlugin", { clear = true })
end

return M

10 Expert Skills Included

Each skill teaches AI agents modern Neovim/Lua patterns

SKILL 01

Plugin Architecture

Modern Lua plugin structure: setup() patterns, config modules, autocommands, error handling.

SKILL 02

Lua API Mastery

vim.api, vim.opt, vim.keymap, vim.uv. Correct APIs, avoiding deprecated patterns.

SKILL 03

Treesitter Integration

Syntax tree navigation, queries, node manipulation. Language-aware code intelligence.

SKILL 04

LSP Integration

Custom handlers, middleware, diagnostics, workspace symbols. Full LSP client mastery.

SKILL 05

Floating Windows & UI

Popups, input prompts, selection menus, notifications, extmarks. Polished UI components.

SKILL 06

Async & Job Control

vim.uv, vim.system, process spawning, streaming output. Non-blocking operations.

SKILL 07

Testing with Plenary

BDD testing, async tests, mocking, CI integration. Reliable plugin testing.

SKILL 08

lazy.nvim Plugin Specs

Optimal lazy loading, dependencies, build steps. Plugin manager best practices.

SKILL 09

Telescope Extensions

Custom pickers, finders, previewers, actions. Integrate with the #1 fuzzy finder.

SKILL 10

Vimdoc Generation

Help documentation format, auto-generation, proper tags. Professional docs via :help.

What's Inside

📄

10 Markdown Skill Files

Drop into any AI coding tool's context

📋

Copy-Paste Patterns

Working code examples for every concept

✅

Verification Checklists

Ensure agents produce quality code

⚠️

Common Mistakes

Anti-patterns to avoid with corrections

🔄

Lifetime Updates

Updated for new Neovim releases

🧩

Open Format

Works with any AI tool or workflow

FAQ

What format are the skills in?

Plain Markdown files. Each skill is a standalone document you can add to your AI tool's context, CLAUDE.md, or .cursorrules file.

Do I need to know Lua already?

These skills are designed for AI agents, not for teaching you Lua. They help AI produce better Neovim plugin code. Basic Neovim familiarity helps.

Which Neovim version do these target?

Neovim 0.9+ with emphasis on 0.10+ features. The skills note when APIs require specific versions.

Can I use these commercially?

Yes. Use them in any project, personal or commercial. You cannot resell the skills themselves.