rat-init-project

Initialize RTL project workspaces with standardized directories, templates, and EDA scripts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

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.

Frequently Asked Questions about rat-init-project

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

FAQPage Schema
How do I bootstrap an RTL project workspace with standard directories and EDA scripts?

To bootstrap an RTL project workspace, run the initialization skill to create standardized directories, deploy CLAUDE.md rules, install Makefile and filelist templates, and generate EDA runner scripts for downstream design and verification.

What is the best way to set up a consistent FPGA or ASIC project skeleton before coding?

The best way to set up a consistent FPGA or ASIC project skeleton is using an idempotent scaffolding process that creates expected folders like rtl, sim, and syn, while deploying non-destructive coding conventions and EDA-ready scripts.

Does the RTL project initialization overwrite existing user files or configurations?

No, the RTL project initialization applies a non-destructive policy. It idempotently creates missing directories and injects rules or templates without overwriting global configurations or user-modified files.

How does project initialization handle EDA tool detection for simulation and synthesis?

Project initialization handles EDA tool detection by scanning the environment for available tools, generating a rat_config.json file, and providing a final report summarizing created artifacts and any missing tools.

Can I use this scaffolding tool for an existing repository that already has some design files?

Yes, you can use this scaffolding tool for an existing repository. It deploys standard directories, per-directory guides, and runner scripts idempotently, ensuring missing infrastructure is added without disrupting your current design files.

What templates and scripts are installed when setting up a new hardware design project?

When setting up a new hardware design project, the tool installs a Makefile, filelist template, cocotb Makefile, EDA runner scripts, and a tool-runner library to support the 6-Phase pipeline workflows.