debug

Analyze failed hardware simulation logs to identify root causes.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/xsw632/ChipAgent --skill debug-xsw632
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/xsw632/ChipAgent/tree/main/skills/debug
Command: npx skills add https://github.com/xsw632/ChipAgent --skill debug-xsw632

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When hardware simulation tests fail, manually cross-referencing simulation logs, design specifications, source code, and waveform data to identify root causes is extremely time-consuming and prone to human error.

Core Features & Use Cases

  • Cross-Artifact Failure Analysis: Automatically parses simulation logs, matches failed tests to corresponding hardware spec operations, and maps failures to relevant Chisel source code blocks.
  • Waveform Integration: Extracts signal values from VCD waveform files at failure timestamps to provide concrete evidence of root causes, with fallback to log-only analysis if waveforms are unavailable.
  • Actionable Debug Reports: Generates structured debug reports with root cause analysis and concrete fix suggestions to accelerate hardware verification cycles. For example, if a 4-bit ALU simulation fails an addition test case, this skill automatically identifies mismatched signal values, locates the corresponding Chisel implementation, and suggests potential code fixes.

Quick Start

Use the debug skill to analyze simulation failures for your hardware module.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug failed Verilator simulation tests automatically?

Debugging failed Verilator simulation tests is automated by cross-referencing simulation logs, Chisel source code, and module specifications to identify root causes and generate actionable fix recommendations.

What is the best way to find the root cause of a hardware verification failure in Chisel?

The root cause of a hardware verification failure in Chisel is found by parsing simulation logs, mapping failures to hardware spec operations, and extracting mismatched signal values from VCD waveform files.

Can I analyze VCD waveform files to debug Chisel hardware simulations?

Analyzing VCD waveform files to debug Chisel hardware simulations is supported by extracting signal values at failure timestamps to provide concrete evidence of root causes, with fallback to log-only analysis if waveforms are unavailable.

Do I need module specification files to debug FIRRTL compilation and simulation failures?

Module specification files are required to debug FIRRTL compilation and simulation failures, as the analysis matches failed tests to corresponding hardware spec operations to generate structured debug reports.

Why does my Chisel simulation fail and how do I get fix suggestions?

Your Chisel simulation may fail due to mismatched signal values, and fix suggestions are generated by cross-referencing failed simulation logs with source code to produce structured debug reports with concrete code fixes.

What are the limitations of hardware debugging without VCD waveform files?

The limitation of hardware debugging without VCD waveform files is the inability to extract signal values at failure timestamps, forcing a fallback to log-only analysis and reducing the precision of root cause identification.