What problem does it solve?
New RTL projects often lack a consistent directory layout, coding rules, build scripts, and EDA configuration, which causes automation agents and toolchains to fail or behave inconsistently. This skill prepares a project workspace with the expected 6-Phase pipeline structure, enforces non-destructive idempotent setup, and prevents missing-file and rule-deployment errors that block downstream design and verification work.
Core Features & Use Cases
- Directory scaffolding: Creates standard folders (rtl, sim, syn, lint, docs, reviews, .rat/state, etc.) only when missing.
- Rule and guide deployment: Installs
.claude/rules and per-directory CLAUDE.md guides without overwriting global or user-modified files.
- Template & script installation: Idempotently copies Makefile, filelist template, cocotb Makefile, EDA runner scripts and a tool-runner library.
- Project config and CLAUDE injection: Generates rat_config.json by detecting available EDA tools and injects or updates a RAT-managed section in CLAUDE.md.
- Safety and reporting: Non-destructive policy, quick EDA tool status checks, and a final project initialization report summarizing created artifacts and missing tools.
- Use case: Initialize an empty repository for FPGA or ASIC development so agents can run Phase 1–6 workflows without manual setup.
Quick Start
Run the rat-init-project skill to initialize the current directory with the standard RTL project layout, deploy rules and guides, install templates and scripts, and generate the project configuration.