Use when the sandbox app fails to build, boot, render, authenticate, call AI routes, read offers, or deploy cleanly.
Install
npx skillscat add vibiz-ai/vibiz-saas/vibiz-runtime-repair Install via the SkillsCat registry.
SKILL.md
Vibiz Runtime Repair
Repair the real failure. Do not bypass platform contracts to make an error disappear.
Start here:
- Read the exact error, terminal output, browser console, or failing route response.
- Inspect the file named in the stack trace before changing adjacent code.
- Check env-dependent code in
src/lib/auth.ts,src/middleware.ts,src/lib/sapiom.ts,src/lib/api-guard.ts, andscripts/migrate.mjs. - Check sandbox boot behavior in
e2b.tomland template build behavior inDockerfile.
Safe repair patterns:
- If auth is unavailable because Turso env vars are missing, preserve landing-page-only mode and existing guards.
- If AI routes fail because
SAPIOM_API_KEYis missing, keep server-only behavior and return a clear unavailable state. - If a user-supplied third-party integration truly requires a runtime key, put it in
.envserver-side and keep it out of browser-exposedNEXT_PUBLIC_*vars unless the key is designed to be public. - If offers are missing, preserve
getSeededOffers()fallback behavior and do not fabricate seeded offers. - If Tailwind fails, fix class/config/CSS compatibility instead of removing whole sections.
- If Next build fails from runtime-only env assumptions, make the code tolerate absent envs during build without exposing secrets or disabling production behavior.
Verification:
- Run the failing command again after each targeted fix.
- Run
npm run buildbefore considering runtime repairs complete. - Search for accidental secret exposure with
rg -n "SECRET|TOKEN|API_KEY|STRIPE".