copilotkit-debug

Diagnose CopilotKit runtime, SSE streaming, and agent failures.

Updated May 9, 2026
One-click install
npx skills add https://github.com/gptdeivid/HackathonGoogle-by-Deivid --skill copilotkit-debug-gptdeivid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: copilotkit-debug
Source: https://github.com/gptdeivid/HackathonGoogle-by-Deivid/tree/main/.cursor/skills/copilotkit-debug
Command: npx skills add https://github.com/gptdeivid/HackathonGoogle-by-Deivid --skill copilotkit-debug-gptdeivid

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose why a CopilotKit application is failing, from unreachable runtimes and broken agent connections to stalled streams, tool errors, transcription problems, and package mismatches.

Core Features & Use Cases

  • Runtime Connectivity Checks: Verify the runtime URL, base path, CORS setup, and discovery endpoint when the client cannot connect.
  • Agent and Stream Tracing: Compare registered agents with the active agentId and follow AG-UI SSE events to find where a run stalls or fails.
  • Tool and Transcription Debugging: Isolate frontend tool registration issues, malformed tool arguments, handler exceptions, and voice transcription failures.
  • Use Case: A developer sees CopilotChat load but never receive a reply, so this Skill walks through the info endpoint, event stream, error codes, and model configuration until the root cause is clear.

Quick Start

Use this skill to inspect your CopilotKit runtime configuration, confirm the registered agent name, and trace the failing event stream or error code until the issue is isolated.

Frequently Asked Questions about copilotkit-debug

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

FAQPage Schema
Why does my CopilotKit application load but never receive a reply from the agent?

CopilotKit runtime failures prevent agent replies when SSE streaming stalls or the agentId is mismatched. Diagnosing the issue requires inspecting the info endpoint, tracing AG-UI event flow, and verifying model configuration to isolate where the run stalls.

How do I debug CopilotKit runtime connectivity issues and SSE streaming errors?

Debug CopilotKit runtime connectivity by verifying the runtime URL, base path, CORS setup, and discovery endpoint. Trace AG-UI SSE events to find where the stream stalls, and inspect package versions to identify mismatch issues causing the connection failure.

How do I fix frontend tool execution errors in CopilotKit?

Fix CopilotKit tool execution errors by isolating frontend tool registration issues and checking for malformed tool arguments. Inspect handler exceptions within the runtime configuration to determine why the tool fails during the agent run.

What causes version mismatch issues in CopilotKit applications?

Version mismatch issues in CopilotKit applications occur when package versions are incompatible across the runtime and client. Inspecting package versions and runtime configuration reveals the conflicting dependencies causing agents and streams to fail.

How do I resolve voice transcription failures in CopilotKit?

Resolve CopilotKit voice transcription failures by inspecting the runtime configuration and tracing the AG-UI event flow. Isolate the transcription component to identify whether the failure stems from handler exceptions or agent connection drops.

Can I trace AG-UI events to find where a CopilotKit agent run stalls?

Tracing AG-UI events isolates where a CopilotKit agent run stalls by following the SSE stream from the registered agent. Comparing the active agentId against registered agents and checking error codes pinpoints the exact failure point.