generate-profile

Generate end-to-end performance profiling traces for SGLang server runs.

556|81|Updated May 19, 2026
One-click install
npx skills add https://github.com/FutureMLS-Lab/OSCAR --skill generate-profile-futuremls-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-profile
Source: https://github.com/FutureMLS-Lab/OSCAR/tree/main/sglang-research/.claude/skills/generate-profile
Command: npx skills add https://github.com/FutureMLS-Lab/OSCAR --skill generate-profile-futuremls-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies end-to-end performance profiling for SGLang servers by coordinating server startup, readiness checks, accuracy validation, trace collection, cleanup, and profile reporting.

Core Features & Use Cases

  • Server Orchestration: Launch an SGLang server with configurable models, ports, GPUs, and tensor parallelism.
  • Validation and Profiling: Check server readiness, run a quick GSM8K accuracy sanity test, and capture Chrome-compatible performance traces.
  • Flexible Analysis: Configure profiling steps, profile prefill and decode stages separately, and use custom output paths for investigating latency, throughput, or GPU performance issues.
  • Use Case: Profile a Qwen3-8B deployment to identify serving bottlenecks and inspect the resulting trace in Perfetto or Chrome tracing.

Quick Start

Use the generate-profile skill to launch an SGLang server for the specified model, validate its accuracy, capture an end-to-end trace, clean up the server, and report the generated profile path.

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 to investigate GPU inference latency?

To profile an SGLang server for GPU inference latency, you need to generate an end-to-end performance tracing trace. This process launches the server, runs readiness checks, executes a GSM8K sanity test, and captures the profile output.

What is the best way to capture prefill and decode performance traces separately for SGLang?

Capturing prefill and decode performance traces separately for SGLang involves configuring specific profiling steps during server validation. The trace generation isolates these stages to help investigate latency and throughput bottlenecks in GPU-backed deployments.

Do I need a CUDA GPU and a working SGLang installation to run performance benchmarking?

Yes, you need a working SGLang installation and an available CUDA GPU to run performance benchmarking and trace generation. These are required to validate server health, execute the GSM8K sanity test, and produce Chrome-compatible trace output.

Does SGLang profiling output work with Perfetto or Chrome tracing for analysis?

Yes, SGLang profiling output is Chrome-compatible and works directly with Perfetto or Chrome tracing. The generated trace file allows you to inspect prefill and decode stages to identify serving bottlenecks in your GPU deployment.

Why does my SGLang server profiling require a GSM8K accuracy sanity test?

SGLang server profiling requires a GSM8K accuracy sanity test to validate that the deployment is functioning correctly before capturing traces. This ensures the performance trace reflects accurate model serving behavior rather than startup errors.

Can I configure tensor parallelism and custom output paths when profiling SGLang runs?

Yes, you can configure tensor parallelism, GPUs, ports, and custom output paths when profiling SGLang runs. Server orchestration supports flexible analysis by allowing you to specify model configurations and direct the trace output to investigate specific performance issues.