# agent-r2g

A Claude Code skill that drives an open-source RTL-to-GDS flow — from natural-language spec (or existing RTL) through synthesis, place-and-route, and full signoff (DRC, LVS, RCX) — using Yosys, OpenROAD-flow-scripts, KLayout, and OpenRCX.

Install the `r2g-skills` skills (`eda-install` to set up the toolchain, `rtl-acquire` to grow an RTL corpus at scale, `signoff-loop` for RTL→GDS + signoff, `def-graph` for graph datasets), then ask Claude: *"set up the EDA tools"* followed by *"synthesize this UART at 100 MHz on nangate45"* — it handles everything from provisioning to GDSII. Recent changes: see [CHANGELOG.md](CHANGELOG.md).

---

## Prerequisites

| Tool | Required | Purpose | |------|----------|---------| | Python 3.10+ | yes | skill scripts | | Yosys | yes | synthesis | | iverilog / vvp | yes | simulation | | OpenROAD + ORFS | yes | place & route, RCX | | Verilator | optional | faster lint | | KLayout | optional | GDS viewer, DRC, LVS | | Magic + Netgen | optional | sky130 DRC / LVS | | OpenSTA | optional | standalone STA | | sky130A PDK | optional | sky130 signoff | | torch + torch_geometric + pandas | optional | PyG graph datasets (`run_graphs.sh`; venv on /proj, `R2G_GRAPH_PYTHON`) |

---

## Install the skill

```bash git clone https://github.com/ShenShan123/agent-r2g.git cd agent-r2g bash r2g-skills/install.sh --user # installs eda-install + rtl-acquire + signoff-loop + def-graph into ~/.claude/skills/ ```

Restart Claude Code (or run `/reload`) after install.

**Other options:**

```bash bash r2g-skills/install.sh --user # global — available in every Claude Code session (default) bash r2g-skills/install.sh --project . # local — scoped to the current project directory bash r2g-skills/install.sh --link --user # symlink — edits are picked up without reinstalling bash r2g-skills/install.sh --force --user # overwrite an existing install bash r2g-skills/install.sh --uninstall # remove all sub-skills ```

**Installing