How do I install the Gemini Use Claude Acp skill?

Run npx skillmds@latest add genericservice/gemini-use-claude-acp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gemini Use Claude Acp safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gemini Use Claude Acp?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gemini Use Claude Acp free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gemini Use Claude Acp?

genericservice (@genericservice) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gemini Use Claude Acp by genericservice

Name: Gemini Use Claude Acp
Author: genericservice

Gemini Use Claude Acp

Delegate a sub-task to Claude Code via the Agent Client Protocol (ACP). Use this skill whenever you want to hand off work to Claude — complex agentic coding with MCP tool access, detailed multi-file refactors, tasks requiring Claude's reasoning style, or anything where Claude's strengths give an advantage. Also invoke when the user asks you to "ask Claude", "use Claude for this", or "run this through Claude". The script handles subprocess lifecycle and ACP session setup; you just provide the prompt and read stdout.

genericservice b4e4fb9 5 files · 7.2 KB Updated Sep 17, 2026

File contents

Gemini → Claude via ACP

Spawn a Claude Code ACP adapter subprocess, send a prompt, stream the response to stdout, and terminate cleanly. No persistent session — one prompt, one response.

When to use

The task requires complex multi-step agentic coding with MCP tool access
You want Claude's reasoning on a specific problem
The user says "ask Claude", "use Claude for this", etc.
You want a second opinion from a different model

Setup (first use only)

cd ~/.gemini/skills/gemini-use-claude-acp/scripts
pnpm install

This installs @agentclientprotocol/sdk into the local node_modules/. Subsequent runs skip this step.

Usage

CLAUDE_MODEL=claude-sonnet-4-6 \
TARGET_CWD=/path/to/project \
node ~/.gemini/skills/gemini-use-claude-acp/scripts/claude-delegate.mjs \
  "Refactor the auth module to use JWT tokens. The code is in src/auth/."

The response streams to stdout as Claude generates it. Capture it:

response=$(node ~/.gemini/skills/gemini-use-claude-acp/scripts/claude-delegate.mjs "your prompt")

Environment variables

Variable	Default	Description
`CLAUDE_MODEL`	`claude-sonnet-4-6`	Model to use (applied via ACP `unstable_setSessionModel`)
`TARGET_CWD`	current working dir	Working directory passed to the Claude session

How it works

Spawns pnpm dlx @zed-industries/claude-code-acp with:
- CLAUDE_CODE_SKIP_PERMISSIONS=1 — auto-approves all tool calls
- TERM=dumb — prevents ANSI escape sequences in output
- CLAUDECODE unset — prevents the adapter refusing to start inside another Claude session
- ~/.local/bin prepended to PATH — ensures the claude binary is found
Connects via @agentclientprotocol/sdk's ClientSideConnection + ndJsonStream
Sends initialize → newSession → unstable_setSessionModel → prompt over ACP
Streams agent_message_chunk deltas to stdout as they arrive
Terminates the subprocess once the prompt response completes

Prompt construction tips

Include all relevant context in the prompt string — this is a fresh session with no prior history
Reference files by absolute path if you want Claude to read/edit them
Keep prompts focused: one clear task per invocation
Claude can use its MCP tools (filesystem, shell, etc.) during the session

Error handling

If the script exits non-zero, check stderr for:

pnpm dlx download failures (network, auth)
Claude auth errors — ensure claude CLI is authenticated
CLAUDECODE environment variable being set (indicates you're running inside Claude Code; the adapter refuses to nest)
ACP initialization failures

The script does not retry — surface the error to the user and suggest re-running after fixing the root cause.

---name: gemini-use-claude-acpdescription: Delegate a sub-task to Claude Code via the Agent Client Protocol (ACP). Use this skill whenever you want to hand off work to Claude — complex agentic coding with MCP tool access, detailed multi-file refactors, tasks requiring Claude's reasoning style, or anything where Claude's strengths give an advantage. Also invoke when the user asks you to "ask Claude", "use Claude for this", or "run this through Claude". The script handles subprocess lifecycle and ACP session setup; you just provide the prompt and read stdout.---# Gemini → Claude via ACPSpawn a Claude Code ACP adapter subprocess, send a prompt, stream the response to stdout, and terminate cleanly. No persistent session — one prompt, one response.## When to use- The task requires complex multi-step agentic coding with MCP tool access- You want Claude's reasoning on a specific problem- The user says "ask Claude", "use Claude for this", etc.- You want a second opinion from a different model## Setup (first use only)```bashcd ~/.gemini/skills/gemini-use-claude-acp/scriptspnpm install```This installs `@agentclientprotocol/sdk` into the local `node_modules/`. Subsequent runs skip this step.## Usage```bashCLAUDE_MODEL=claude-sonnet-4-6 \TARGET_CWD=/path/to/project \node ~/.gemini/skills/gemini-use-claude-acp/scripts/claude-delegate.mjs \ "Refactor the auth module to use JWT tokens. The code is in src/auth/."```The response streams to stdout as Claude generates it. Capture it:```bashresponse=$(node ~/.gemini/skills/gemini-use-claude-acp/scripts/claude-delegate.mjs "your prompt")```## Environment variables| Variable | Default | Description ||---|---|---|| `CLAUDE_MODEL` | `claude-sonnet-4-6` | Model to use (applied via ACP `unstable_setSessionModel`) || `TARGET_CWD` | current working dir | Working directory passed to the Claude session |## How it works1. Spawns `pnpm dlx @zed-industries/claude-code-acp` with: - `CLAUDE_CODE_SKIP_PERMISSIONS=1` — auto-approves all tool calls - `TERM=dumb` — prevents ANSI escape sequences in output - `CLAUDECODE` unset — prevents the adapter refusing to start inside another Claude session - `~/.local/bin` prepended to `PATH` — ensures the `claude` binary is found2. Connects via `@agentclientprotocol/sdk`'s `ClientSideConnection` + `ndJsonStream`3. Sends `initialize` → `newSession` → `unstable_setSessionModel` → `prompt` over ACP4. Streams `agent_message_chunk` deltas to stdout as they arrive5. Terminates the subprocess once the prompt response completes## Prompt construction tips- Include all relevant context in the prompt string — this is a fresh session with no prior history- Reference files by absolute path if you want Claude to read/edit them- Keep prompts focused: one clear task per invocation- Claude can use its MCP tools (filesystem, shell, etc.) during the session## Error handlingIf the script exits non-zero, check stderr for:- `pnpm dlx` download failures (network, auth)- Claude auth errors — ensure `claude` CLI is authenticated- `CLAUDECODE` environment variable being set (indicates you're running inside Claude Code; the adapter refuses to nest)- ACP initialization failuresThe script does not retry — surface the error to the user and suggest re-running after fixing the root cause.

Frequently asked questions