web-backend-debugger

Debug Next.js backend issues across Supabase, Prisma, Stripe webhooks, and license validation.

12|3|Updated Sep 24, 2025
One-click install
npx skills add https://github.com/mikha08-rgb/VoiceLite --skill web-backend-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-backend-debugger
Source: https://github.com/mikha08-rgb/VoiceLite/tree/main/.claude/skills/web-backend-debugger
Command: npx skills add https://github.com/mikha08-rgb/VoiceLite --skill web-backend-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires prisma, stripe, vercel.

What problem does it solves? This Skill simplifies debugging for the VoiceLite Next.js web backend, including Supabase, Prisma, license validation, and Stripe webhooks, ensuring smooth operation of critical online services.

Core Features & Use Cases

  • Health Checks: Provides quick commands to verify database connection, environment variables, and Supabase status.
  • License Validation Debugging: Guides through checking license keys, activation counts, and rate limits in the database and code.
  • Stripe Webhook Testing: Instructions for local testing and troubleshooting webhook signature verification.
  • Use Case: If a user reports their Pro license isn't activating, use this skill to guide through checking the license key in Supabase, verifying activation counts, and debugging the /api/licenses/validate endpoint to quickly resolve the issue.

Quick Start

Debug a license validation issue for VoiceLite Pro, checking the license key in Supabase and testing the /api/licenses/validate endpoint.

Frequently Asked Questions about web-backend-debugger

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

FAQPage Schema
How do I debug API route failures and 500 errors in my Next.js backend?

Debugging API route failures involves running health checks to verify database connections and environment variables, then inspecting error logs from your Next.js 15.5.4 app router and Supabase PostgreSQL. This Skill provides commands to isolate whether failures stem from database migrations, Prisma connection issues, or middleware problems.

How do I test and verify Stripe webhook signatures locally?

Stripe webhook testing requires local verification of webhook signatures against your Supabase backend. This Skill includes instructions to configure webhook endpoints, validate signature verification in your Next.js routes, and troubleshoot common webhook failures without deploying to production.

Why isn't my license validation working, and how do I debug it?

License validation issues typically stem from incorrect license keys in Supabase, exceeded activation counts, or bugs in the `/api/licenses/validate` endpoint. This Skill guides you through querying the database to verify license records, checking activation counts, and testing the validation endpoint directly.

What health checks should I run on my Supabase and Prisma database?

Essential health checks verify database connectivity, confirm environment variables are set correctly, and validate Supabase status. This Skill provides quick commands to test Prisma connections, inspect migration status, and confirm your Next.js backend can reach PostgreSQL.

Can I debug Prisma migrations and connection issues in production?

Yes. This Skill enforces migration workflows and connection diagnostics for both local and production environments, helping you identify migration failures, connection timeouts, and Prisma schema mismatches without downtime.

Do I need to understand Prisma, Supabase, and Stripe to use this debugging workflow?

Familiarity with Prisma schema, Supabase PostgreSQL structure, and Stripe webhook concepts is helpful but not required. This Skill walks through debugging steps for each component, translating common errors and guiding you through fixes.