Convex Agents Debugging
Troubleshoots agent behavior, logs LLM interactions, and inspects database state. Use this when responses are unexpected, to understand context the LLM receives, or to diagnose data issues.
npx skills add majiayu000/claude-skill-registry --skill convex-agents-debugging --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
## Purpose Debugging tools help understand what's happening inside agents, what the LLM receives, and what's stored. Essential for developing reliable agent applications. ## When to Use This Skill - Agent behavior is unexpected - LLM responses are off-target - Investigating why certain context isn't being used - Understanding message ordering - Checking file storage and references - Auditing tool calls and results - Profiling token usage ## Log Raw LLM Requests and Responses ```typescript const myAgent = new Agent(components.agent, { name: "My Agent", languageModel: openai.chat("gpt-4o-mini"), rawRequestResponseHandler: async (ctx, { request, response }) => { console.log("LLM Request:", JSON.stringify(request, null, 2)); console.log("LLM Response:", JSON.stringify(response, null, 2)); await ctx.runMutation(internal.logging.saveLLMCall, { request, response, timestamp: Date.now(), }); }, }); ``` ## Log Context Messages See exactly what context the LLM receives: ```typescript const myAgent = new Agent(components.agent, { name: "My Agent", languageModel: openai.chat("gpt-4o-mini"), contextHandler: async (ctx, args) => { console.log("Context Messages:", { recent: args.recent.length, sea
- Purpose
- When to Use This Skill
- Log Raw LLM Requests and Responses
- Log Context Messages
- Inspect Database Tables
- Fetch Context Manually
- Trace Tool Calls
- Fix Type Errors
- Analyze Message Structure
- Key Principles
- Next Steps
What does the Convex Agents Debugging skill do?
Troubleshoots agent behavior, logs LLM interactions, and inspects database state. Use this when responses are unexpected, to understand context the LLM receives, or to diagnose data issues.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill convex-agents-debugging --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.