claude-code - 💡(How to fix) Fix Harness hangs indefinitely after Skill tool returns tool_result — no API call, no assistant event, no token usage [1 participants]

Summary

After invoking the Skill tool, the harness occasionally hangs for many minutes with zero visible activity — no assistant event written to the session JSONL, no usage block, no token delta. The model is never called. The only recovery is to interrupt with Esc/Ctrl+C and resend.

I first assumed these were slow extended-thinking turns, but the JSONL proves otherwise: real thinking writes an assistant event at the end with a usage block; these stalls write nothing at all between the Skill tool's tool_result event and the user's interrupt event.

Environment

• Claude Code version: 2.1.107
• Platform: darwin 25.4.0 (macOS)
• Shell: zsh
• Model: claude-opus-4-6 (1M context)
• Project location: iCloud Drive (~/Library/Mobile Documents/com~apple~CloudDocs/...) — may or may not be relevant

Reproducer (observed)

1. Start a normal Claude Code session in a project directory.
2. Invoke a Skill via the Skill tool (e.g. superpowers:writing-plans, superpowers:subagent-driven-development). The skill content is returned as a tool_result event in the session JSONL.
3. Claude should now emit its next assistant turn (thinking + text + any tool calls).
4. Instead: nothing happens. No assistant event. No usage record. Silence for minutes until the user interrupts.

Not 100% reproducible on every Skill invocation — observed 2–3 times in a single day of heavy use. Correlation with the Skill tool is tight: every observed stall begins on the turn immediately following a Skill tool_result.

Evidence from JSONL

Two sessions from 2026-04-14, same project, analyzed by parsing the JSONL files in ~/.claude/projects/<slug>/<session>.jsonl:

The "control" row is a legitimate slow-thinking turn in the same session — it writes a full assistant event with a usage block at the end. The two stall rows have zero events between the Skill tool_result and the interrupt, proving the model was never invoked.

Expected behavior

After a Skill tool_result arrives, the harness should send the conversation to the API within seconds, and either:

• produce an assistant event with a usage block (possibly many seconds later for long thinks), or
• fail visibly with an error event.

Actual behavior

The harness enters a state where no API request is made (no assistant event, no token usage) and remains there indefinitely until the user interrupts. After interrupt + retry, the same turn completes normally in seconds.

Impact

From the user's side it is indistinguishable from a hang. We lost 40+ minutes in a single instance and had to interrupt and resend. The UI status bar shows a token counter that never ticks, which is the giveaway — but it's easy to mistake for "Claude is thinking very hard."

Diagnostic suggestions

1. Log the exact point between "Skill tool_result written to JSONL" and "request dispatched to API" — is the request being constructed? Submitted? Waiting on a lock?
2. Check whether skill content of certain sizes (the two observed stalls were triggered by skills with ~300–600 line markdown bodies) crosses a buffer/chunking threshold.
3. Add a client-side timeout + error event when a turn has been in "awaiting assistant response" state for > N seconds with no network activity, so users can tell hang from think.

Happy to share the full JSONL files privately if useful — they contain project context so I'd rather not attach publicly.