fullstack-debugger

Debug full-stack Next.js, Cloudflare Workers, and Supabase applications systematically.

181|30|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/curiositech/some_claude_skills --skill fullstack-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fullstack-debugger
Source: https://github.com/curiositech/some_claude_skills/tree/main/.claude/skills/fullstack-debugger
Command: npx skills add https://github.com/curiositech/some_claude_skills --skill fullstack-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill systematically troubleshoots and resolves complex issues across modern full-stack applications built with Next.js, Cloudflare Workers, and Supabase.

Core Features & Use Cases

  • Systematic Troubleshooting: Follows a proven debug philosophy to isolate and fix bugs.
  • Layered Analysis: Identifies issues across client, Next.js, Workers, Supabase, and external APIs.
  • Common Issue Resolution: Provides specific guidance for RLS policies, CORS errors, auth state, hydration mismatches, and more.
  • Use Case: Your Next.js app deployed on Cloudflare Pages is returning 500 errors for authenticated users, but works fine locally. This Skill will help you diagnose whether the issue lies in Supabase RLS policies, Worker logic, or environment variable misconfigurations.

Quick Start

Use the fullstack-debugger skill to help me troubleshoot a 500 error when fetching data from Supabase in my Next.js app.

Frequently Asked Questions about fullstack-debugger

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

FAQPage Schema
Why does my Next.js app return 500 errors on Cloudflare Pages but work locally?

Next.js 500 errors on Cloudflare Pages often stem from Supabase RLS policies, Worker logic, or environment variable misconfigurations. Systematic debugging isolates the issue across client, Next.js, Workers, and Supabase layers to identify the exact runtime failure.

How do I debug Supabase Row Level Security policies blocking data fetches?

Debugging Supabase RLS policies requires checking authentication state and policy logic across your full stack. Layered analysis traces the request from Next.js through Workers to Supabase, verifying auth tokens and policy conditions to isolate where the data access fails.

What is the best way to troubleshoot CORS errors in a Cloudflare Workers backend?

Troubleshooting CORS errors in Cloudflare Workers involves analyzing response headers and request origins across your stack. Systematic debugging checks Worker logic and Next.js fetch configurations to ensure proper cross-origin resource sharing headers are returned.

How do I fix Next.js hydration mismatches when fetching from Supabase?

Fixing Next.js hydration mismatches with Supabase data involves checking client and server rendering states. Structured troubleshooting identifies where server-rendered HTML differs from client output, ensuring consistent data fetching and authentication state across the stack.

Can I diagnose build failures across Next.js and Cloudflare Workers systematically?

Yes, you can diagnose build failures across Next.js and Cloudflare Workers using a structured troubleshooting methodology. Diagnostic scripts and layered analysis identify whether failures originate in Next.js build configurations, Worker deployment settings, or Supabase dependencies.