Agent skill

Agentic Acp Protocol Flow

by carlos-algms in carlos-algms/agentic.nvim

MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim.

MITAuto-check passed

Install Agentic Acp Protocol Flow

skills CLI

$ npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install carlos-algms/agentic.nvim agentic-acp-protocol-flow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/carlos-algms/agentic.nvim.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agentic-acp-protocol-flow .claude/skills/agentic-acp-protocol-flow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "agentic-acp-protocol-flow" agent skill from https://github.com/carlos-algms/agentic.nvim/tree/main/.agents/skills/agentic-acp-protocol-flow into .claude/skills/agentic-acp-protocol-flow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentic-acp-protocol-flow", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/carlos-algms/agentic.nvim/tree/main/.agents/skills/agentic-acp-protocol-flow

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install carlos-algms/agentic.nvim agentic-acp-protocol-flow --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/carlos-algms/agentic.nvim.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/agentic-acp-protocol-flow .agents/skills/agentic-acp-protocol-flow && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "agentic-acp-protocol-flow" agent skill from https://github.com/carlos-algms/agentic.nvim/tree/main/.agents/skills/agentic-acp-protocol-flow into .agents/skills/agentic-acp-protocol-flow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentic-acp-protocol-flow", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install carlos-algms/agentic.nvim agentic-acp-protocol-flow --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/carlos-algms/agentic.nvim.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/agentic-acp-protocol-flow .cursor/skills/agentic-acp-protocol-flow && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "agentic-acp-protocol-flow" agent skill from https://github.com/carlos-algms/agentic.nvim/tree/main/.agents/skills/agentic-acp-protocol-flow into .cursor/skills/agentic-acp-protocol-flow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentic-acp-protocol-flow", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/carlos-algms/agentic.nvim.git --path .agents/skills/agentic-acp-protocol-flow

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install carlos-algms/agentic.nvim agentic-acp-protocol-flow --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/carlos-algms/agentic.nvim.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/agentic-acp-protocol-flow .gemini/skills/agentic-acp-protocol-flow && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "agentic-acp-protocol-flow" agent skill from https://github.com/carlos-algms/agentic.nvim/tree/main/.agents/skills/agentic-acp-protocol-flow into .gemini/skills/agentic-acp-protocol-flow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentic-acp-protocol-flow", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install carlos-algms/agentic.nvim agentic-acp-protocol-flow

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/carlos-algms/agentic.nvim.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/agentic-acp-protocol-flow .github/skills/agentic-acp-protocol-flow && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "agentic-acp-protocol-flow" agent skill from https://github.com/carlos-algms/agentic.nvim/tree/main/.agents/skills/agentic-acp-protocol-flow into .github/skills/agentic-acp-protocol-flow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentic-acp-protocol-flow", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install carlos-algms/agentic.nvim agentic-acp-protocol-flow --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/carlos-algms/agentic.nvim.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/agentic-acp-protocol-flow .opencode/skills/agentic-acp-protocol-flow && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "agentic-acp-protocol-flow" agent skill from https://github.com/carlos-algms/agentic.nvim/tree/main/.agents/skills/agentic-acp-protocol-flow into .opencode/skills/agentic-acp-protocol-flow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentic-acp-protocol-flow", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: agentic-acp-protocol-flow
GitHub stars: 640
Token cost: ~636 tokens
SKILL.md length: 212 words
Files: 5 (incl. references)
Skills in repo: 8
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim.

SKILL.md covers Provider model, Pipeline, Load references by edit target and Protected methods, plus 1 more section
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agentic Acp Protocol Flow is an agent skill from carlos-algms/agentic.nvim. MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim.

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/client-lifecycle.md`, `references/provider-switch-options.md` and `references/tool-calls-permissions.md`).

It works with Lua. The repository describes itself as: Agentic Chat Interface directly in Neovim with ACP providers from Claude-Code, Gemini, Codex, OpenCode, and Cursor-agent. The licence is MIT.

Example prompts

“/agentic-acp-protocol-flow”

What it can do on your machine

Read from SKILL.md and the folder at commit e280dee. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agentic Acp Protocol Flow loads about 636 tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 212 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~56
When it runs · the whole SKILL.md, loaded when a task matches: ~636
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from carlos-algms/agentic.nvim at commit e280dee, republished under its MIT licence (© carlos-algms). 212 words, ~636 tokens.

Download SKILL.mdSave it as .claude/skills/agentic-acp-protocol-flow/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.

name: agentic-acp-protocol-flow
description: MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim.

Agentic ACP Protocol Flow

Use this skill for ACP runtime behavior. For schema facts, also load agentic-acp-docs-and-schema.

Provider model

External ACP CLI tools are spawned as subprocesses.
The plugin does not install providers.
All providers use the generic ACPClient in acp_client.lua.
There are no per-provider adapter files. See ADR 0005.
Add a provider with a config_default.lua entry under acp_providers unless the provider deviates from ACP in a new way.
Provider quirks live in protected ACPClient methods, not adapter files.

Pipeline

text

provider subprocess
-> ACPTransport
-> ACPClient
-> SessionManager subscriber
-> MessageWriter / PermissionManager / TodoList / ChatHistory

Load references by edit target

references/client-lifecycle.md: ACPClient.state, ready listeners, sync vs async dispatch, reconnect, pending callback draining.
references/transport-framing.md: stdio line framing, partial chunks, subprocess process-group termination.
references/tool-calls-permissions.md: session/update routing, tool-call lifecycle, permission request normalization, provider quirks.
references/provider-switch-options.md: provider switch replay, modes/models, thought level, config options.

Protected methods

Current extension points:

Method	Behavior
`__handle_tool_call`	Builds ToolCallBlock, notifies subscriber
`__build_tool_call_message`	Parses ACP fields and quirk fallbacks
`__handle_tool_call_update`	Builds partial, notifies subscriber
`__handle_request_permission`	Sends permission result to provider
`__handle_session_update`	Routes by `sessionUpdate` type

Only subclass or extend these when a real provider deviation requires it.

Provider quirks

Handle protocol deviations inline in __build_tool_call_message.

OpenCode rawInput fallback builds diffs when content is missing for edit tool calls.
locations fallback extracts file_path from update.locations[0].path.
Unknown tool kinds log a warning so users can report the provider behavior.

Files

SKILL.md and 4 other files (references) in .agents/skills/agentic-acp-protocol-flow of carlos-algms/agentic.nvim.

SKILL.md
references/client-lifecycle.md
references/provider-switch-options.md
references/tool-calls-permissions.md
references/transport-framing.md

Open the folder on GitHubat commit e280dee

Compare with similar skills

Agentic Acp Protocol Flow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agentic Acp Protocol Flow compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Agentic Acp Protocol Flow this skillcarlos-algms/agentic.nvim	640	—	~636	Automated safety check: Pass	MIT	yesterday
Pandoc DOCX TemplateAchuan-2/pandoc_docx_template	1.1k	—	~1k	Automated safety check: Pass	None	3 mo ago
Add Lua Binding Simplecataclysmbn/Cataclysm-BN	1.3k	—	~846	Automated safety check: Pass	Custom licence	today
Cpp Compiler FlagsSerial-Studio/Serial-Studio	7.2k	—	~2.1k	Automated safety check: Pass	Custom licence	today
Luamakeactboy168/luamake	210	—	~2k	Automated safety check: Pass	MIT	1 mo ago
Lua Ecozhaojh329/lua-eco	103	—	~1.7k	Automated safety check: Pass	MIT	8 days ago

Similar skills

Pandoc DOCX Template
Achuan-2/pandoc_docx_template
A skill your agent uses when converting Markdown to Word DOCX or DOCX back to Markdown with Pandoc, especially when the output should use the bundled Chinese Word reference templates, heading…
1.1k GitHub stars~1k tokensUpdated 3 mo ago
Documents & OfficeAuto-check passed
Add Lua Binding Simple
cataclysmbn/Cataclysm-BN
Add simple Cataclysm-BN Lua bindings for stringid types, enums, and basic read-only C++ types.
1.3k GitHub stars~846 tokensUpdated today
Auto-check passed
Cpp Compiler Flags
Serial-Studio/Serial-Studio
C++ compiler/linker flag guidance for Serial Studio's build (GCC, Clang, AppleClang, MSVC cl.exe, clang-cl, MinGW, IntelLLVM).
7.2k GitHub stars~2.1k tokensUpdated today
DevelopmentAuto-check passed
Luamake
actboy168/luamake
Luamake 构建系统指南——用于当前项目的 luamake / make.lua / Ninja 生成流程。当用户需要编写、修改、排查或理解 make.lua、目标定义、lm:conf、deps / objdeps、代码生成、Lua C 模块、Bee 运行时集成，或需要解决当前项目中由 luamake 驱动的构建问题时，使用此 skill。即使用户没有明确提到…
210 GitHub stars~2k tokensUpdated 1 mo ago
Auto-check passed
Lua Eco
zhaojh329/lua-eco
International lua-eco public API skill for writing, reviewing, explaining, and fixing Lua 5.4 code that runs on the eco runtime.
103 GitHub stars~1.7k tokensUpdated 8 days ago
Backend & APIsAuto-check passed
Ss Cpp Modern
Serial-Studio/Serial-Studio
Modern C++20 authoring guidance for Serial Studio (Qt 6.11, C++20): concepts, ranges, move/RAII, std smart pointers, constexpr, lock-free SPSC atomics.
7.2k GitHub stars~1.6k tokensUpdated today
DevelopmentAuto-check passed

More from carlos-algms/agentic.nvim

All 8 skills in this repo

Agentic GitHub Discussion
carlos-algms/agentic.nvim
A skill your agent uses when creating, listing, or managing GitHub discussions in carlos-algms/agentic.nvim repository
640 GitHub stars~1.1k tokensUpdated yesterday
Auto-check passed
Agentic Testing
carlos-algms/agentic.nvim
MANDATORY before creating, editing, or reviewing tests in agentic.nvim, and before behavior changes that require TDD.
640 GitHub stars~828 tokensUpdated yesterday
Auto-check passed
Agentic Vimdoc
carlos-algms/agentic.nvim
A skill your agent uses when writing or updating agentic.nvim vimdoc (doc/agentic.txt), or after changing init.lua, configdefault.lua, theme.lua, or README install/keymaps - those edits require a…
640 GitHub stars~298 tokensUpdated yesterday
Auto-check passed
Agentic Acp Docs And Schema
carlos-algms/agentic.nvim
A skill your agent uses when ACP schema is necessary to clarify the work or when the user asks for ACP data, rules, events, or documentation
640 GitHub stars~468 tokensUpdated yesterday
Auto-check passed
Agentic Lua Class
carlos-algms/agentic.nvim
MANDATORY before writing or editing ANY .lua file in this repo - classes, methods, fields, functions, or LuaCATS annotations.
640 GitHub stars~2k tokensUpdated yesterday
Auto-check passed
Agentic UI Message Writer
carlos-algms/agentic.nvim
MANDATORY before editing MessageWriter, PermissionManager, tool-call block rendering, sender headers, thinking blocks, auto-scroll, folds, status rows, permission buttons, or chat-buffer tool-call…
640 GitHub stars~1.3k tokensUpdated yesterday
Auto-check passed

Works with

Questions about Agentic Acp Protocol Flow

What does Agentic Acp Protocol Flow do?

MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim. nvim.nvim.

How do I install Agentic Acp Protocol Flow in Claude Code?

Run `npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a claude-code`. Or copy the skill folder (.agents/skills/agentic-acp-protocol-flow in carlos-algms/agentic.nvim) into .claude/skills/agentic-acp-protocol-flow in your project. Claude Code loads it when a task matches its description.

How do I install Agentic Acp Protocol Flow in Codex?

Run `npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a codex`. Or copy the skill folder (.agents/skills/agentic-acp-protocol-flow in carlos-algms/agentic.nvim) into .agents/skills/agentic-acp-protocol-flow in your project. Codex loads it when a task matches its description.

Can I use Agentic Acp Protocol Flow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add carlos-algms/agentic.nvim --skill agentic-acp-protocol-flow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agentic-acp-protocol-flow, .gemini/skills/agentic-acp-protocol-flow, .github/skills/agentic-acp-protocol-flow and .opencode/skills/agentic-acp-protocol-flow in your project.

What does Agentic Acp Protocol Flow need to run?

SKILL.md names no scripts, command-line tools or credentials: Agentic Acp Protocol Flow is instructions for the agent only.

Does Agentic Acp Protocol Flow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agentic Acp Protocol Flow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agentic Acp Protocol Flow use?

Agentic Acp Protocol Flow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agentic Acp Protocol Flow use?

About 636 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Agentic Acp Protocol Flow?

Skills that share tags, products or a category with Agentic Acp Protocol Flow: Pandoc DOCX Template (Achuan-2/pandoc_docx_template, 1.1k stars), Add Lua Binding Simple (cataclysmbn/Cataclysm-BN, 1.3k stars), Cpp Compiler Flags (Serial-Studio/Serial-Studio, 7.2k stars) and Luamake (actboy168/luamake, 210 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agentic Acp Protocol Flow?

carlos-algms (a GitHub user) maintains it in carlos-algms/agentic.nvim, which has 640 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 7, 2026.

Source: carlos-algms/agentic.nvim on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Agentic Acp Protocol Flow

Facts

At a glance

What it does

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Agentic ACP Protocol Flow

Provider model

Pipeline

Load references by edit target

Protected methods

Provider quirks

Files

Compare with similar skills

Similar skills

More from carlos-algms/agentic.nvim

Related

Questions about Agentic Acp Protocol Flow