error-troubleshooting

Diagnose Kailash SDK workflow errors and apply documented fixes.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/aliciapls/ML-Week-2---Healthcare --skill error-troubleshooting-aliciapls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-troubleshooting
Source: https://github.com/aliciapls/ML-Week-2---Healthcare/tree/main/.claude/skills/31-error-troubleshooting
Command: npx skills add https://github.com/aliciapls/ML-Week-2---Healthcare --skill error-troubleshooting-aliciapls

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you identify and resolve recurring Kailash SDK workflow failures, turning confusing runtime errors into clear, actionable fixes.

Core Features & Use Cases

  • Nexus and runtime debugging: Resolve hangs, blocking startup, and execution failures in local and async runtimes.
  • Workflow correctness checks: Catch missing build steps, bad connection mappings, parameter validation issues, and cycle convergence problems.
  • DataFlow syntax recovery: Fix template syntax mistakes and replace invalid parameter injection patterns with supported connections.
  • Use case: When a workflow fails in production or during development, use this Skill to map the error message to the right root cause and apply the documented remediation.

Quick Start

Match the error message to the closest troubleshooting guide and follow the recommended fix before rerunning the workflow.

Frequently Asked Questions about error-troubleshooting

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

FAQPage Schema
Why does my Kailash workflow hang on startup when using a Nexus node?

Kailash workflow hangs on startup often occur when a Nexus node blocks runtime execution. Resolve Nexus blocking by validating your runtime selection and verifying that connection parameters are correctly mapped before rerunning.

How do I fix missing .build() call errors in a Kailash SDK workflow?

Fix missing .build() call errors by validating your Kailash SDK workflow build steps. Ensure every workflow definition explicitly calls .build() to properly initialize runtime execution and pass parameter validation checks before running.

What causes cycle convergence issues during Kailash workflow debugging?

Cycle convergence issues during Kailash workflow debugging arise from incorrect connection mapping or invalid parameter injection. Run convergence checks and replace unsupported DataFlow template syntax with supported connections to stabilize the loop.

How do I resolve DataFlow template syntax problems in Kailash?

Resolve DataFlow template syntax problems by matching the error message to documented Kailash patterns. Fix template syntax mistakes and replace invalid parameter injection patterns with supported connections to restore workflow runtime execution.

What's the best way to diagnose Kailash runtime execution failures?

The best way to diagnose Kailash runtime execution failures is to map the error message to the closest troubleshooting guide. Validate workflow build steps, connection mapping, and runtime selection against documented error patterns to isolate the root cause.

Do I need to validate connection parameters before running a Kailash workflow?

You need to validate connection parameters before running a Kailash workflow to prevent parameter validation errors. Checking connection mapping and runtime selection ensures the DataFlow template syntax executes without blocking or convergence failures.