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.