Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

lua-helper

/lua-helper

Dostarcza aktualne wskazówki dla Lua: przenośny Lua, LuaJIT, interfejs Lua w Neovim, konfiguracja WezTerm, LuaLS, formatowanie, lintowanie, testowanie i bezpieczeństwo.

Repozytorium
monorepo ↗
Licencja
GPL-3.0
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

GPL-3.0, otwarta.

Co robi i kiedy

Dostarcza aktualne wskazówki dla Lua: przenośny Lua, LuaJIT, interfejs Lua w Neovim, konfiguracja WezTerm, LuaLS, formatowanie, lintowanie, testowanie i bezpieczeństwo.

Oryginalny opis (EN)

Current Lua guidance for portable Lua, LuaJIT, Neovim's Lua interface, WezTerm configuration, LuaLS, formatting, linting, testing, and security. Use when writing or reviewing Lua, Neovim plugins/config, WezTerm config, rockspecs, or Lua tooling.

Jak działa

  1. Current baselines
  2. Select the runtime
  3. Error discipline
  4. Tables and sequences
  5. Neovim
  6. WezTerm
  7. Tooling
  8. Security
  9. Review checklist
Sekcje z nagłówków SKILL.md, w oryginale · 128 linii, 906 słów
Podgląd SKILL.md
---
name: lua-helper
description: Current Lua guidance for portable Lua, LuaJIT, Neovim's Lua interface, WezTerm configuration, LuaLS, formatting, linting, testing, and security. Use when writing or reviewing Lua, Neovim plugins/config, WezTerm config, rockspecs, or Lua tooling.
---

# Lua Helper

Identify the host before writing Lua. Portable Lua 5.5, Neovim's Lua 5.1 interface, optional LuaJIT extensions, and WezTerm's Lua 5.4 runtime have different APIs and semantics.

## Current baselines

Verified 2026-08-03:

| Host or tool | Current baseline | Compatibility boundary |
| --- | --- | --- |
| Lua | 5.5.0; maintained 5.4 line at 5.4.8 | Version-gate APIs newer than the project's minimum |
| LuaJIT | Active rolling 2.1 branch | Lua 5.1-compatible with implementation extensions and build flags |
| Neovim | 0.12.4 | Permanent Lua 5.1 interface; may use LuaJIT or a compatible fork |
| WezTerm | Stable release still dated 2024 | Embeds Lua 5.4; online docs can describe nightly-only APIs |
| LuaLS | 3.18.2 | Annotations and diagnostics are tooling, not runtime validation |
| StyLua | 2.5.2 | Pin/configure per repository |
| LuaRocks | 3.13.0 | Installation runs package build logic and mutates environments |

Read [references/releases.md](references/releases.md) for the 68-page research ledger. Read [references/core-language.md](references/core-language.md) for portable Lua and LuaJIT differences. Read [references/neovim.md](references/neovim.md) for current LSP, diagnostics, process, trust, and buffer APIs. Read [references/wezterm.md](references/wezterm.md) for configuration evaluation, strict mode, events, subprocesses, and mux domains. Read [references/tooling-and-security.md](references/tooling-and-security.md) for LuaLS, formatters, linters, tests, rocks, and security.

## Select the runtime

Before using an API, establish:

1. Lua language/interface version.
2. Whether the runtime is PUC Lua, LuaJIT, or a host embedding.
3. Host application version and stable/nightly channel.
4. Tooling version and project configuration.

In Neovim, target the documented Lua 5.1 interface and check `jit` before LuaJIT-specific behavior. In WezTerm, target Lua 5.4 and check the API's “Since” version against the installed binary.

## Error discipline

Lua APIs commonly return `nil, error` or status tuples. Check every open, read, write, close, subprocess, and host callback result whose failure matters.

```lua
local function read_file(path)
  local file, open_error = io.open(path, "rb")
  if not file then
    return nil, open_error
  end

  local content, read_error = file:read("*a")
  local close_ok, close_error = file:close()
  if not content then
    return nil, read_error
  end
  if not close_ok then
    return nil, close_error
  end
  return content
end
```

Do not bind an unchecked `io.open` result as a to-be-closed value. Preserve close failures when durability matters.

## Tables and sequences

The length operator does not count arbitrary table keys. For a table with holes, `#table` returns a valid border and is not a reliable element count. Model sequences as contiguous integer keys or count explicitly.

Version-gate `table.move`, `table.unpack`, `rawlen`, `__pairs`, and related APIs. Lua 5.1 uses global `unpack`; LuaJIT compatibility libraries can depend on build flags.

Avoid memoization keys built from `table.concat({...})`: they reject many value types and can collide. Use nested tables keyed by arguments or a deliberately encoded, restricted input domain.

## Neovim

Current native LSP setup uses `vim.lsp.config` and `vim.lsp.enable`. This replaces nvim-lspconfig's deprecated legacy `require('lspconfig').setup` framework; nvim-lspconfig itself remains maintained and supplies server definitions.

Use current APIs:

- `vim.hl.hl_op()` for yank highlighting.
- `vim.diagnostic.jump({ count = 1 })` and negative count for navigation.
- `vim.api.nvim_set_option_value(name, value, { buf = buffer })` for scoped options.
- `vim.system({ program, argument }, { text = true }):wait()` for ordinary subprocesses, checking `code`, `signal`, and `stderr`.

Use `:trust` and `vim.secure` for project-local configuration. `exrc` executes project code and is a trust boundary.

## WezTerm

Create the configuration with strict mode so invalid options fail:

```lua
local wezterm = require("wezterm")
local config = wezterm.config_builder()
config:set_strict_mode(true)

return config
```

WezTerm may evaluate configuration repeatedly. Keep top-level evaluation idempotent and free of side effects such as spawning processes. Config precedence includes CLI and environment overrides before standard paths.

`wezterm.run_child_process` returns success, stdout, and stderr. Inspect success. Returning `false` from a `wezterm.on` callback stops later callbacks and the default action.

## Tooling

```bash
stylua --check .
luacheck .
selene .
busted
```

Use the tools configured by the project. Choose Luacheck or Selene deliberately instead of layering both without purpose. Use Busted for behavior-style suites or LuaUnit for lightweight xUnit tests. Use headless Neovim/Plenary only when host integration is part of the contract.

LuaLS supports `.luarc.json` / `.luarc.jsonc`, annotations, diagnostics, addons, and stricter type-checking modes. Loading the entire Neovim runtime as a workspace library is valid but broad; prefer an addon or narrow explicit paths when sufficient.

## Security

- Load untrusted source only as text with a constrained environment; never accept untrusted binary chunks.
- Avoid shell construction in `os.execute` and string-form `vim.fn.system`. Never concatenate untrusted input into a shell command.
- WezTerm and Neovim config execute arbitrary code. Keep secrets out of config and use protected identity/agent mechanisms.
- WezTerm config can execute more than once; repeated evaluation magnifies side effects.
- LuaRocks installation executes rock build/package logic. Inspect sources and rockspecs and pin versions in reproducible environments.
- LuaJIT FFI is an implementation extension with native-memory safety implications; do not assume it exists or is sandboxed.

## Review checklist

- Identify portable Lua, LuaJIT, Neovim, or WezTerm before choosing APIs.
- Version-gate language, host, and online-documentation features.
- Check file, process, callback, and cleanup results.
- Do not use `#` as a general map size or unsafe concatenated memo keys.
- Use current Neovim LSP, highlight, diagnostic, option, and process APIs.
- Make WezTerm config strict, idempotent, and side-effect free at top level.
- Configure LuaLS and one intentional lint/test workflow.
- Treat project config, shells, rocks, binary chunks, and FFI as trust boundaries.
- Preserve the distinction between Neovim's Lua 5.1 interface and optional LuaJIT implementation.
Pliki w paczce (6)
  • SKILL.md 7 KB
  • references/core-language.md 2 KB
  • references/neovim.md 3 KB
  • references/releases.md 5 KB
  • references/tooling-and-security.md 4 KB
  • references/wezterm.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie lua-helper.

Migawka bazy z 13.11.2026 · wersja paczki c787743d6b1e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 1 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100lua-guide
    Podaje zasady i wzorce Lua dla programowania wspomaganego AI: tablice, metatabele, korutyny i konwencje osadzania, dla LuaJIT, Neovim i Love2D.
  • 90lua-opinionated-guide
    Optymalizuje krytyczne ścieżki w Lua i LuaJIT: tablice przyjazne JIT, wstępną alokację, pamięć podręczną i stabilne kształty tablic.
  • 86lua
    Pomaga w skryptach Lua: skryptach gier, osadzonych skryptach, skryptach Nginx i Redis oraz konfiguracji Neovim.
  • 100neovim
    Pomaga konfigurować Neovim w Lua: natywny klient LSP, Treesitter, zarządzanie wtyczkami lazy.nvim, init.lua i skrócenie czasu uruchamiania edytora.
  • 100luajit-syntax
    Planuje i implementuje rozszerzoną składnię LuaJIT 3.0 w serwerze języka Lua: operatory bitowe, trójargumentowy, bezpieczną nawigację, nil-coalescing, continue, const i podkreślenia w liczbach.
  • 100neovim
    Pomaga zainstalować Neovim, napisać lub naprawić init.lua, dodać wtyczki, podłączyć serwery języków przez vim.lsp.config, ustawić formatowanie przy zapisie i uruchamiać Neovim headless.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.