readable-verilog-generator
VerifiedUse when creating, writing, reviewing, annotating, repairing, refactoring, or validating readable Verilog RTL, including synthesizable Verilog-2001 .v files, existing-RTL analysis, semantic comment annotation, testbench scaffold planning, ASIC-quality review, local or remote Vivado/xsim validation, evidence-backed repair, and workflow trace diagnosis.
assets/ideal_bad_style_metrics.json
View on GitHub{
"meta": {
"version": 1,
"note": "Corpus traits are advisory; generated delivery RTL is enforced by scripts/python/quality/quality_gate.py and scripts/python/quality/formatter_ast.py."
},
"ideal": {
"file_count": 57,
"summary": {
"lines": {
"avg": 650.1929824561404,
"median": 425.0,
"min": 90.0,
"max": 4042.0
},
"code_lines": {
"avg": 429.4561403508772,
"median": 289.0,
"min": 58.0,
"max": 2833.0
},
"comment_lines": {
"avg": 352.43859649122805,
"median": 188.0,
"min": 25.0,
"max": 2702.0
},
"comment_density": {
"avg": 0.761277774046912,
"median": 0.6730769230769231,
"min": 0.3867069486404834,
"max": 1.3722222222222222
},
"tab_indented_lines": {
"avg": 616.0526315789474,
"median": 414.0,
"min": 80.0,
"max": 3907.0
},
"space_indented_lines": {
"avg": 3.3684210526315788,
"median": 0.0,
"min": 0.0,
"max": 130.0
},
"block_comment_markers": {
"avg": 0.03508771929824561,
"median": 0.0,
"min": 0.0,
"max": 2.0
},
"ports": {
"avg": 66.80701754385964,
"median": 29.0,
"min": 5.0,
"max": 1080.0
},
"prefixed_ports": {
"avg": 66.80701754385964,
"median": 29.0,
"min": 5.0,
"max": 1080.0
},
"parameters": {
"avg": 7.807017543859649,
"median": 2.0,
"min": 0.0,
"max": 116.0
},
"c_parameters": {
"avg": 5.824561403508772,
"median": 2.0,
"min": 0.0,
"max": 36.0
},
"region_banners": {
"avg": 8.719298245614034,
"median": 6.0,
"min": 0.0,
"max": 94.0
},
"has_bilingual_header": {
"avg": 0.17543859649122806,
"median": 0.0,
"min": 0.0,
"max": 1.0
},
"placeholder_comment_hits": {
"avg": 0.0,
"median": 0.0,
"min": 0.0,
"max": 0.0
},
"always_blocks": {
"avg": 16.614035087719298,
"median": 13.0,
"min": 0.0,
"max": 152.0
},
"assigns": {
"avg": 35.1578947368421,
"median": 25.0,
"min": 0.0,
"max": 241.0
}
},
"encodings": {
"utf-8": 52,
"gb18030": 5
},
"sample_low_style": [
{
"path": "Core_CMD_Ctrl_Interface.v",
"encoding": "utf-8",
"lines": 454,
"code_lines": 331,
"comment_lines": 128,
"comment_density": 0.3867069486404834,
"tab_indented_lines": 440,
"space_indented_lines": 3,
"block_comment_markers": 0,
"ports": 17,
"prefixed_ports": 17,
"parameters": 0,
"c_parameters": 0,
"region_banners": 6,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 30,
"assigns": 24,
"style_signal": 2.3800990191250646
},
{
"path": "Core_HBM_Ctrl_Interface.v",
"encoding": "utf-8",
"lines": 396,
"code_lines": 285,
"comment_lines": 117,
"comment_density": 0.4105263157894737,
"tab_indented_lines": 383,
"space_indented_lines": 3,
"block_comment_markers": 0,
"ports": 20,
"prefixed_ports": 20,
"parameters": 0,
"c_parameters": 0,
"region_banners": 6,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 29,
"assigns": 14,
"style_signal": 2.402950558213716
},
{
"path": "Core_Rst_Ctrl_Interface.v",
"encoding": "utf-8",
"lines": 257,
"code_lines": 182,
"comment_lines": 76,
"comment_density": 0.4175824175824176,
"tab_indented_lines": 244,
"space_indented_lines": 3,
"block_comment_markers": 0,
"ports": 12,
"prefixed_ports": 12,
"parameters": 0,
"c_parameters": 0,
"region_banners": 6,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 15,
"assigns": 8,
"style_signal": 2.405909265831445
},
{
"path": "CMD_DPKG_Interface.v",
"encoding": "utf-8",
"lines": 281,
"code_lines": 193,
"comment_lines": 93,
"comment_density": 0.48186528497409326,
"tab_indented_lines": 271,
"space_indented_lines": 0,
"block_comment_markers": 0,
"ports": 16,
"prefixed_ports": 16,
"parameters": 0,
"c_parameters": 0,
"region_banners": 4,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 0,
"assigns": 75,
"style_signal": 2.481865284974093
},
{
"path": "Task_Time_Interface.v",
"encoding": "utf-8",
"lines": 198,
"code_lines": 134,
"comment_lines": 65,
"comment_density": 0.48507462686567165,
"tab_indented_lines": 189,
"space_indented_lines": 0,
"block_comment_markers": 0,
"ports": 8,
"prefixed_ports": 8,
"parameters": 0,
"c_parameters": 0,
"region_banners": 9,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 11,
"assigns": 12,
"style_signal": 2.4850746268656714
},
{
"path": "Core_Ping_Ctrl_Interface.v",
"encoding": "utf-8",
"lines": 180,
"code_lines": 121,
"comment_lines": 64,
"comment_density": 0.5289256198347108,
"tab_indented_lines": 165,
"space_indented_lines": 3,
"block_comment_markers": 0,
"ports": 13,
"prefixed_ports": 13,
"parameters": 0,
"c_parameters": 0,
"region_banners": 6,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 9,
"assigns": 7,
"style_signal": 2.512258953168044
},
{
"path": "Core_Ptp_Ctrl_Interface.v",
"encoding": "utf-8",
"lines": 139,
"code_lines": 88,
"comment_lines": 52,
"comment_density": 0.5909090909090909,
"tab_indented_lines": 123,
"space_indented_lines": 3,
"block_comment_markers": 0,
"ports": 12,
"prefixed_ports": 12,
"parameters": 0,
"c_parameters": 0,
"region_banners": 6,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 6,
"assigns": 7,
"style_signal": 2.5693263570961413
},
{
"path": "App_HBM_Send_Ctrl_Interface.v",
"encoding": "utf-8",
"lines": 775,
"code_lines": 558,
"comment_lines": 335,
"comment_density": 0.600358422939068,
"tab_indented_lines": 765,
"space_indented_lines": 0,
"block_comment_markers": 0,
"ports": 45,
"prefixed_ports": 45,
"parameters": 0,
"c_parameters": 0,
"region_banners": 14,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 37,
"assigns": 63,
"style_signal": 2.600358422939068
},
{
"path": "Task_Ctrl_PTP_Send_Interface.v",
"encoding": "utf-8",
"lines": 376,
"code_lines": 256,
"comment_lines": 161,
"comment_density": 0.62890625,
"tab_indented_lines": 367,
"space_indented_lines": 0,
"block_comment_markers": 0,
"ports": 25,
"prefixed_ports": 25,
"parameters": 0,
"c_parameters": 0,
"region_banners": 10,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 16,
"assigns": 29,
"style_signal": 2.62890625
},
{
"path": "CMD_PKG_Interface.v",
"encoding": "utf-8",
"lines": 179,
"code_lines": 123,
"comment_lines": 78,
"comment_density": 0.6341463414634146,
"tab_indented_lines": 169,
"space_indented_lines": 0,
"block_comment_markers": 0,
"ports": 16,
"prefixed_ports": 16,
"parameters": 0,
"c_parameters": 0,
"region_banners": 4,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 0,
"assigns": 34,
"style_signal": 2.6341463414634148
}
]
},
"bad": {
"file_count": 137,
"summary": {
"lines": {
"avg": 110.33576642335767,
"median": 28.0,
"min": 1.0,
"max": 1519.0
},
"code_lines": {
"avg": 81.45255474452554,
"median": 25.0,
"min": 0.0,
"max": 1092.0
},
"comment_lines": {
"avg": 31.83211678832117,
"median": 0.0,
"min": 0.0,
"max": 801.0
},
"comment_density": {
"avg": 0.18374918636149012,
"median": 0.0,
"min": 0.0,
"max": 1.1923076923076923
},
"tab_indented_lines": {
"avg": 52.97810218978102,
"median": 0.0,
"min": 0.0,
"max": 1401.0
},
"space_indented_lines": {
"avg": 22.875912408759124,
"median": 0.0,
"min": 0.0,
"max": 264.0
},
"block_comment_markers": {
"avg": 0.26277372262773724,
"median": 0.0,
"min": 0.0,
"max": 16.0
},
"ports": {
"avg": 8.72992700729927,
"median": 6.0,
"min": 0.0,
"max": 87.0
},
"prefixed_ports": {
"avg": 2.167883211678832,
"median": 0.0,
"min": 0.0,
"max": 85.0
},
"parameters": {
"avg": 1.905109489051095,
"median": 0.0,
"min": 0.0,
"max": 19.0
},
"c_parameters": {
"avg": 0.24087591240875914,
"median": 0.0,
"min": 0.0,
"max": 11.0
},
"region_banners": {
"avg": 0.45985401459854014,
"median": 0.0,
"min": 0.0,
"max": 15.0
},
"has_bilingual_header": {
"avg": 0.043795620437956206,
"median": 0.0,
"min": 0.0,
"max": 1.0
},
"placeholder_comment_hits": {
"avg": 0.0072992700729927005,
"median": 0.0,
"min": 0.0,
"max": 1.0
},
"always_blocks": {
"avg": 3.3649635036496353,
"median": 1.0,
"min": 0.0,
"max": 48.0
},
"assigns": {
"avg": 4.905109489051095,
"median": 2.0,
"min": 0.0,
"max": 128.0
}
},
"encodings": {
"utf-8": 134,
"gb18030": 3
},
"sample_low_style": [
{
"path": "stress\\protocol_grouping\\spi_mon.v",
"encoding": "utf-8",
"lines": 186,
"code_lines": 160,
"comment_lines": 21,
"comment_density": 0.13125,
"tab_indented_lines": 0,
"space_indented_lines": 162,
"block_comment_markers": 2,
"ports": 16,
"prefixed_ports": 0,
"parameters": 3,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 4,
"assigns": 4,
"style_signal": -1.239717741935484
},
{
"path": "stress\\datapath_compute\\multiplier.v",
"encoding": "utf-8",
"lines": 276,
"code_lines": 236,
"comment_lines": 13,
"comment_density": 0.05508474576271186,
"tab_indented_lines": 0,
"space_indented_lines": 244,
"block_comment_markers": 0,
"ports": 11,
"prefixed_ports": 0,
"parameters": 1,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 1,
"assigns": 4,
"style_signal": -0.828973225251781
},
{
"path": "stress\\protocol_grouping\\simpleuart.v",
"encoding": "utf-8",
"lines": 139,
"code_lines": 127,
"comment_lines": 1,
"comment_density": 0.007874015748031496,
"tab_indented_lines": 92,
"space_indented_lines": 0,
"block_comment_markers": 4,
"ports": 11,
"prefixed_ports": 0,
"parameters": 0,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 2,
"assigns": 4,
"style_signal": -0.7421259842519685
},
{
"path": "stress\\legacy_large_designs\\PE_array.v",
"encoding": "utf-8",
"lines": 129,
"code_lines": 116,
"comment_lines": 1,
"comment_density": 0.008620689655172414,
"tab_indented_lines": 0,
"space_indented_lines": 88,
"block_comment_markers": 0,
"ports": 6,
"prefixed_ports": 0,
"parameters": 4,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 4,
"assigns": 7,
"style_signal": -0.6735498529804865
},
{
"path": "stress\\legacy_large_designs\\PE.v",
"encoding": "utf-8",
"lines": 35,
"code_lines": 33,
"comment_lines": 0,
"comment_density": 0.0,
"tab_indented_lines": 0,
"space_indented_lines": 23,
"block_comment_markers": 0,
"ports": 8,
"prefixed_ports": 0,
"parameters": 4,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 1,
"assigns": 0,
"style_signal": -0.6571428571428571
},
{
"path": "stress\\legacy_large_designs\\PE_line.v",
"encoding": "utf-8",
"lines": 56,
"code_lines": 51,
"comment_lines": 0,
"comment_density": 0.0,
"tab_indented_lines": 0,
"space_indented_lines": 34,
"block_comment_markers": 0,
"ports": 7,
"prefixed_ports": 0,
"parameters": 4,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 0,
"assigns": 4,
"style_signal": -0.6071428571428571
},
{
"path": "stress\\protocol_grouping\\negotiate.v",
"encoding": "utf-8",
"lines": 305,
"code_lines": 234,
"comment_lines": 61,
"comment_density": 0.2606837606837607,
"tab_indented_lines": 0,
"space_indented_lines": 264,
"block_comment_markers": 0,
"ports": 9,
"prefixed_ports": 0,
"parameters": 2,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 11,
"assigns": 3,
"style_signal": -0.6048900098080425
},
{
"path": "stress\\legacy_large_designs\\MM_in_buffer.v",
"encoding": "utf-8",
"lines": 268,
"code_lines": 229,
"comment_lines": 5,
"comment_density": 0.021834061135371178,
"tab_indented_lines": 0,
"space_indented_lines": 151,
"block_comment_markers": 0,
"ports": 22,
"prefixed_ports": 0,
"parameters": 7,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 18,
"assigns": 6,
"style_signal": -0.5415987746855243
},
{
"path": "fixtures\\vitis_wrapper_good.v",
"encoding": "utf-8",
"lines": 26,
"code_lines": 26,
"comment_lines": 0,
"comment_density": 0.0,
"tab_indented_lines": 0,
"space_indented_lines": 14,
"block_comment_markers": 0,
"ports": 9,
"prefixed_ports": 0,
"parameters": 0,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 1,
"assigns": 5,
"style_signal": -0.5384615384615384
},
{
"path": "stress\\fsm_control\\ep_sync_detect.v",
"encoding": "utf-8",
"lines": 226,
"code_lines": 186,
"comment_lines": 42,
"comment_density": 0.22580645161290322,
"tab_indented_lines": 8,
"space_indented_lines": 172,
"block_comment_markers": 0,
"ports": 8,
"prefixed_ports": 0,
"parameters": 0,
"c_parameters": 0,
"region_banners": 0,
"has_bilingual_header": 0,
"placeholder_comment_hits": 0,
"always_blocks": 1,
"assigns": 6,
"style_signal": -0.5352554952897516
}
]
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |