r2g-skills

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.

---

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

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 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 from the skill collection directory alone (no full repo clone needed):

cd r2g-skills
./install.sh --user

---

Configure the OpenROAD toolchain

The skill autodetects every tool on first use. No source or export is required if your tools land in standard locations. Use check_env.sh to see exactly what was found (see Verify).

Quick start — let the eda-install skill detect your machine and provision the toolchain:

bash r2g-skills/bootstrap.sh --dry-run     # detect tools + PDK + torch venv → per-tier plan, install nothing

This is a shim to the dedicated eda-install sub-skill (r2g-skills/eda-install/bootstrap.sh) — in a Claude Code session you can just say "set up the EDA tools". It reports what's present vs missing and, without root, automatically selects a no-sudo path (pre-built conda litex-hub binaries + a torch venv on a big volume — never a full $HOME). Drop --dry-run to install the missing tiers and auto-generate references/env.local.sh; add --prefix /big/volume to steer where the PDK and venv land. The manual paths below remain available if you prefer to install by hand.

Choose the path that matches your situation.

---

Path A — Shared EDA server with a pre-built toolchain (fastest)

If /opt/openroad_tools_env.sh exists (e.g. a shared EDA workstation), the skill sources it automatically. Jump straight to Verify.

---

Path B — Build ORFS from source (recommended for a clean Linux install)

OpenROAD-flow-scripts builds its own openroad and yosys, so one clone gives you the whole flow.

1. System packages (run once as root — Debian / Ubuntu):

sudo apt update
sudo apt install build-essential cmake git python3 python3-pip \
     iverilog klayout tcl-dev libboost-dev flex bison

For RHEL / Fedora / CentOS, replace apt with dnf / yum and adjust package names accordingly.

2. Clone and build ORFS (~30 min on 8 cores):

git clone --recursive https://github.com/The-OpenROAD-Project/OpenROAD-flow-scripts \
    ~/OpenROAD-flow-scripts
cd ~/OpenROAD-flow-scripts
sudo ./etc/DependencyInstaller.sh   # installs remaining build deps
./build_openroad.sh --local         # builds openroad + yosys under tools/install/

After the build, the skill autodetects both binaries from $ORFS_ROOT/tools/install/ if you set ORFS_ROOT. Do that in env.local.sh (one line):

cp ~/.claude/skills/signoff-loop/references/env.local.sh.template \
   ~/.claude/skills/signoff-loop/references/env.local.sh

# Add this one line to env.local.sh:
echo 'export ORFS_ROOT="$HOME/OpenROAD-flow-scripts"' \
  >> ~/.claude/skills/signoff-loop/references/env.local.sh

---

Path C — OSS-CAD-Suite + separate OpenROAD binary

OSS-CAD-Suite provides pre-built Yosys, iverilog, and Verilator. Pair it with a pre-built OpenROAD binary (from the OpenROAD releases page or your distro).