frontend-debugging

Diagnose SvelteKit 2 and Svelte 5 frontend issues through a 10-phase debugging workflow.

1|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/nirukk52/ScreenGraph --skill frontend-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frontend-debugging
Source: https://github.com/nirukk52/ScreenGraph/tree/main/.claude-skills/frontend-debugging_skill
Command: npx skills add https://github.com/nirukk52/ScreenGraph --skill frontend-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

A disciplined 10-phase approach to diagnosing frontend issues in SvelteKit 2 + Svelte 5, covering rendering, routing, runes, SSR/CSR, and client-sync.

Core Features & Use Cases

  • Phase-by-phase checks (health, type safety, Encore client sync, runes, routing, API calls, SSR/CSR, isolation, build, browser tools)
  • Rune diagnostics to fix Svelte 5 issues (state, props, bindable)
  • Guidance for SSR hydration and client-server alignment
  • References for deeper patterns and debugging support

Quick Start

Trigger the flow with:

  1. Health check and type safety
  2. Ensure Encore client sync is up-to-date
  3. Validate rune usage and routing
  4. Use browser devTools for deeper diagnostics

Frequently Asked Questions about frontend-debugging

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

FAQPage Schema
How do I debug component rendering failures in SvelteKit 2 with Svelte 5?

Debugging component rendering failures in SvelteKit 2 requires a systematic 10-phase workflow starting with health checks and type safety validation, then confirming Encore client synchronization, validating rune usage ($state, $derived, $bindable), and checking SSR/CSR alignment. The Skill guides you through each phase with specific rules: enforce the Encore-generated client, ensure serializable data for SSR, and use browser DevTools to isolate rendering issues.

What causes Svelte 5 rune errors and how do I fix them?

Svelte 5 rune errors arise from incorrect $state, $derived, $bindable, and $props usage. The Skill provides phase-driven diagnostics that enforce mutability and binding rules, identify state mutations outside reactive contexts, and resolve prop-binding conflicts. This prevents common runtime issues and ensures correct reactivity patterns in your SvelteKit application.

How do I troubleshoot SSR hydration mismatches between server and client?

SSR hydration mismatches occur when server-rendered markup diverges from client-side rendering. The Skill includes dedicated SSR vs. CSR validation phases that ensure serializable data, confirm Encore client consistency between environments, and isolate environment-specific logic. This resolves hydration failures and synchronization problems.

Can I use this debugging approach for API client failures in SvelteKit?

Yes. The Skill covers API client failures as part of its 10-phase protocol, enforcing use of the Encore-generated client and forbidding manual fetch in production code paths. It diagnoses client synchronization issues, validates request/response data, and pinpoints routing or type errors affecting API calls.

What's the best way to diagnose routing problems in SvelteKit 2?

Diagnosing routing problems in SvelteKit requires phase-by-phase validation of type safety, rune correctness, and API client state. The Skill enforces a rule-based protocol that checks for routing configuration errors, confirms Encore client sync, validates component isolation, and uses browser tooling. This systematic approach isolates routing root causes quickly.

Do I need to use the Encore client for frontend debugging in SvelteKit?

Yes. The Skill's debugging protocol enforces use of the Encore-generated client and forbids manual fetch calls in production paths. This ensures type safety, client-server alignment, and serializable SSR data. Manual HTTP clients circumvent these protections and create difficult-to-diagnose runtime issues.