solid-ssr-hydration-debugger
Trigger
Use when SSR output and client hydration diverge, or browser-only assumptions leak into server render paths.
Required Inputs
- Reproduction steps and environment mode.
- Affected route/component boundaries.
- Error logs and observed mismatch behavior.
Workflow
- Build deterministic reproduction path with explicit route/component inputs.
- Isolate mismatch class: non-deterministic render, browser-only access, async timing, or conditional render drift.
- Recommend fix strategy using SSR-safe primitives and hydration boundaries.
- Provide verification checklist for server/client parity.
Failure Modes
- Non-reproducible issue report: request exact steps and route context.
- Fix without root-cause classification: mark invalid output.
- Browser API in server path unresolved: fail until guarded.
Output Contract
Return DomainGuidanceOutput with root-cause decisions, remediation handoff, and citations referencing normalized doc_id values.
Validation
node tools/scripts/validate-skills.mjs --skill solid-ssr-hydration-debuggernode tools/scripts/validate-solid-corpus.mjs
Key Corpus References
Use these doc_id values with the read_corpus_doc MCP tool:
solid-core.reference.rendering.hydrate— client hydration attachmentsolid-core.reference.rendering.is-server— SSR guard constantsolid-core.reference.rendering.render-to-stream— streaming SSR with Suspensesolid-core.reference.rendering.hydration-script— hydration bootstrappersolid-router.solid-router.rendering-modes.ssr— router SSR rendering mode
References
../../references/solidjs/performance-ssr.md../../references/solidjs-normalized/docs/reference/rendering/hydrate.md../../references/solidjs-normalized/docs/reference/rendering/is-server.md../../references/solidjs-normalized/docs/reference/components/no-hydration.md../../references/solidjs-normalized/docs/solid-router/rendering-modes/ssr.md
Converted and distributed by TomeVault — claim your Tome and manage your conversions.