Insforge Debug
When something breaks in your InsForge project, this gives you a structured way to figure out what. It maps nine observability primitives (logs, metrics, DB health checks, RLS policies, deploy state) to symptom recipes for common failures like RLS denials, slow queries, auth errors, and function timeouts. The AI assisted triage mode is the fastest entry point if you have a concrete error message, though you should verify its suggestions against the raw primitives before acting. Most useful when you're staring at a 403 or empty result set and need to know whether it's RLS, a missing index, or bad auth config. Everything runs through npx commands, never global installs.
- skills.sh installs
- 61.2K
- GitHub stars
- 47
- last updated
- Aug 21, 2026
Install
$ npx -y skills add insforge/insforge-skills --skill insforge-debug --agent claude-codeInstalls into .claude/skills of the current project.
Files
InsForge Debug
Diagnose problems in InsForge projects by combining the backend's observability primitives — logs, metrics, db-health, advisor, policies, metadata, error objects, deploy state, and AI assist. This skill provides:
- A reference per debug primitive (one observability surface each — under
references/) - Symptom Recipes (below) that name the primitive sequence for known reactive symptoms and proactive audits
Always use npx -y @insforge/cli — never install the CLI globally.
Fastest Path: AI-Assisted Triage
When the user gives a concrete description (error message, failing URL, HTTP status), hand it to the InsForge debug agent. Unlike the other primitives, this one returns suggestions, not just observations — verify the diagnosis against the primitives it cites before acting on it.
npx -y @insforge/cli diagnose --ai "<issue description>"
See references/ai-assisted.md for when to use this first vs when to skip, and how to verify the output.
Debug Primitives
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/insforge/insforge-skills
- Categories
- Backend & APIs, Security, DevOps & CI/CD, Git & Pull Requests, Code Review & Quality, Release Management, Debugging, Marketing & SEO, Cloud & Infrastructure
- First seen
- Jun 3, 2026
More from insforge/insforge-skills
All 4Recommended
More Backend & APIs
clerk-nextjs-patternsclerk/skillsAdvanced Next.js patterns - middleware, Server Actions, caching with Clerk.55.5Kskills.sh installs
azure-computemicrosoft/github-copilot-for-azureAzure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight 47.5Kskills.sh installs
convex-expertconvex/agent-skillsConvex backend specialist. Use this agent for any code inside a `convex/` directory — function definitions, schemas, indexes, queries, mutations, actions, HTTP 41.4Kskills.sh installsconvex-addconvex/agent-skillsAdd a capability to the CURRENT Convex app — consults the served Convex capability catalog for always-current procedures (billing, crons, auth, agent, search, …41.1Kskills.sh installs
neon-object-storageneondatabase/agent-skillsS3-compatible object storage that branches with your database, so each branch gets its own copy of the files and the rows that point at them. Use when a user wa40.5Kskills.sh installs
limrun-android-emulatorlimrun-inc/skillsDrive an app running on a Limrun cloud Android emulator: install an APK, launch and terminate apps with crash reports, tap, type, read the UI element tree, scre40.2Kskills.sh installs