troubleshooting

Diagnose Airflow, database, API, and data integrity issues in the nhlstats system.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/MGPowerlytics/nhlstats --skill troubleshooting-mgpowerlytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting
Source: https://github.com/MGPowerlytics/nhlstats/tree/main/.github/skills/troubleshooting
Command: npx skills add https://github.com/MGPowerlytics/nhlstats --skill troubleshooting-mgpowerlytics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnosis and resolution guides for common issues in the nhlstats system, including Airflow failures, database connection errors, API authentication, and data integrity problems.

Core Features & Use Cases

  • Airflow Troubleshooting: Diagnose DAG parsing, scheduling, and task failures.
  • Database & API Debugging: Identify and resolve connection and authentication problems, data freshness issues.
  • Operational Guidance: Provide safe remediation steps and references to docs for repeatable fixes in development, staging, and production.

Quick Start

Use the troubleshooting skill to diagnose and fix the current Airflow DAG, DB connection, or API authentication issue in nhlstats.

Frequently Asked Questions about troubleshooting

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

FAQPage Schema
How do I fix Airflow DAG parsing errors in a data pipeline?

Airflow DAG parsing errors are resolved by diagnosing task failures and scheduling conflicts through structured debugging steps. This approach provides actionable commands to identify root causes and safely remediate issues across development, staging, and production environments without causing destructive impacts.

Why does my PostgreSQL database connection keep failing during pipeline execution?

PostgreSQL database connection failures are diagnosed by checking authentication credentials and network configurations. This troubleshooting process identifies connection problems and provides safe remediation steps to restore database connectivity and ensure data freshness across different environments.

What is the best way to resolve API authentication failures when fetching data?

The best way to resolve API authentication failures is to systematically debug credential configurations and token validation. This method provides structured troubleshooting steps to identify authentication problems and apply non-destructive fixes to restore data fetching operations across different environments.

How do I troubleshoot data freshness issues in staging and production environments?

Troubleshooting data freshness issues in staging and production involves diagnosing pipeline scheduling and database connection delays. This process provides actionable commands to identify stale data sources and apply safe remediation steps to maintain data integrity across environments.

Can I use these debugging steps for non-destructive remediation in production?

Yes, you can use these debugging steps for non-destructive remediation in production. The troubleshooting process provides operational guidance and references to relevant docs to ensure safe, repeatable fixes for Airflow, database, API, and data integrity issues without risking system stability.