humanerd-drew/opencode-drewgent/goose-acp-integration
Claude Code and agent skill by humanerd-drew/opencode-drewgent
- community
Checking that the SKILL.md file is still in the repository.
Integrate {{AGENT_NAME}} with ACP (Agent Client Protocol) agents. Reverse-engineered from goose's Rust ACP provider implementation.
Install
npx vskill@latest install humanerd-drew/opencode-drewgent/goose-acp-integrationSKILL.md
The same SKILL.md was published earlier as humanerd-drew/opencode-drewgent/goose-acp-integration.
Goose ACP Integration for {{AGENT_NAME}}
What is ACP
Agent Client Protocol (ACP) is a JSON-RPC-based standard for communicating with coding agents (GitHub: agentclientprotocol).
goose uses ACP to connect to agents like Claude Code as provider (subprocess communication over stdio):
Key ACP providers in goose:
claude_acp.rs— Claude Code via@agentclientprotocol/claude-agent-acpcodex_acp.rs— OpenAI Codexcopilot_acp.rs— GitHub Copilot
Key Protocol Types (agent_client_protocol schema)
How goose connects to Claude Code
AcpProvider (crates/goose/src/acp/provider.rs):
- Spawns subprocess (stdio JSON-RPC)
- Sends
initializethennewSession - Streams
SessionNotificationback (tool calls, permissions) - Sends tool results via
CallToolResult
{{AGENT_NAME}} Implementation Points
1. ACP Provider Tool
Spawn any ACP agent as subprocess, communicate via newline-delimited JSON-RPC over stdio.
2. MCP Extension Bridge
Convert {{AGENT_NAME}} tools → MCP server definitions → pass to ACP agent via mcp_servers config.
3. Permission Tiers
Map {{AGENT_NAME}} P0-P6 brain rules to ACP permission decisions (AllowAlways/AllowOnce/RejectOnce/RejectAlways/Cancel).
Implementation Plan
Phase 1: tools/acp_provider.py — subprocess spawn + JSON-RPC over stdio + session lifecycle Phase 2: Delegate to Claude Code via claude-agent-acp, pass {{AGENT_NAME}} tools as MCP servers Phase 3: Permission callback system bridging {{AGENT_NAME}} P0 rules to ACP permission requests
References
- goose ACP provider impl:
crates/goose/src/providers/{claude_acp,codex_acp,copilot_acp}.rs - ACP core:
crates/goose/src/acp/provider.rs - ACP macros:
crates/goose-acp-macros/src/lib.rs - Protocol schema:
agent_client_protocolRust crate (github.com/agentclientprotocol) - ACP npm adapter:
@agentclientprotocol/claude-agent-acp - Docs: https://goose-docs.ai/docs/guides/acp-providers
Gotchas
- STDIO transport — newline-delimited JSON-RPC, no HTTP
- Mode mapping — each ACP agent has different mode strings; configured per-provider
- MCP servers — must follow Model Context Protocol schema
- Permission suspension — ACP agent waits for async permission response; cannot block main loop
- Nested sessions — set
env_removeto prevent infinite nesting (e.g., CLAUDECODE env var)
Related
- [[@action/skills/SKILL-INDEX]]
- [[@action/skills/agent-protocol/DESCRIPTION]]
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryChecking@action/skills/agent-protocol/goose-acp-integration/SKILL.md
Popularity
- Repository stars
- 3
- Repository forks
- 8
- 7-day trend score
- 0
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/humanerd-drew/opencode-drewgent/goose-acp-integration)