neovim-config

Edit chezmoi-managed Neovim configurations with template-aware workflows and LazyVim reference checks.

Updated Jan 19, 2023
One-click install
npx skills add https://github.com/inkfin/dotfiles --skill neovim-config-inkfin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neovim-config
Source: https://github.com/inkfin/dotfiles/tree/main/.agents/skills/neovim-config
Command: npx skills add https://github.com/inkfin/dotfiles --skill neovim-config-inkfin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing Neovim configs managed by chezmoi is error-prone: live files under ~/.config may be rendered from .tmpl templates, so editing them directly causes drift that gets overwritten. This Skill ensures changes land in the correct chezmoi source file while preserving template logic and profile conditionals. ## Core Features & Use Cases - Chezmoi-aware editing: Resolves live config paths to their real source files using chezmoi managed, source-path, and diff commands before making changes. - Dual-config support: Handles both the minimalist nvim.mini config (native vim.pack) and the LazyVim-based nvim.lazyvim config, respecting each architecture's conventions. - LazyVim reference inspection: Uses the locally installed LazyVim checkout to verify upstream defaults, keymaps, and plugin patterns without modifying it. - Use Case: You want to add a keymap to your daily Neovim setup. The Skill checks whether the target file is chezmoi-managed, locates the .tmpl source, edits it while preserving template conditionals, and runs chezmoi diff to confirm the change. ## Quick Start Ask the assistant to add a new plugin keymap to your Neovim config and apply it through chezmoi.

Frequently Asked Questions about neovim-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit Neovim config files managed by chezmoi?

Run chezmoi source-path on the live config file to find the real editable source, then edit that file and apply with chezmoi apply. Editing the live file directly causes drift because chezmoi re-renders it from source templates.

How to handle .tmpl template files in a chezmoi dotfiles repo?

Treat .tmpl files as executable source, not plain text. Preserve template expressions and profile conditionals when editing, since chezmoi renders them per machine. Only remove template logic when the change explicitly removes that behavior.

What is the difference between nvim.mini and nvim.lazyvim configs?

nvim.mini uses native vim.pack with a hand-rolled minimalist structure for fast startup, while nvim.lazyvim follows LazyVim conventions with upstream plugin specs. Port ideas between them by adapting to each architecture rather than copying patterns verbatim.

Can I use the installed LazyVim checkout as a config reference?

Yes, the local LazyVim checkout under the Neovim data directory (e.g., ~/AppData/Local/nvim-data/lazy/LazyVim on Windows) shows upstream defaults, keymaps, and extras. Inspect it for reference but do not edit it unless explicitly requested.

Why do my Neovim config changes disappear after chezmoi apply?

Changes made directly to live files under ~/.config are overwritten because chezmoi re-renders them from source. Use chezmoi re-add to pull live edits back into source, or edit the source file first and then apply.