lint-tool-profiles

Normalize lint results from Verilator, Verible, slang, and Spyglass into a unified report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unify lint results from multiple RTL tools into a single, comparable report to simplify decision making.

Core Features & Use Cases

  • Standardizes outputs from Verilator, Verible, slang, and Spyglass into common fields: errors, warnings, tool, log_path, and replay_path.
  • Provides a wrapper script (lint/scripts/run_lint.sh) to run each tool with consistent options and thresholds.
  • Applies to RTL/design verification workflows where cross-tool consistency is required for gating on success (errors == 0).

Quick Start

Run a lint pass on your RTL project using lint/scripts/run_lint.sh with the desired tool profile to produce a unified report.

Frequently Asked Questions about lint-tool-profiles

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

FAQPage Schema
How do I unify lint results from Verilator, slang, and Spyglass into a single report?

You can unify lint results by running the provided wrapper script on your RTL project, which normalizes outputs from Verilator, Verible, slang, and Spyglass into common fields like errors, warnings, and log_path. This produces a single comparable report for consistent cross-tool analysis.

What is the best way to standardize RTL lint outputs for CI gating?

Standardizing RTL lint outputs for CI gating involves normalizing cross-tool results into common fields and checking that the normalized error count equals zero. This Skill defines wrapper scripts and output schemas to ensure consistent gating across Verilator, Verible, slang, and Spyglass.

Can I use this lint normalization wrapper with a standard Verilog filelist?

Yes, the lint wrapper is designed to ensure compatibility with a standard top file like rtl/filelist_top.f. This allows you to run Verilator, slang, or Spyglass lint passes consistently using your existing RTL design filelist.

Does the unified lint report include replay paths and log files?

The unified lint report explicitly includes log_path and replay_path fields alongside normalized errors and warnings. These fields ensure you can trace and reproduce issues directly from the standardized cross-tool lint output.

How do I run a lint pass on my RTL project using a specific tool profile?

You run a lint pass by executing the lint/scripts/run_lint.sh script with your desired tool profile. This applies consistent options and thresholds to generate a unified report from your chosen RTL linting tool.