Neovim Rpc

Interact with a running neovim instance over RPC — open files, show diffs, execute Lua. Use when you need to open a file in the user's editor, show a vimdiff, or run arbitrary Lua in neovim. Requires $NVIM or $NVIM_SOCKET_PATH to be set.

49 stars 8 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sodiumjoe/dotfiles --skill neovim-rpc
Manual install
git clone --depth 1 https://github.com/sodiumjoe/dotfiles.git /tmp/dotfiles
mkdir -p ~/.claude/skills
cp -r /tmp/dotfiles/home/.agents/skills/neovim ~/.claude/skills/neovim-rpc

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Neovim RPC Commands

Three commands for interacting with a running neovim instance over its RPC socket. All require `$NVIM` or `$NVIM_SOCKET_PATH` to be set (this is automatic when running inside neovim via agentic.nvim).

## Commands

### nvim-lua

Execute arbitrary Lua in the running neovim instance.

```bash
${CLAUDE_SKILL_DIR}/scripts/nvim-lua '<lua-expression>'
```

The expression is wrapped in `(function() ... end)()`. Return values are printed to stdout.

Examples:

```bash
${CLAUDE_SKILL_DIR}/scripts/nvim-lua "return vim.fn.expand('%:p')"
${CLAUDE_SKILL_DIR}/scripts/nvim-lua "return require('sodium.utils').editor_window()"
${CLAUDE_SKILL_DIR}/scripts/nvim-lua "vim.cmd('echom \"hello\"') return 0"
```

### nvim-open

Open a file in the running neovim instance.

```bash
${CLAUDE_SKILL_DIR}/scripts/nvim-open --editor '<absolute-path>'
```

The `--editor` flag targets the first non-agentic window (i.e., skips windows with Agentic* filetypes). Without `--editor`, opens in whichever window is current.

You can also target a specific window by ID:

```bash
${CLAUDE_SKILL_DIR}/scripts/nvim-open --window <win-id> '<absolute-path>'
```

Use this after creating plan files, project files, or any file the user should see immediately.

### nvim-diff

Open a vimdiff view in the running neovim instance. Three modes based on argument count:

**Two files:**

```bash
${CLAUDE_SKILL_DIR}/scripts/nvim-diff <file_a> <file_b>
```

Opens both files side by side with `diffthis`.
Read the full skill on GitHub

Details

Skill name
neovim-rpc
Path
home/.agents/skills/neovim/SKILL.md
Repo updated
18 November 2026

FAQ

What does the Neovim Rpc skill do?

Interact with a running neovim instance over RPC — open files, show diffs, execute Lua. Use when you need to open a file in the user's editor, show a vimdiff, or run arbitrary Lua in neovim. Requires $NVIM or $NVIM_SOCKET_PATH to be set.

How do I install the Neovim Rpc skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sodiumjoe/dotfiles --skill neovim-rpc. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Neovim Rpc popular?

It lives in sodiumjoe/dotfiles, which has 49 GitHub stars and 8 forks.

Related skills

Using Superpowers

49

sodiumjoe/dotfiles

Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions

OtherIn 2 lists

Executing Plans

49

sodiumjoe/dotfiles

Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available

AI, LLMs & Agents

Finishing a Development Branch

49

sodiumjoe/dotfiles

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work

Git & Code Review

Uw Unity Editor Tools

47

devdavv/unity-ai-workflow

Generate custom editor tooling including Custom Inspectors, PropertyDrawers, EditorWindows, Gizmos, and Handles. Use when building designer-facing tools, spatial visualization, batch operations, or custom component UIs. Triggers on requests like "create a custom inspector", "add gizmos", "build an editor window", "make this component designer-friendly", "add a debug visualization", "create a level editor tool", "add a property drawer", "make a batch rename tool", or any editor tooling work. Always uses SerializedProperty and Undo for safety.

Writing & Content

Refine Prose

49

petekp/claude-code-setup

Refine prose so it says what the writer means to a specific reader: cut the text that should not exist, put the point first, state things literally, remove the patterns that mark machine writing, and match the voice. Use when drafting, revising, tightening, editing, proofreading, or reviewing prose: essays, posts, emails, PR descriptions, docs, plans, reports, comments, commit messages, UI strings. Also use for requests like "clean this up", "make it read better", "tighten this", "does this sound like AI", "de-slop", or "humanize". Not for code.

Writing & Content10

Jta

24

ckanner/agent-skills

Translate JSON i18n files to multiple languages with AI-powered quality optimization. Use when user mentions translating JSON, i18n files, internationalization, locale files, or needs to convert language files to other languages.

Writing & ContentIn 1 list

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.