hdl-minimal-repair

Generate minimal HDL patches for localized RTL design bugs with structured verification.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/AgainstWar/HDL-Repair-Skills --skill hdl-minimal-repair
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hdl-minimal-repair
Source: https://github.com/AgainstWar/HDL-Repair-Skills/tree/main/hdl-minimal-repair
Command: npx skills add https://github.com/AgainstWar/HDL-Repair-Skills --skill hdl-minimal-repair

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers avoid risky HDL bug fixes by enforcing a hypothesis-driven repair workflow that produces minimal patches and validates hardware side effects before completion.

Core Features & Use Cases

  • Minimal Patch Planning: Converts a localized root-cause hypothesis, repair intent, or existing diff into the smallest necessary HDL source changes.
  • Hardware Consistency Checks: Reviews ready/valid handshakes, reset and flush behavior, FSM transitions, stale state risks, pipeline ordering, and related design contracts.
  • Use Case: Apply this Skill after fault localization identifies a FIFO, AXI pipeline, or FSM issue to implement a controlled repair, verify tests, and document the patch decision.

Quick Start

Use the hdl-minimal-repair skill to apply this localized HDL fix, check hardware side effects, and produce a Patch Decision Note.

Frequently Asked Questions about hdl-minimal-repair

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

FAQPage Schema
How do I create minimal HDL patches for fixing localized RTL design bugs?

To create minimal HDL patches, apply a hypothesis-driven repair workflow that converts localized root-cause hypotheses into the smallest necessary HDL source changes while validating hardware side effects like ready/valid handshakes and pipeline ordering.

What is the best way to verify FSM defect repairs and pipeline failures in RTL?

The best way to verify FSM defect repairs and pipeline failures is by performing hardware consistency checks that review FSM transitions, reset and flush behavior, and stale state risks, followed by structured patch validation and documented test outcomes.

Can I use a hypothesis-based repair workflow for FIFO issues in hardware verification?

Yes, you can use hypothesis-based repair planning for FIFO issues by applying a controlled repair workflow that checks hardware contracts, validates artifact consistency, and produces a Patch Decision Note documenting the fix.

How do I check hardware side effects after applying an RTL bug fix?

To check hardware side effects after an RTL bug fix, review ready/valid handshakes, reset and flush behavior, pipeline ordering, and related design contracts to ensure the minimal patch does not introduce stale state risks or break FSM transitions.

Why does my minimal HDL patch still fail AXI pipeline and FIFO consistency checks?

A minimal HDL patch may fail AXI pipeline and FIFO consistency checks if it violates hardware contracts such as ready/valid handshakes, introduces stale state risks, or disrupts pipeline ordering, requiring hypothesis-based repair planning and artifact consistency validation.