acp-debug

Spawn JSON-RPC sessions and capture wire frames for ACP agent debugging.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/AvatarGanymede/pcraft --skill acp-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acp-debug
Source: https://github.com/AvatarGanymede/pcraft/tree/main/.agents/skills/acp-debug
Command: npx skills add https://github.com/AvatarGanymede/pcraft --skill acp-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill unit provides a robust debugging framework for ACP agents, enabling users to inspect and analyze the internal workings of agents, diagnose issues, and compare agent capabilities.

Core Features & Use Cases

  • Agent Debugging: Offers a detailed view of agent behavior through JSON-RPC sessions and captures every wire frame for analysis.
  • Probe and Test: Run arbitrary commands or probe specific agents to test and compare their functionalities.
  • Session Load: Resume and analyze past sessions to troubleshoot and understand agent interactions.
  • Use Case: When a user encounters an issue with an agent, such as a failure to initialize, this skill can be used to diagnose the problem by running a probe or loading a session for analysis.

Quick Start

Use the acp-debug skill to probe the 'claude-acp' agent and capture its interaction with the agent in a JSONL file.

Frequently Asked Questions about acp-debug

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

FAQPage Schema
How do I debug a JSON-RPC session for an ACP agent?

You can debug an ACP agent by spawning a JSON-RPC session that captures detailed wire frames for comprehensive interaction analysis and issue diagnosis.

What is the best way to compare ACP agent capabilities?

Comparing ACP agent capabilities involves running targeted probes to capture interactions in JSONL files, yielding detailed analytical output for feature differentiation.

Can I resume and analyze past JSON-RPC agent sessions?

Yes, you can resume analysis of past JSON-RPC agent sessions to troubleshoot historical interactions and diagnose previous initialization failures.

How do I capture wire frames when an ACP agent fails to initialize?

Capture wire frames during an initialization failure by running a targeted probe against the specific ACP agent to record interaction details needed for diagnosis.

Does ACP debugging work without external dependencies?

Yes, ACP debugging works without external dependencies, relying on internal scripts to spawn sessions, capture wire frames, and analyze agent interactions directly.

Why does my ACP agent probe return unexpected results?

Unexpected probe results may stem from internal agent behavior issues, diagnosable by inspecting captured JSONL wire frames to analyze the exact JSON-RPC interaction sequence.