---
name: "vllm-ascend-distributed-debug"
description: "Diagnose vLLM Ascend multi-rank and multi-node startup, rank mapping, process-group, collective, HCCL, Ray, scheduler, connector, and distributed hang failures from structured topology and per-rank evidence. Use when a failure depends on rank count, parallel topology, nodes, collectives, or distributed endpoints. Do not use for graph-only divergence, isolated operator failures, performance benchmarking, or profiler analysis."
---

<!-- Generated from .agents/skills/vllm-ascend-distributed-debug/SKILL.md. Do not edit. -->

# vLLM Ascend Distributed Debug

Read `.agents/skills/vllm-ascend-distributed-debug/SKILL.md` and only the references needed
for the current task. The canonical skill owns the workflow.