debug-local

Diagnose local development issues by checking Docker statuses, container logs, and environment variables.

1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/g-bastianelli/nuthouse --skill debug-local
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-local
Source: https://github.com/g-bastianelli/nuthouse/tree/main/stack-golem/skills/debug-local
Command: npx skills add https://github.com/g-bastianelli/nuthouse --skill debug-local

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires docker, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill assists with proactive investigation of runtime errors, service failures, and auth issues during local development on the notom platform, reducing the need for user intervention.

Core Features & Use Cases

  • Symptom Classification: Route issues based on user reports (missing env vars, unreachable services, auth errors).
  • Env Var Handling: Identify and create missing .env files for correct application operation.
  • Service and Auth Checks: Validate service statuses and diagnose auth problems.
  • Use Case: If a user reports a service not starting, this Skill automatically checks Docker statuses, container logs, and env variables, providing actionable insights without requiring the user to run commands.

Quick Start

Use the debug-local skill to investigate an issue where the authentik-server is not starting.

Frequently Asked Questions about debug-local

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

FAQPage Schema
How do I troubleshoot a Docker container that won't start during local development?

Troubleshooting a Docker container that won't start involves checking Docker container statuses, inspecting container logs, and verifying environment variables to identify missing configurations or runtime errors preventing service startup.

What is the best way to diagnose auth issues in local dev environments?

Diagnosing auth issues in local dev environments requires validating service statuses and checking environment variables to detect misconfigurations. Proactive diagnostics route auth errors based on symptom classification to pinpoint the exact authentication failure.

Why does my service fail to connect when environment variables are missing?

Your service fails to connect when environment variables are missing because local development requires specific `.env` files for correct operation. Identifying and creating these missing environment files resolves unreachable service errors and runtime failures.

Do I need Docker installed to investigate local runtime errors?

Yes, you need Docker installed to investigate local runtime errors on this platform. The diagnostic process requires direct access to the Docker environment to manage containers, check statuses, and review logs for service failures.

Can I automatically classify local dev symptoms like missing env vars and service failures?

Yes, you can automatically classify local dev symptoms like missing env vars and service failures. Symptom classification routes issues based on user reports, categorizing missing environment variables, unreachable services, and auth errors for targeted diagnostics.

How do I verify service status and check container logs without running manual commands?

You can verify service status and check container logs without manual commands by using proactive investigation tools that automatically query Docker statuses and extract container logs, providing actionable insights into runtime errors and service failures.