adapter-tool-flow-debugging

Diagnose failing adapter-path ClaudeEval tool flows using ClaudeTurnTrace and AsyncToolExec diagnostics.

3|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/transreal/claudecode --skill adapter-tool-flow-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adapter-tool-flow-debugging
Source: https://github.com/transreal/claudecode/tree/main/Claude%20Directives/skills/adapter-tool-flow-debugging
Command: npx skills add https://github.com/transreal/claudecode --skill adapter-tool-flow-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adapter-path ClaudeEval in runtime mode can silently fail or loop, producing missing tool results, hallucinated answers, or no final notebook output, leaving users unable to understand where the turn pipeline broke.

Core Features & Use Cases

  • Symptom-driven fault isolation: Maps common runtime anomalies (tool_call text leaking, repeated web search, “過去の検索結果が見えない”, missing final text, stuck phases) to the most likely internal responsibility area.
  • Turn and event trace triage: Guides users to inspect ClaudeTurnTrace for the correct lifecycle sequence and detect abnormal endings (e.g., tool loops, budget exhaustion, finalize/text skip patterns).
  • ConversationState and tool-result verification: Helps verify whether tool calls/results were recorded, whether prompts include rich results, and whether the final proposal text exists even when notebook rendering fails.
  • AsyncToolExec pipeline diagnosis: Provides targeted checks for polling tick registration, AsyncToolExec progress, finalize/continuation scheduling, and lingering polling-tick residues.

Quick Start

Run the skill by asking your AI to diagnose a “ClaudeRuntime adapter tool-flow malfunction” using ClaudeRateLimitStatus[], ClaudeTurnTrace[$ClaudeLastRuntimeId], and ConversationState.Messages to pinpoint the failing stage.

Frequently Asked Questions about adapter-tool-flow-debugging

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

FAQPage Schema
Why does Claude runtime tool flow loop or silently fail without a final assistant text output?

Claude runtime tool flows can loop or fail silently due to async execution stage breaks, mis-injected tool output, or finalize/text skip patterns. Diagnosing requires correlating these symptoms with the turn pipeline by inspecting ClaudeTurnTrace and ConversationState.Messages.

How do I debug missing tool calls or results in an async ClaudeEval runtime execution?

To debug missing tool calls or results in async runtime execution, verify AsyncToolExec polling tick registration and check ConversationState.Messages to confirm whether tool outputs were recorded and whether prompts include rich results.

What is the best way to trace where a Claude turn pipeline broke during adapter-path tool execution?

The best way to trace a broken turn pipeline is using ClaudeTurnTrace to inspect the lifecycle sequence for abnormal endings like tool loops or budget exhaustion, then checking LastProposal inspection to identify the exact break point.

How do I fix a ClaudeRuntime adapter that appears stuck during async tool execution?

Fixing a stuck ClaudeRuntime adapter involves running targeted AsyncToolExec diagnostics to check polling tick registration, finalize scheduling, continuation progress, and lingering polling-tick residues that block the pipeline.

Can I diagnose hallucinated answers caused by missing tool results in ClaudeEval?

Yes, you can diagnose hallucinated answers by verifying whether tool calls and results were recorded in ConversationState.Messages and checking if the final proposal text exists even when notebook rendering fails.

What should I check when tool_call text leaks into the final output of a Claude runtime adapter?

When tool_call text leaks into final output, check ClaudeTurnTrace for abnormal ending patterns and inspect LastProposal to determine if the finalize/text skip pattern caused the rendering failure.