debug-apps

Diagnose Engranatge local app health via curl, Docker, and logs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/guillempuche/engranatge --skill debug-apps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-apps
Source: https://github.com/guillempuche/engranatge/tree/main/.claude/skills/debug-apps
Command: npx skills add https://github.com/guillempuche/engranatge --skill debug-apps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps developers quickly identify and resolve health issues in the local Engranatge development environment, covering the server, internal (Forja), and marketing applications.

Core Features & Use Cases

  • Pre‑flight health checks for each app using curl endpoints and process inspection.
  • Environment validation including .env variables, Docker containers, and database migrations.
  • Common issue diagnostics for CORS errors, authentication failures, missing services, and email handling problems.
  • Guided remediation with specific commands to start services, reset databases, and inspect logs.

Quick Start

Ask the assistant to debug the Engranatge apps and report which are down and how to fix them.

Frequently Asked Questions about debug-apps

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

FAQPage Schema
How do I debug local Engranatge apps that are down?

Troubleshoot Engranatge app health issues by inspecting Docker services, validating environment variables, and executing curl health endpoint checks across server, internal, and marketing apps. It analyzes logs and process status to provide remediation steps.

How do I fix CORS and authentication errors in my local development environment?

Resolve CORS and auth failures by validating local .env variables, checking Docker service health, and analyzing application logs for configuration errors. The skill generates actionable commands to restart services and correct environment misconfigurations.

What is the best way to check Docker service status for local Engranatge applications?

Diagnose Docker service status by running container health checks, inspecting process lists, and curling local health endpoints for server, Forja, and marketing apps. The skill identifies missing processes and generates commands to start or reset services.

Why does my Engranatge local server fail to connect to internal services?

Diagnose local server connection failures by validating .env configurations, checking Docker container statuses, and curling internal Forja health endpoints. The skill analyzes server logs to detect missing processes and outputs specific commands to restore service connectivity.

Do I need Docker running to diagnose Engranatge health issues?

Docker is required to diagnose Engranatge health issues comprehensively, as the skill executes Docker status commands to validate containers, database migrations, and service availability. Environment validation also depends on Docker to detect missing processes and auth failures.

How do I reset databases and restart local app services after a health check failure?

Execute guided remediation commands to reset databases, restart Docker containers, and clear missing processes identified during health checks. The skill provides specific terminal commands to restore server, Forja, and marketing apps to a healthy local state.