insforge-debug
The insforge-debug skill provides a diagnostic framework for InsForge projects by leveraging observability primitives including logs, metrics, database health, policies, metadata, and AI-assisted triage. It offers structured recipes for troubleshooting common issues like SDK errors, HTTP status codes, RLS access problems, authentication failures, and deployment errors.
Is insforge-debug safe to install?
Review the source first: our audit of insforge-debug's source files found 12 shell commands, 0 external URLs, file reads and writes (high risk). Every command and URL listed appears verbatim in the skill's source. The skill executes shell commands via the InsForge CLI which can interact with remote infrastructure, query databases, and modify deployment states.
How we audit skills: our security review methodology.
Who is this skill for?
Developers and engineers working on InsForge projects who need to diagnose backend, database, or deployment issues.
What can you do with it?
- Diagnosing reactive failures like HTTP 4xx/5xx errors, gateway timeouts, and SDK error objects.
- Performing proactive audits for security, performance, and system health.
- Troubleshooting RLS access issues and authentication failures.
- Investigating edge function runtime errors and deployment failures.
- Analyzing system-wide performance degradation using metrics and logs.
How good is this skill?
Quality score: 5/10. The skill documentation is comprehensive, providing clear command references and specific troubleshooting recipes for various failure modes.
What does the skill file contain?
# 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 @insforge/cli`** — never install the CLI globally. ## Fastest Path: AI-Assisted Triage When the user gives a concrete description (error mes...
Frequently asked questions
How should I start if I have an error but do not know the cause?
Use the AI-assisted triage command 'npx @insforge/cli diagnose --ai "<issue description>"' to generate a hypothesis, then verify the suggestion against the specific observability primitives cited by the agent.
Are there specific commands for RLS access issues?
Yes. You can use 'npx @insforge/cli db policies' to list active RLS rules and 'npx @insforge/cli db query "SELECT id, user_id FROM <table>"' to confirm data visibility as a service role.
Can I perform a proactive audit without a platform login?
No. The full advisor scan requires a platform login via 'npx @insforge/cli login'. If the project is linked via an API key, you must perform a manual audit using db-health, policies, and metadata commands.
Related skills
systematic-debugging
173.2KSoftware engineers and AI agents tasked with resolving bugs, test failures, or unexpected system behaviors
A structured methodology for debugging technical issues by prioritizing root cause identification over symptom-based patching. It mandates a four-phase process: root cause investigation, pattern analysis, hypothesis testing, and implementation, while providing specific protocols for handling persistent failures and architectural concerns.
convex-setup-auth
80.1KDevelopers building applications on the Convex platform who need to integrate authentication providers like Clerk, Auth0, WorkOS, or Convex Auth
This skill provides a structured workflow for implementing authentication, identity mapping, and access control within Convex applications. It guides the agent to identify the appropriate auth provider, consult official documentation, and apply secure patterns for protecting backend functions.
convex-performance-audit
79.2KDevelopers working with Convex applications who need to optimize slow features, resolve high-resource usage, or address transaction contention
The convex-performance-audit skill provides a structured workflow for diagnosing and resolving performance issues in Convex applications, including read amplification, OCC conflicts, subscription costs, and function limits.
convex-quickstart
78.3KDevelopers and AI agents building applications with Convex who need to initialize projects or integrate Convex into existing codebases
This skill automates the setup and configuration of Convex in new or existing web applications. It handles project scaffolding, environment variable generation, provider wiring, and local deployment provisioning.