What testing framework does this skill recommend?

It specifically follows patterns for test-driven development using the Plenary.nvim 'describe' and 'it' blocks, which is the standard for the Neovim ecosystem.

How does this skill improve Neovim plugin performance?

It enforces lazy loading for heavy dependencies, minimizes the startup impact of init.lua, and utilizes debouncing and vim.schedule for non-blocking operations.

Is LuaCATS required for this skill to work?

While the code will run without them, this skill prioritizes generating LuaCATS annotations to ensure type safety, better documentation, and superior autocompletion in Lua-supported editors.

Does this skill help with Neovim's coordinate system confusion?

Yes, it provides a standardized approach using 0-indexed (LSP-style) coordinates internally and provides patterns for converting to 1-indexed coordinates only when required for storage or specific APIs.

Neovim Lua Plugin Development

Name: Neovim Lua Plugin Development
Author: WarrenZhu050413

byWarrenZhu050413

•

Productivity & Workflow

Architects high-quality Neovim plugins using Lua with a focus on type safety, modular design, and performance-driven best practices.

About

This skill provides a comprehensive framework for developing Neovim plugins in Lua, enforcing a 'Thin Orchestration' architecture where the core logic is modularized and the entry point remains lightweight. It guides Claude to implement LuaCATS annotations for robust type safety, manage complex buffer coordinates using LSP-style 0-indexing, and optimize performance through lazy loading and debouncing. Ideal for developers aiming to create maintainable, test-driven, and user-friendly Neovim extensions that follow modern ecosystem standards like Plenary testing and <Plug> mapping conventions.

Key Features

Type-safe development using LuaCATS annotations for enhanced IDE support
Standardized coordinate systems using 0-indexed internal logic
Modular architecture patterns enforcing the Single Responsibility Principle
Test-driven development patterns utilizing the Plenary framework
5 GitHub stars
Performance optimization via lazy loading and efficient autocommand handling

Use Cases

Adding strict type safety and robust error handling to existing Lua scripts
Building high-performance UI components with extmarks and async scheduling
Refactoring a monolithic Neovim plugin into a clean, modular structure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add warrenzhu050413/warren-claude-code-plugin-marketplace writing-lua

For use in Claude.ai and ChatGPT

Download Skill

GitHub