reatom-debug

Debug Reatom v1000+ runtime, routing, React boundary, and test failures.

4|Updated May 12, 2026
One-click install
npx skills add https://github.com/Guria/reatom-skill --skill reatom-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reatom-debug
Source: https://github.com/Guria/reatom-skill/tree/main/skills/reatom-debug
Command: npx skills add https://github.com/Guria/reatom-skill --skill reatom-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you systematically debug Reatom runtime, routing, React boundary, and test failures without guessing or accidentally breaking the project’s strict-context assumptions.

Core Features & Use Cases

  • Freeze the symptom first: capture the exact error text, failing screen/test, and the smallest proof command before changing anything.
  • Verify observability early: confirm dev-time connectLogger is wired from the earliest setup import so you can see ownership and async boundaries.
  • Route the failure by layer: use targeted checks for missing async stack, root/provider setup seam issues, AbortError/redirect flicker, and loader invalidation patterns.
  • Repair the smallest boundary and prove it: apply a minimal fix (e.g., wrap the host callback or correct the provider/route owner) and validate with the narrowest failing proof.

Quick Start

Ask the skill to debug your issue by giving the exact error message and the smallest command that reproduces it, then follow its triage sections to verify connectLogger setup, identify the failing boundary, and run a narrow proof to confirm the fix.

Frequently Asked Questions about reatom-debug

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

FAQPage Schema
How do I debug missing async stack errors in Reatom?

Debug missing async stack errors in Reatom by freezing the exact symptom first, then verifying dev-time observability using connectLogger in the earliest strict setup import. This reveals ownership and async boundaries, allowing you to narrow the failure to the smallest boundary before applying a fix.

Why does AbortError cause redirect flicker in my Reatom routing setup?

AbortError and redirect flicker in Reatom routing stem from route ownership or loader invalidation patterns. Route the failure by layer using targeted checks to identify the provider/root setup seam issue, then apply a minimal fix to the route owner and validate with a narrow proof.

How do I fix Reatom test failures that appear after calling clearStack?

Fix Reatom test failures after clearStack by capturing the exact failing test and the smallest proof command. Narrow the issue to the failing React boundary, apply a minimal fix like wrapping the host callback, and validate completion by running the narrowest failing proof command.

What is the proper way to set up connectLogger for Reatom debugging?

Set up connectLogger for Reatom debugging by wiring it from the earliest setup import. This ensures you can see ownership and async boundaries during development, which is critical for tracing missing async stacks and provider setup errors without breaking strict-context assumptions.

Does this Reatom debugging workflow work for React provider and root setup errors?

Yes, this Reatom debugging workflow specifically handles React boundary failures including provider and root setup seam errors. It guides you to verify observability early, identify the failing boundary, and apply a minimal fix like correcting the provider or route owner to resolve the issue.