rtl-bug-repro

Generate minimal SystemVerilog testbenches and analyze VCD waveforms to isolate RTL failures.

43|9|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/babyworm/rtl-agent-team --skill rtl-bug-repro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rtl-bug-repro
Source: https://github.com/babyworm/rtl-agent-team/tree/main/skills/rtl-bug-repro
Command: npx skills add https://github.com/babyworm/rtl-agent-team --skill rtl-bug-repro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Reproducing RTL failures from large regression suites is slow and noisy; this skill creates focused, minimal testbenches and performs waveform analysis so engineers can quickly find the first failing cycle and the originating signal path.

Core Features & Use Cases

  • Minimal repro generation: scaffold and write a compact SystemVerilog testbench targeted at the failing module using project naming and clock/reset conventions.
  • Waveform comparison and analysis: cycle-by-cycle VCD comparison to identify the first divergence and trace signals to the offending module and context.
  • Verification workflow: runs targeted simulations, confirms reproduction, and produces a root_cause.md documenting failure cycle, hierarchical signal trace, and suspected RTL location; useful for regression failures, reported bug isolation, and pre-fix verification.

Quick Start

Use the rtl-bug-repro skill to create a minimal reproduction testbench from a failing simulation log and generate sim/bugs/{bug_id}/root_cause.md with the failure cycle and signal trace.

Frequently Asked Questions about rtl-bug-repro

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

FAQPage Schema
How do I isolate a bug from a failing RTL simulation waveform?

To isolate a bug from a failing RTL simulation waveform, you generate a minimal SystemVerilog testbench that targets the specific failing module and trace the VCD waveform cycle-by-cycle to pinpoint the first signal divergence.

What is the best way to reproduce a failing regression test in RTL?

The best way to reproduce a failing RTL regression test is to scaffold a compact testbench using project clock and reset conventions, run targeted simulations, and document the failing cycle and hierarchical signal trace in a root cause report.

Do I need VCD files to trace RTL simulation failures?

Yes, you need access to failing VCD or FST waveforms, project RTL sources, and simulator run scripts to perform cycle-by-cycle waveform comparison and trace the originating signal path.

How do I create a minimal testbench for module-level isolation?

You create a minimal testbench for module-level isolation by extracting the failing module context, applying project naming conventions, and executing targeted simulations to confirm the reproduction of the mismatched waveform.

What are the limitations of using minimal RTL reproductions for bug isolation?

A limitation of minimal RTL reproductions is the dependency on accessible failing VCD waveforms and simulator run scripts; without accurate project RTL sources, isolating the root cause of the simulation failure is not possible.