generate-profile

Generate validated SGLang server profiling traces with Chrome-compatible output.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual coordination required to profile an SGLang server run by launching the server, checking its readiness and accuracy, capturing a Chrome-compatible trace, and cleaning up the server process.

Core Features & Use Cases

  • Server orchestration: Launches an SGLang server with a selected model, GPU, port, and tensor-parallel configuration.
  • Validation: Polls for server readiness and runs a quick GSM8K accuracy sanity check before profiling.
  • Trace generation: Captures configurable profiling traces suitable for Perfetto or Chrome tracing, including server configuration metadata.
  • Use Case: Use this Skill to produce a reproducible performance profile for comparing SGLang model-serving configurations or diagnosing latency and throughput issues.

Quick Start

Ask the Skill to profile a Qwen3-8B SGLang server run on the preferred CUDA GPU and return the generated trace directory.

Frequently Asked Questions about generate-profile

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

FAQPage Schema
How do I profile an SGLang server run on CUDA GPUs?

Profile an SGLang server run by launching the server, polling for readiness, validating GSM8K accuracy, capturing a Chrome-compatible trace, and cleaning up server processes for reproducible GPU performance analysis.

Can I use Chrome trace format to diagnose SGLang model serving latency?

Yes, Chrome trace format captures SGLang model serving latency and throughput diagnostics. The profiling process generates Perfetto-compatible traces that include server configuration metadata for detailed performance investigations.

What is needed to generate validated performance traces for multi-GPU SGLang deployments?

Generating validated performance traces for multi-GPU SGLang deployments requires a working SGLang installation, CUDA GPU access, server health checks, an accuracy sanity test, configurable profiling steps, and cleanup of launched server processes.

Does SGLang profiling support tensor-parallel configuration comparisons?

Yes, SGLang profiling supports tensor-parallel configuration comparisons. Server orchestration launches with selected models, GPUs, ports, and tensor-parallel configurations to produce reproducible traces for diagnosing latency and throughput.

Why does my SGLang server profiling require an accuracy sanity check before capturing traces?

An accuracy sanity check using GSM8K runs before trace capture to validate that the SGLang server is fully operational and producing correct outputs, ensuring the collected performance metrics reflect a healthy deployment.

What is the best way to compare SGLang model-serving configurations for performance issues?

The best way to compare SGLang model-serving configurations is generating reproducible performance profiles that capture end-to-end traces across single- and multi-GPU deployments, suitable for diagnosing latency and throughput issues.