workflow_errors

Diagnose and fix CatGo workflow engine errors like HPC failures and missing POTCARs.

181|20|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Hello-QM/catgo-LRG --skill workflow-errors
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow_errors
Source: https://github.com/Hello-QM/catgo-LRG/tree/main/.claude/skills/troubleshoot-workflow
Command: npx skills add https://github.com/Hello-QM/catgo-LRG --skill workflow-errors

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes CatGo workflow engine errors that hinder HPC connectivity, job submission, or task-state progression, including REMOTE_ERROR, missing POTCARs, and stuck tasks.

Core Features & Use Cases

  • Diagnostic checks for HPC connectivity and CatGo engine health.
  • Error-reference mapping for common failure modes (No HPC connection, POTCARNotFound, REMOTE_ERROR).
  • Practical remediation steps for HPC credential validation, POTCAR verification, and task/reset workflows.
  • Use cases covering READY/SUBMITTED/RUNNING/REMOTE_ERROR states and submission/polling failures.

Quick Start

Diagnose a failing CatGo workflow by following the troubleshooting steps to identify the root cause and apply remedies.

Frequently Asked Questions about workflow_errors

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

FAQPage Schema
How do I fix a REMOTE_ERROR state in a CatGo workflow engine task?

To fix a REMOTE_ERROR state in a CatGo workflow, you must run diagnostic checks on HPC connectivity, validate your HPC credentials, and apply task reset workflows to clear the error.

Why does my HPC job submission fail when using CatGo?

Your HPC job submission fails due to HPC connectivity problems or invalid credentials. Use diagnostic checks to verify HPC connection health and validate your submission environment before retrying.

What is the best way to troubleshoot a stuck RUNNING task in CatGo?

The best way to troubleshoot a stuck RUNNING task is to check the CatGo engine health and polling mechanisms. Identify workflow polling failures and apply step-by-step diagnostics to resume task progression.

How do I resolve missing POTCAR or pseudopotential errors in CatGo?

To resolve missing POTCAR or pseudopotential errors, follow the error-reference mapping to verify your POTCAR paths. Ensure all required pseudopotential files are correctly configured in the backend.

Can I diagnose HPC connection failures directly from the CatGo frontend?

Yes, you can diagnose HPC connection failures from the CatGo frontend. The workflow engine provides practical remediation steps and health checks to identify and resolve HPC connectivity problems directly.

What should I do when a CatGo task remains in the READY state and never submits?

When a CatGo task remains in the READY state, you should check for workflow submission failures. Diagnose engine health and HPC connectivity to ensure the job submission process can initialize properly.