troubleshooter

Diagnose and resolve common Open Mercato standalone application issues by layer.

1.6k|354|Updated Sep 10, 2025
One-click install
npx skills add https://github.com/open-mercato/open-mercato --skill troubleshooter-open-mercato
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooter
Source: https://github.com/open-mercato/open-mercato/tree/main/packages/create-app/agentic/shared/ai/skills/troubleshooter
Command: npx skills add https://github.com/open-mercato/open-mercato --skill troubleshooter-open-mercato

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers diagnose and resolve common errors and unexpected behaviors within Open Mercato standalone applications, reducing debugging time.

Core Features & Use Cases

  • Systematic Diagnosis: Guides users through identifying the problematic layer (module, entity, API, UI, build, extension, database).
  • Automated Fixes: Suggests and executes commands like yarn generate and yarn db:migrate to resolve issues.
  • Use Case: When a new module isn't appearing in the application's sidebar, this Skill can be used to identify that the module registration is missing and guide the user to add it and regenerate discovery files.

Quick Start

Use the troubleshooter skill to fix the "module not found" error.

Frequently Asked Questions about troubleshooter

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

FAQPage Schema
How do I troubleshoot a module not found error in Open Mercato standalone applications?

To troubleshoot a module not found error in Open Mercato, you must systematically identify the problematic application layer. This involves checking the missing module registration, adding the required configuration, and executing discovery file regeneration commands to resolve the issue.

How do I fix database connectivity and entity migration errors during Open Mercato development?

Fixing database connectivity and entity migration errors in Open Mercato requires running specific diagnostic commands. You can resolve these layer issues by executing `yarn generate` to rebuild entities and `yarn db:migrate` to apply necessary database schema corrections.

What is the best way to resolve API route failures and UI widget malfunctions in Open Mercato apps?

The best way to resolve API route failures and UI widget malfunctions in Open Mercato is through a structured diagnostic flow. This process isolates the specific failing layer, whether API or UI, and suggests targeted corrective actions to restore application functionality.

Does the Open Mercato troubleshooter handle build and type errors alongside extension problems?

Yes, the Open Mercato troubleshooter handles build and type errors alongside extension problems. It systematically diagnoses these specific application layers, identifies the root cause of the compilation or extension failure, and suggests the necessary corrective actions.

Why do my newly added Open Mercato modules fail to appear in the application sidebar?

Newly added Open Mercato modules fail to appear in the sidebar when module registration is missing. You must diagnose this UI layer issue, add the missing module registration, and execute the appropriate commands to regenerate the discovery files.