debugging

Troubleshoots TanStack app issues across authentication, payments, database queries, and API routes.

Updated Dec 25, 2025
One-click install
npx skills add https://github.com/Mavrick91/tanstack-start-app --skill debugging-mavrick91
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging
Source: https://github.com/Mavrick91/tanstack-start-app/tree/main/.claude/skills/debugging
Command: npx skills add https://github.com/Mavrick91/tanstack-start-app --skill debugging-mavrick91

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging guide for TanStack apps to quickly identify and resolve common issues across authentication, payments, database queries, React components, and API routes.

Core Features & Use Cases

  • Quick Diagnosis: step-by-step symptom checks for common errors (401, 403, 429, 500) with practical checks.
  • Targeted Fixes: actionable remediation steps for auth, API routes, payments, databases, and frontend issues.
  • Guided Troubleshooting: reference commands, SQL queries, and code snippets to reproduce and fix issues.
  • Use Case: when a route returns 500 due to a missing dependency, use this guide to locate the error in logs, verify environment variables, and validate data flow.

Quick Start

Start with the Quick Diagnosis table to identify the symptom and apply the recommended fixes.

Frequently Asked Questions about debugging

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

FAQPage Schema
How do I troubleshoot a 500 error on an API route in a TanStack app?

To troubleshoot a 500 error on an API route in a TanStack app, locate the error in logs, verify environment variables, validate data flow, and apply configuration checks to identify missing dependencies and root causes.

What is the best way to debug authentication session handling issues?

Debugging authentication session handling issues requires step-by-step symptom checks for 401 and 403 errors, applying targeted fixes to session validation logic and routing to resolve access failures rapidly.

How do I fix database query failures during data fetching in development?

Fix database query failures during data fetching by running reference SQL queries to reproduce the issue, validating data inputs, and applying concrete remediation steps to correct query logic and configuration.

Can I use this troubleshooting guide to resolve frontend React component errors in production?

Yes, you can use this troubleshooting guide to resolve frontend React component errors in production environments by applying targeted fixes and code snippets for data fetching and validation issues.

Why are my payment processing API routes returning 429 errors?

Payment processing API routes return 429 errors due to rate limiting issues, which you can diagnose using step-by-step symptom checks and resolve by applying actionable remediation steps to request configurations.