
lua-toolkit
Build Neovim plugins and migrate Lua programs.
- version
- 0.2.0
- GitHub stars
- 347
Install
/plugin install lua-toolkit@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
Lua Toolkit
For Neovim plugins, target LuaJIT/Lua 5.1 with LuaRocks-first distribution,
LuaCATS types, self-lazy-loading, and no forced setup(). For standalone or
embedded programs, provide Lua version migration and compatibility verification
without imposing Neovim architecture or APIs.
Routing (progressive disclosure)
Route to one mode and load only that reference unless work crosses boundaries. Identify the actual interpreter or embedding host and the versions the project must retain before choosing syntax, library replacements, or checks.
- Lua version migration or compatibility audit: read lua-version-migration.md, then lua-compatibility-verification.md for runnable checks and evidence requirements. Cover every intervening boundary from the starting version to 5.5. Keep Neovim/LuaJIT support when required; installing standalone Lua 5.5 does not upgrade an embedding host.
- Neovim plugin work: select the relevant reference below. These modes retain their Lua 5.1 target and plugin-specific conventions.
- plugin-architecture.md: runtimepath
directory model,
plugin/vslua/separation, deferred-requireloading, no-runtime-entrypoint plugins,util.luarefactoring, global-pollution rules,if jit then ... elsefallback. - configuration.md:
vim.g.<plugin>(table-or-function) config not forcedsetup(), partial LuaCATS config classes, dict-vs-listvim.tbl_deep_extendbehavior, modernvim.validate(0.11+) signature,lua/<plugin>/health.luachecks. - loading-and-install.md:
self-lazy-loading via
plugin/+ftplugin/(don't rely on the plugin manager), minimal lazy.nvim specs, native-API-over-plenary,lazy = truedeps, coroutinebuildconstraints. - apis-and-keymaps.md: single scoped command
with
complete,<Plug>mappings with no default keymaps, buffer-local state,ftpluginvsafter/ftplugin. - tooling-and-quality.md: LuaCATS + lua-ls
as primary correctness tool,
.luarc.json("Lua 5.1"),lua51.luacheckrc, stylua baseline. - plenary-migration.md: replace
plenary.job,plenary.path,plenary.scandir,plenary.async,plenary.curl,plenary.test_harness, popup/window helpers, strings, filetype, and logging with native Neovim APIs or focused dependencies. - testing-and-distribution.md:
busted+nlua(neorocksTestfor Nix), stable/nightly CI matrix, vimcats/panvimdoc generation, SemVer.rockspec/luarocks-tag-release.
Neovim Plugin Rules
Target Lua 5.1 / LuaJIT 2.1, avoid globals, self-lazy-load, prefer lazy
vim.g.<plugin> config over forced setup(), expose one scoped command plus
<Plug> mappings, and gate types with LuaCATS/lua-ls. Read
core-rules.md when writing or reviewing plugin code.
Reference Implementations
Canonical real-world examples: nvim-best-practices,
nvim-lua-nix-plugin-template (Nix CI), rustaceanvim, neotest-haskell.
Cross-Skill Boundaries and Reporting
See operating-rules.md.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/lua-toolkit
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- mcp-builderv0.1.6
- memory-profilerv0.1.6
- microsoft-teamsv0.1.0
- nix-toolkitv0.4.12
- okf-memoryv0.1.6
- performance-forensicsv0.1.4
- planning-with-filesv0.1.9
- program-orchestrationv0.1.5
- recallv0.1.7
- requirements-interviewv0.1.4
- researchv0.1.3
- rust-toolkitv0.1.6
- sarif-toolkitv0.1.5
- security-toolkitv0.1.7
- show-me-your-workv0.1.7
- skill-creatorv0.1.8
- software-engineeringv0.1.9
- tddv0.1.4
- technical-writingv0.2.0
- to-specv0.1.1
- to-ticketsv0.1.1
- typescript-best-practicesv0.1.6
- unslopv0.1.7
- verification-harnessv0.1.5