Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
rstackjs avatar

Rspack Tracing

  • 188 installs
  • 86 repo stars
  • Updated August 4, 2026
  • rstackjs/agent-skills

Use rspack-tracing for development tasks

About

rspack-tracing: A skill for development. This provides functionality for development workflows.

  • rspack-tracing

Rspack Tracing by the numbers

  • 188 all-time installs (skills.sh)
  • +6 installs in the week ending Jul 26, 2026 (Skillselion tracking)
  • Ranked #2,122 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/rstackjs/agent-skills --skill rspack-tracing

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs188
repo stars86
Last updatedAugust 4, 2026
Repositoryrstackjs/agent-skills

What it does

Use rspack-tracing for development tasks

Files

SKILL.mdMarkdownGitHub ↗

Rspack Tracing & Performance Profiling

When to Use This Skill

Use this skill when you need to:

1. Diagnose why an Rspack build is slow. 2. Understand which plugins or loaders are taking the most time. 3. Analyze a user-provided Rspack trace file. 4. Guide a user to capture a performance profile.

Workflow

1. Capture a Trace

First, ask the user to run their build with tracing enabled.

# Set environment variables for logging to a file
RSPACK_PROFILE=TRACE RSPACK_TRACE_LAYER=logger RSPACK_TRACE_OUTPUT=./trace.json pnpm build

This will generate a trace file in a timestamped directory like .rspack-profile-{timestamp}-{pid}/trace.json.

See references/tracing-guide.md for more details on configuration.

2. Quick Diagnosis for Crashes/Errors

If the user wants to identify which stage a crash or error occurred in, use tail to quickly view the last events without running the full analysis:

# Navigate to the generated profile directory
cd .rspack-profile-*/

# View the last 20 events to see where the build failed
tail -n 20 trace.json

The last events will show the span names and targets where the build stopped, helping to quickly pinpoint the problematic stage, plugin, or loader.

3. Full Performance Analysis

For detailed performance profiling (not just crash diagnosis), ask the user to run the bundled analysis script on the generated trace file.

# Navigate to the generated profile directory
cd .rspack-profile-*/

# Run the analysis script
node ${CLAUDE_PLUGIN_ROOT}/skills/tracing/scripts/analyze_trace.js trace.json

4. Interpret Results

Use the output from the script to identify bottlenecks. Consult references/bottlenecks.md to map span names to actionable fixes.

5. Locate Slow Plugins

Based on the "Top Slowest Hooks" from the analysis script:

1. Identify the Hook: Note the hook name (e.g., hook:CompilationOptimizeChunks). 2. Inspect Configuration: Read rspack.config.js or rsbuild.config.ts. 3. Map Hook to Plugin: Look for plugins and their sources that tap into that specific hook. 4. Output: Output the paths, lines and columns of the suspected plugin source code.

Common Scenarios & Quick Fixes

  • Bottleneck Reference: Mapping spans to concepts.
  • Tracing Guide: Detailed usage of RSPACK_PROFILE.

Related skills

Backend & APIsbackendintegrations

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.