hydration-fix-skill

Diagnose Nuxt 4 hydration mismatches and propose ranked fixes for approval.

Updated Jan 22, 2025
One-click install
npx skills add https://github.com/lafllamme/personal-page --skill hydration-fix-skill
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: hydration-fix-skill
Source: https://github.com/lafllamme/personal-page/tree/main/.cursor/skills/hydration-fix-skill
Command: npx skills add https://github.com/lafllamme/personal-page --skill hydration-fix-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose Nuxt 4 hydration mismatches (SSR vs CSR DOM, JS, CSS) before applying any changes, reducing risky edits and rollbacks.

Core Features & Use Cases

  • Analysis-first workflow: identify causes without editing code.
  • Proposal-only until approval: present ranked fixes and ask for consent.
  • Context-aware checks: aligns with project architecture, docs, and Nuxt patterns.
  • Use Case: When a component renders differently between server and client or hydration warnings appear, this skill guides the diagnosis and proposal process.

Quick Start

Start with a guided analysis to identify hydration mismatches and present approved fix options for review.

Frequently Asked Questions about hydration-fix-skill

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

FAQPage Schema
How do I fix Nuxt 4 hydration mismatches without breaking existing components?β–Ό

To fix Nuxt 4 hydration mismatches safely, use an analysis-first workflow that identifies SSR vs CSR discrepancies and proposes ranked fixes for approval before applying any code changes.

Why does my Nuxt component render differently during server-side rendering and client-side hydration?β–Ό

Nuxt components render differently due to hydration mismatches caused by client-only API usage, SSR vs CSR DOM discrepancies, or CSS-related issues that this analysis workflow identifies without editing code.

What is the best way to debug SSR vs CSR DOM discrepancies in Nuxt?β–Ό

The best way to debug SSR vs CSR discrepancies is a context-aware analysis that reads project architecture and docs constraints to yield a ranked set of fixes suitable for reviewer approval.

Does this hydration analysis workflow automatically apply patches to frontend code?β–Ό

No, the hydration analysis workflow remains proposal-only until approval, presenting ranked fixes for SSR vs CSR discrepancies and client-only API usage to ensure safe debugging without risky edits or rollbacks.

Can I diagnose CSS-related hydration issues alongside JavaScript API mismatches?β–Ό

Yes, you can diagnose CSS-related hydration issues alongside client-only JavaScript API usage and DOM discrepancies across Nuxt components and routes during the analysis-first workflow.

When should I run a hydration mismatch analysis on my Nuxt project?β–Ό

Run a hydration mismatch analysis when hydration warnings appear or a component renders differently between the server and client, ensuring fixes align with Nuxt patterns before implementation.