# phamcuong21478/rtl-skills architecture

> Architecture diagram of the GitHub repository phamcuong21478/rtl-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/phamcuong21478/rtl-skills
- Repository: https://github.com/phamcuong21478/rtl-skills

## Overview

rtl-skills is a Claude Code toolkit for taking an RTL requirement through architecture, design, implementation, verification, synthesis, debugging, and documentation. Users can invoke skills individually or use vflow and the rtl-orchestrator agent to coordinate the flow. The graph follows the documented workflow and agent bundles; source excerpts were not available, so relationships are based on README statements only.

Main entry points: [`skills/vflow/SKILL.md`](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vflow/SKILL.md) (Orchestrate flow), [`skills/vfill/SKILL.md`](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vfill/SKILL.md) (Implement RTL), [`skills/vdesign/SKILL.md`](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vdesign/SKILL.md) (Design module), [`skills/vexplain/SKILL.md`](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vexplain/SKILL.md) (Explain RTL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Design skills"]
  node_varch["Architect IP<br/>[SKILL.md]"]
  node_vdesign["Design module<br/>[SKILL.md]"]
  node_vfill["Implement RTL<br/>[SKILL.md]"]
  node_vexplain["Explain RTL<br/>[SKILL.md]"]
end

subgraph group_verify["Verification skills"]
  node_vtestgen["Generate tests<br/>[SKILL.md]"]
  node_vtestrun["Run tests<br/>[SKILL.md]"]
  node_vdebug["Diagnose failures<br/>[SKILL.md]"]
  node_vsynth["Synthesize RTL<br/>[SKILL.md]"]
end

subgraph group_integration["Flow and documentation"]
  node_vflow["Orchestrate flow<br/>[SKILL.md]"]
  node_vdoc["Document IP<br/>[SKILL.md]"]
end

subgraph group_agents["Agent roles"]
  node_rtl_architect["RTL architect<br/>[rtl-architect.yaml]"]
  node_rtl_designer["RTL designer<br/>[rtl-designer.yaml]"]
  node_rtl_coder["RTL coder<br/>[rtl-coder.yaml]"]
  node_rtl_documentation["RTL documentation"]
  node_rtl_synthesizer["RTL synthesizer"]
  node_rtl_tester["RTL tester<br/>[rtl-tester.yaml]"]
  node_rtl_debugger["RTL debugger<br/>[rtl-debugger.yaml]"]
  node_rtl_orchestrator["RTL orchestrator"]
end

subgraph group_contracts["Shared conventions"]
  node_shared_contracts["Shared contracts"]
end

node_user(("RTL engineer"))

node_user -->|"invokes"| node_varch
node_user -->|"invokes"| node_vdesign
node_user -->|"invokes"| node_vfill
node_user -->|"invokes"| node_vflow
node_varch -->|"decomposes for"| node_vdesign
node_vdesign -->|"provides backbone"| node_vfill
node_vfill -->|"precedes"| node_vtestgen
node_vtestgen -->|"generates bench for"| node_vtestrun
node_vtestrun -->|"reports failures to"| node_vdebug
node_vdebug -->|"returns diagnosis to"| node_vfill
node_vfill -->|"precedes"| node_vsynth
node_vdesign -->|"produces RTL for"| node_vexplain
node_vexplain -->|"documents modules for"| node_vdoc
node_vflow -->|"orchestrates"| node_varch
node_vflow -->|"orchestrates"| node_vdesign
node_vflow -->|"orchestrates"| node_vfill
node_vflow -->|"orchestrates"| node_vtestgen
node_vflow -->|"orchestrates"| node_vtestrun
node_vflow -->|"orchestrates"| node_vdebug
node_vflow -->|"orchestrates"| node_vsynth
node_vflow -->|"orchestrates"| node_vdoc
node_rtl_architect -->|"bundles"| node_varch
node_rtl_architect -->|"bundles"| node_vexplain
node_rtl_designer -->|"bundles"| node_vdesign
node_rtl_coder -->|"bundles"| node_vfill
node_rtl_documentation -->|"bundles"| node_vdoc
node_rtl_documentation -->|"bundles"| node_vexplain
node_rtl_synthesizer -->|"bundles"| node_vsynth
node_rtl_tester -->|"bundles"| node_vtestgen
node_rtl_tester -->|"bundles"| node_vtestrun
node_rtl_debugger -->|"bundles"| node_vdebug
node_rtl_debugger -->|"bundles"| node_vexplain
node_rtl_orchestrator -->|"drives"| node_vflow

click node_varch "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/varch/SKILL.md"
click node_vdesign "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vdesign/SKILL.md"
click node_vfill "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vfill/SKILL.md"
click node_vexplain "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vexplain/SKILL.md"
click node_vtestgen "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vtestgen/SKILL.md"
click node_vtestrun "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vtestrun/SKILL.md"
click node_vdebug "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vdebug/SKILL.md"
click node_vsynth "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vsynth/SKILL.md"
click node_vflow "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vflow/SKILL.md"
click node_vdoc "https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vdoc/SKILL.md"
click node_rtl_architect "https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-architect.yaml"
click node_rtl_designer "https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-designer.yaml"
click node_rtl_coder "https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-coder.yaml"
click node_rtl_documentation "https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-documentation.yaml"
click node_rtl_synthesizer "https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-synthesizer.yaml"
click node_rtl_tester "https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-tester.yaml"
click node_rtl_debugger "https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-debugger.yaml"
click node_rtl_orchestrator "https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-orchestrator.yaml"
click node_shared_contracts "https://github.com/phamcuong21478/rtl-skills/tree/main/skills/shared"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_varch,node_vdesign,node_vfill,node_vexplain toneBlue
class node_vtestgen,node_vtestrun,node_vdebug,node_vsynth toneAmber
class node_vflow,node_vdoc toneMint
class node_rtl_architect,node_rtl_designer,node_rtl_coder,node_rtl_documentation,node_rtl_synthesizer,node_rtl_tester,node_rtl_debugger,node_rtl_orchestrator toneRose
class node_shared_contracts,node_user toneIndigo
```

## Components

### Design skills

- [Architect IP](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/varch/SKILL.md): `skills/varch/SKILL.md`
- [Design module](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vdesign/SKILL.md): `skills/vdesign/SKILL.md`
- [Implement RTL](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vfill/SKILL.md): `skills/vfill/SKILL.md`
- [Explain RTL](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vexplain/SKILL.md): `skills/vexplain/SKILL.md`

### Verification skills

- [Generate tests](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vtestgen/SKILL.md): `skills/vtestgen/SKILL.md`
- [Run tests](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vtestrun/SKILL.md): `skills/vtestrun/SKILL.md`
- [Diagnose failures](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vdebug/SKILL.md): `skills/vdebug/SKILL.md`
- [Synthesize RTL](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vsynth/SKILL.md): `skills/vsynth/SKILL.md`

### Flow and documentation

- [Orchestrate flow](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vflow/SKILL.md): `skills/vflow/SKILL.md`
- [Document IP](https://github.com/phamcuong21478/rtl-skills/blob/main/skills/vdoc/SKILL.md): `skills/vdoc/SKILL.md`

### Agent roles

- [RTL architect](https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-architect.yaml): `agents/rtl-architect.yaml`
- [RTL designer](https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-designer.yaml): `agents/rtl-designer.yaml`
- [RTL coder](https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-coder.yaml): `agents/rtl-coder.yaml`
- [RTL documentation](https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-documentation.yaml): `agents/rtl-documentation.yaml`
- [RTL synthesizer](https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-synthesizer.yaml): `agents/rtl-synthesizer.yaml`
- [RTL tester](https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-tester.yaml): `agents/rtl-tester.yaml`
- [RTL debugger](https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-debugger.yaml): `agents/rtl-debugger.yaml`
- [RTL orchestrator](https://github.com/phamcuong21478/rtl-skills/blob/main/agents/rtl-orchestrator.yaml): `agents/rtl-orchestrator.yaml`

### Shared conventions

- [Shared contracts](https://github.com/phamcuong21478/rtl-skills/tree/main/skills/shared): `skills/shared`

### Other components

- **RTL engineer**

## Connections

- RTL engineer → Architect IP: invokes (evidence: `README.md`)
- RTL engineer → Design module: invokes (evidence: `README.md`)
- RTL engineer → Implement RTL: invokes (evidence: `README.md`)
- RTL engineer → Orchestrate flow: invokes (evidence: `README.md`)
- Architect IP → Design module: decomposes for (evidence: `README.md`)
- Design module → Implement RTL: provides backbone (evidence: `README.md`)
- Implement RTL → Generate tests: precedes (evidence: `README.md`)
- Generate tests → Run tests: generates bench for (evidence: `README.md`)
- Run tests → Diagnose failures: reports failures to (evidence: `README.md`)
- Diagnose failures → Implement RTL: returns diagnosis to (evidence: `README.md`)
- Implement RTL → Synthesize RTL: precedes (evidence: `README.md`)
- Design module → Explain RTL: produces RTL for (evidence: `README.md`)
- Explain RTL → Document IP: documents modules for (evidence: `README.md`)
- Orchestrate flow → Architect IP: orchestrates (evidence: `README.md`)
- Orchestrate flow → Design module: orchestrates (evidence: `README.md`)
- Orchestrate flow → Implement RTL: orchestrates (evidence: `README.md`)
- Orchestrate flow → Generate tests: orchestrates (evidence: `README.md`)
- Orchestrate flow → Run tests: orchestrates (evidence: `README.md`)
- Orchestrate flow → Diagnose failures: orchestrates (evidence: `README.md`)
- Orchestrate flow → Synthesize RTL: orchestrates (evidence: `README.md`)
- Orchestrate flow → Document IP: orchestrates (evidence: `README.md`)
- RTL architect → Architect IP: bundles (evidence: `README.md`)
- RTL architect → Explain RTL: bundles (evidence: `README.md`)
- RTL designer → Design module: bundles (evidence: `README.md`)
- RTL coder → Implement RTL: bundles (evidence: `README.md`)
- RTL documentation → Document IP: bundles (evidence: `README.md`)
- RTL documentation → Explain RTL: bundles (evidence: `README.md`)
- RTL synthesizer → Synthesize RTL: bundles (evidence: `README.md`)
- RTL tester → Generate tests: bundles (evidence: `README.md`)
- RTL tester → Run tests: bundles (evidence: `README.md`)
- RTL debugger → Diagnose failures: bundles (evidence: `README.md`)
- RTL debugger → Explain RTL: bundles (evidence: `README.md`)
- RTL orchestrator → Orchestrate flow: drives (evidence: `README.md`)
