ci-workflow-guide

Orchestrate and troubleshoot SGLang CI workflows across staged test pipelines.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/spacecat2002/oscar --skill ci-workflow-guide-spacecat2002
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ci-workflow-guide
Source: https://github.com/spacecat2002/oscar/tree/main/sglang-research/.claude/skills/ci-workflow-guide
Command: npx skills add https://github.com/spacecat2002/oscar --skill ci-workflow-guide-spacecat2002

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers understand, modify, and troubleshoot complex SGLang continuous integration workflows without losing track of stage dependencies, failure propagation, test partitioning, or execution modes.

Core Features & Use Cases

  • Workflow Orchestration: Explains stage ordering, PR gating, concurrency, scheduled runs, and targeted stage reruns.
  • Failure Diagnosis: Covers fast-fail layers, retry classification, stage health checks, timeouts, cancellations, and common CI failure symptoms.
  • Test Distribution: Documents suite registration, matrix partitioning with the LPT heuristic, runner selection, and expected job counts.
  • Use Case: When adding a new GPU test stage, use this Skill to update the workflow job, register the suite, configure partitioning, maintain stage gating counts, and include the final result aggregation.

Quick Start

Use the ci-workflow-guide skill to explain why a SGLang CI stage is timing out and identify the workflow files and matrix counts that need to be checked.

Frequently Asked Questions about ci-workflow-guide

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

FAQPage Schema
How do I debug a failing GitHub Actions job in an SGLang CI workflow?

To debug a failing SGLang CI job, analyze the fast-fail layers, retry classification, and stage health checks to identify failure propagation and timeout symptoms. Check workflow dependencies and whether the failure stems from a specific test suite or runner timeout.

How does LPT-based test partitioning work for GPU testing in SGLang continuous integration?

LPT-based test partitioning in SGLang CI distributes GPU testing loads across matrix runners by registering test suites and applying the LPT heuristic to balance execution times. This determines runner selection and expected job counts for each stage.

What steps are needed to add a new GPU test stage to an SGLang CI workflow?

Adding a GPU test stage requires updating the GitHub Actions workflow job, registering the test suite, configuring matrix partitioning, maintaining wait-for-jobs gating counts, and including final result aggregation to ensure proper stage health checks.

Can I rerun a targeted SGLang CI stage instead of triggering the entire workflow?

Yes, SGLang CI supports targeted stage reruns alongside PR, scheduled, and standard execution modes. You can rerun specific failed jobs while respecting workflow dependencies, concurrency rules, and stage gating requirements.

Why is my SGLang CI stage timing out or being skipped during execution?

SGLang CI stages time out or skip due to misconfigured wait-for-jobs gating, unmet stage dependencies, or exceeded runner limits. Examine the stage health checks, timeout configurations, and workflow concurrency settings to isolate the cause.

Does SGLang CI support scheduled runs and PR gating for workflow orchestration?

SGLang CI orchestrates workflows using GitHub Actions stage ordering, PR gating, concurrency controls, scheduled runs, and targeted stage reruns. These mechanisms ensure test pipelines execute reliably across different execution modes.