investigation-mode

Diagnose stuck or failing applications by triaging runtime logs, workflow runs, browser state, and deployments.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/AarnavBaddam/skills --skill investigation-mode-aarnavbaddam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigation-mode
Source: https://github.com/AarnavBaddam/skills/tree/main/investigation-mode
Command: npx skills add https://github.com/AarnavBaddam/skills --skill investigation-mode-aarnavbaddam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an application hangs, fails silently, or stops responding, developers often guess at causes or dig through logs randomly. This Skill enforces a systematic triage order—runtime logs, workflow status, browser verification, then deployment checks—so root causes are found faster and every step is reported to the user. ## Core Features & Use Cases - Structured Triage Order: Checks runtime logs first, then workflow/background job status, then browser state via screenshots and console inspection, and finally deployment and environment configuration. - Reporting Contract: Requires announcing each check, sharing the evidence found, and explaining the next step so users are never left in silence during debugging. - Common Hang Cause Detection: Looks for missing awaits, unresolved promises, infinite loops, missing environment variables, connection pool exhaustion, and middleware that never returns. - Use Case: A user reports their Vercel deployment shows a blank page. The Skill checks vercel logs, finds a timeout on a database call, inspects the workflow run stuck in running state, and identifies a missing await as the root cause. ## Quick Start Ask the assistant to investigate why your app is stuck or not responding and have it check the logs, workflow runs, and deployment status step by step.

Frequently Asked Questions about investigation-mode

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

FAQPage Schema
How do I debug an app that is stuck or not responding?

Follow a fixed triage order: check runtime logs first, then workflow or background job status, then verify browser state with screenshots and console errors, and finally inspect deployment and environment configuration. Stop when you find a high-confidence root cause.

How do I check Vercel logs for a failing deployment?

Run `vercel logs --follow` for production or `vercel logs <deployment-url>` for a specific deployment. Use `vercel inspect <deployment-url>` to review build output, function regions, and environment settings.

Why does my workflow run stay stuck in running state?

A run stuck in `running` usually indicates a missing `await` or an unresolved promise inside a step. Check run details with `vercel workflow runs get <run-id>` and look for failed steps, retry exhaustion, or timeout errors.

What are common causes of hanging API requests?

Frequent culprits include missing awaits, unresolved promises, middleware that never calls next() or returns a response, connection pool exhaustion, missing environment variables, and function timeouts configured too short in vercel.json.

What should I do when there are no logs to debug with?

Missing logs is itself the problem—add structured logging before continuing. Wrap API handlers in try/catch with console logging and log entry and exit of every workflow step so the last log line reveals where execution stopped.