---
name: gf-summary
description: "Summarize Verilator, lint, or simulation output into a readable, actionable format. Use when the user wants to understand build output, lint errors, or simulation results from a Verilator or EDA tool run."
user-invocable: true
triggers:
  - summarize lint output
  - summarize Verilator output
  - what do these errors mean
  - parse build output
  - summarize simulation results
  - explain these lint warnings
  - make this output readable
  - summarize EDA tool output
---
allowed-tools:
  - Bash
  - Read

# GateFlow Summary Skill

Summarizes Verilator lint and simulation output into a clean, readable report.

## Instructions

When invoked, analyze the most recent Verilator output or run a new lint check and present results as:

### Summary Format

```
## Lint Summary: <filename>

| Status | Count |
|--------|-------|
| Errors | X |
| Warnings | X |
| Clean | Yes/No |

### Issues Found

#### Errors
- **Line X**: <error description> - <fix suggestion>

#### Warnings
- **Line X**: <warning description> - <fix suggestion>

### Recommendations
1. <prioritized fix>
2. <next fix>
```

## Trigger Patterns

Activate when user says:
- "summarize lint"
- "lint summary"
- "what's wrong with"
- "show lint results"

## Example

**Input:** Verilator output with WIDTH and UNUSED warnings

**Output:**
```
## Lint Summary: sync_fifo.sv

| Status | Count |
|--------|-------|
| Errors | 0 |
| Warnings | 2 |
| Clean | No |

### Warnings
- **Line 15**: WIDTH - Signal 'count' width mismatch (8 vs 4 bits)
  - Fix: Change `logic [7:0] count` to `logic [3:0] count`

- **Line 32**: UNUSED - Signal 'debug_flag' is never used
  - Fix: Remove the signal or add `/* verilator lint_off UNUSED */`

### Recommendations
1. Fix WIDTH warning first (affects functionality)
2. Clean up UNUSED signals
```

## Usage

```
/gf-summary                    # Summarize last lint output
/gf-summary sync_fifo.sv       # Run lint and summarize for specific file
```

When given a file path, run:
```bash
verilator --lint-only -Wall <file> 2>&1
```

Then parse and present the summary.