Agent skill · data analytics · insforge
insforge-debug
Use when diagnosing problems in an InsForge project — reactive failures (SDK error object, HTTP 4xx/5xx, gateway timeout 502/503/504, edge function failure or timeout, login/OAuth/auth errors, RLS denial, realtime channel issues, slow query on one endpoint, edge function or Vercel deploy failure), proactive audits (security/RLS review, performance/index review, system health check, pre-launch readiness), or when the user has an error but doesn't know where to start.
Why this skill is useful
Provides specific commands and workflows for diagnosing issues in InsForge projects that the AI wouldn't reliably generate on its own.
What it needs
Requires @insforge/cli installed locally. About 9k tokens when loaded. Last updated 2026-08-06. 36 stars on the source repository.
What this skill does
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: 1. A reference per debug primitive (one observability surface each — under references/) 2. 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. See references/ai-assisted.md for when to use this first vs when to skip, and how to verify the output. Debug Primitives Each primitive is one independently-queryable observability surface backed by a distinct underlying data source. Real diagnoses are compositions of primitives. All commands run via npx -y @insforge/cli .... The (command) shown next to each primitive is the actual CLI command — primitive names are concept labels, not CLI subcommand names (e.g., "DB health" is diagnose db, not diagnose db-health; "Policies" is db policies, not diagnose policies). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills insforge/insforge-debug