Skip to content
Back to search

xilinx-skill

Xilinx/AMD FPGA & MPSoC Vivado design skill for Claude — covers block design, IP config, XDC constraints, synthesis, implementation and bitstream generation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/qingquanyao--xilinx-skill/badge.svg)](/listings/qingquanyao--xilinx-skill)

HTML

<a href="/listings/qingquanyao--xilinx-skill"><img src="/api/listings/qingquanyao--xilinx-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code(推荐)

本仓库是一个 Claude Code 插件市场,一行命令即可安装:

/plugin marketplace add QingquanYao/xilinx-skill

然后安装插件:

/plugin install xilinx-suite

搞定,Skill 即刻可用。

OpenAI Codex CLI

git clone https://github.com/QingquanYao/xilinx-skill.git
cd xilinx-skill && bash install.sh        # macOS/Linux
cd xilinx-skill; .\install.ps1            # Windows PowerShell

或手动安装:

mkdir -p ~/.agents/skills/xilinx-suite
cp plugins/xilinx-suite/skills/xilinx-suite/SKILL.md ~/.agents/skills/xilinx-suite/
cp -r plugins/xilinx-suite/references ~/.agents/skills/xilinx-suite/
cp AGENTS.md ~/.codex/AGENTS.md

OpenClaw

git clone https://github.com/QingquanYao/xilinx-skill.git
cd xilinx-skill && bash install.sh        # macOS/Linux
cd xilinx-skill; .\install.ps1            # Windows PowerShell

或手动安装:

mkdir -p ~/.openclaw/skills/xilinx-suite
cp plugins/xilinx-suite/skills/xilinx-suite/SKILL.md ~/.openclaw/skills/xilinx-suite/
cp -r plugins/xilinx-suite/references ~/.openclaw/skills/xilinx-suite/

兼容性

| 工具 | 安装方式 | 格式 | |------|---------|------| | **Claude Code** | `/plugin marketplace add`(原生支持) | Plugin Marketplace | | **OpenAI Codex** | `install.sh` / 手动复制 | `SKILL.md` + `AGENTS.md` | | **OpenClaw** | `install.sh` / 手动复制 | `SKILL.md` |

> 三个工具都遵循 [Agent Skills](https://agentskills.io) 开放标准。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 42 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "xilinx-skill",
  4. "description": "Xilinx (AMD) FPGA/MPSoC full-toolchain skills for AI coding assistants",
  5. "owner": {
  6. "name": "QingquanYao"
  7. },
  8. "metadata": {
  9. "version": "1.0.0",
  10. "pluginRoot": "./plugins"
  11. },
  12. "plugins": [
  13. {
  14. "name": "xilinx-suite",
  15. "source": "./plugins/xilinx-suite",
  16. "description": "Xilinx full-toolchain assistant covering Vivado, Vitis HLS, Vitis Unified IDE, and PetaLinux -- from HLS algorithm to boot image",
  17. "version": "1.0.0",
  18. "category": "development",
  19. "author": {
  20. "name": "QingquanYao"
  21. },
  22. "homepage": "https://github.com/QingquanYao/xilinx-skill",
  23. "repository": "https://github.com/QingquanYao/xilinx-skill",
  24. "license": "MIT",
  25. "keywords": [
  26. "vivado",
  27. "fpga",
  28. "mpsoc",
  29. "hls",
  30. "vitis",
  31. "petalinux",
  32. "xilinx",
  33. "amd",
  34. "zynq",
  35. "ultrascale",
  36. "xdc",
  37. "tcl",
  38. "jesd204"
  39. ]
  40. }
  41. ]
  42. }
README.md · README · 229 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="README_en.md">English</a> | <a href="README.md">中文</a>
  3. </p>
  4. <p align="center">
  5. <img src="assets/xilinx-skill-banner.png" alt="xilinx-skill -- AI-Powered Vivado Design Automation" width="800"/>
  6. </p>
  7. <p align="center">
  8. <img src="https://img.shields.io/badge/Platform-Xilinx%20%7C%20AMD-E4002B?style=for-the-badge&logo=xilinx&logoColor=white" alt="Xilinx"/>
  9. <img src="https://img.shields.io/badge/Powered%20by-Claude%20Code-7C3AED?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude Code"/>
  10. <img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"/>
  11. </p>
  12. # 让AI全流程自己调试FPGA真的爽翻了
  13. # Xilinx 全工具链 Skill -- AI 编程助手插件
  14. > **让 AI 处理繁琐的 Tcl 脚本,你只需专注架构设计。**
  15. 一个 AI 编程助手 Skill(支持 Claude Code / Codex / OpenClaw),用自然语言描述你的设计需求,即可生成可直接运行的 Vivado / Vitis HLS / Vitis Unified / PetaLinux 脚本。覆盖从 HLS 算法到启动镜像的完整 FPGA/MPSoC 设计流程。
  16. ---
  17. ## 强烈推荐安装的 MCP Server
  18. **只有安装下列 MCP Server,才能实现全自动调试与开发**——AI 直接控制 Xilinx 工具链和基础设施,无需人工干预:
  19. | MCP Server | 说明 |
  20. |-----------|------|
  21. | [vivado-mcp](https://github.com/QingquanYao/vivado-mcp) | AI 驱动的 Vivado 会话控制 -- 综合、时序报告、CRITICAL WARNING 自动诊断、烧写器件 |
  22. | [vitis_mcp](https://github.com/QingquanYao/vitis_mcp) | AI 驱动的 Vitis 控制 -- 嵌入式软件全流程自动化 |
  23. | [ssh-mcp](https://github.com/tufantunc/ssh-mcp) | 通过 SSH 连接虚拟机执行 PetaLinux 编译 -- 支持 sudo 和超时保护 |
  24. | [vmware-mcp](https://github.com/ZacharyZcR/vmware-mcp) | VMware Workstation Pro 虚拟机控制 -- 管理 PetaLinux 构建环境 |
  25. ---
  26. ## 为什么需要这个 Skill?
  27. | 痛点 | 本 Skill 如何解决 |
  28. | ---------------------- | -------------------------------------------------- |
  29. | Vivado Tcl API 跨版本变化大 | 参考文档锁定版本特定 API,自动选择正确的命令 |
  30. | PS 配置参数多达 200+ 项 | 引导式问答 + 经过验证的 DDR/MIO/时钟 Tcl 模板 |
  31. | XDC 约束语法容易出错 | 从自然语言描述直接生成正确的 `set_property` / `create_clock` |
  32. | 跨工具交接流程复杂 | 自动化 HLS IP -> Vivado -> XSA -> Vitis/PetaLinux 数据流 |
  33. | JESD204B -> 204C 迁移风险高 | 提供端口映射、寄存器差异的分步迁移指南 |
  34. ---
  35. ## 支持的工具与器件
  36. ```
  37. Vitis HLS ──> Vivado ──> Vitis Unified / PetaLinux
  38. C/C++ IP 硬件设计 裸机 / RTOS / Linux
  39. ```
  40. **工具:** Vivado、Vitis HLS、Vitis Unified IDE (2022.x+)、PetaLinux
  41. **器件:** Zynq UltraScale+ MPSoC(CG/EG/EV 全系,ZCU10x 评估板及自制板)、Virtex/Kintex UltraScale+/UltraScale、7 系列、Versal ACAP
  42. ---
  43. ## 安装
  44. ### Claude Code(推荐)
  45. 本仓库是一个 Claude Code 插件市场,一行命令即可安装:
  46. ```
  47. /plugin marketplace add QingquanYao/xilinx-skill
  48. ```
  49. 然后安装插件:
  50. ```
  51. /plugin install xilinx-suite
  52. ```
  53. 搞定,Skill 即刻可用。
  54. ### OpenAI Codex CLI
  55. ```bash
  56. git clone https://github.com/QingquanYao/xilinx-skill.git
  57. cd xilinx-skill && bash install.sh # macOS/Linux
  58. cd xilinx-skill; .\install.ps1 # Windows PowerShell
  59. ```
  60. 或手动安装:
  61. ```bash
  62. mkdir -p ~/.agents/skills/xilinx-suite
  63. cp plugins/xilinx-suite/skills/xilinx-suite/SKILL.md ~/.agents/skills/xilinx-suite/
  64. cp -r plugins/xilinx-suite/references ~/.agents/skills/xilinx-suite/
  65. cp AGENTS.md ~/.codex/AGENTS.md
  66. ```
  67. ### OpenClaw
  68. ```bash
  69. git clone https://github.com/QingquanYao/xilinx-skill.git
  70. cd xilinx-skill && bash install.sh # macOS/Linux
  71. cd xilinx-skill; .\install.ps1 # Windows PowerShell
  72. ```
  73. 或手动安装:
  74. ```bash
  75. mkdir -p ~/.openclaw/skills/xilinx-suite
  76. cp plugins/xilinx-suite/skills/xilinx-suite/SKILL.md ~/.openclaw/skills/xilinx-suite/
  77. cp -r plugins/xilinx-suite/references ~/.openclaw/skills/xilinx-suite/
  78. ```
  79. ### 兼容性
  80. | 工具 | 安装方式 | 格式 |
  81. |------|---------|------|
  82. | **Claude Code** | `/plugin marketplace add`(原生支持) | Plugin Marketplace |
  83. | **OpenAI Codex** | `install.sh` / 手动复制 | `SKILL.md` + `AGENTS.md` |
  84. | **OpenClaw** | `install.sh` / 手动复制 | `SKILL.md` |
  85. > 三个工具都遵循 [Agent Skills](https://agentskills.io) 开放标准。
  86. ---
  87. ## 使用方法
  88. 用自然语言描述你的任务即可,例如:
  89. ```
  90. > 为我的 ZynqMP 板卡创建 Vivado 工程,包含 Zynq PS、2 个 AXI GPIO 和 1 个 BRAM 控制器
  91. > 为我的 Virtex UltraScale+ 板卡生成 200MHz 系统时钟的 XDC 约束,IO 标准为 LVDS
  92. > 用我的 XSA 文件构建 PetaLinux 镜像,需要自定义设备树覆盖
  93. > 将我的 JESD204B DAC 接口迁移到 JESD204C
  94. > 创建一个矩阵乘法的 Vitis HLS IP,使用 AXI4-Stream 接口
  95. ```
  96. Skill 会自动:
  97. 1. 询问必要信息(目标器件、版本、接口等)
  98. 2. 加载相关参考文档
  99. 3. 生成完整可运行的脚本
  100. 4. 告诉你如何执行以及下一步做什么
  101. ---
  102. ## 参考文档库
  103. | 文件 | 内容覆盖 |
  104. | ---------------------------- | ---------------------------------------- |
  105. | `vivado_guide.md` | 工程创建、Block Design、综合、实现、报告分析 |
  106. | `mpsoc_ps_config.md` | Zynq UltraScale+ PS 配置 -- DDR4、MIO、时钟、中断 |
  107. | `mpsoc_bd_guide.md` | Block Design 自动化模式与最佳实践 |
  108. | `xdc_constraints.md` | 时序约束、IO 标准、引脚分配 |
  109. | `xdc_guide.md` | XDC 语法快速参考 |
  110. | `hls_guide.md` | Vitis HLS C/C++ 到 IP 流程、pragma、优化 |
  111. | `vitis_unified_guide.md` | Vitis 2022.x+ 平台、域、应用创建 |
  112. | `petalinux_guide.md` | BSP 配置、内核、rootfs、启动镜像生成 |
  113. | `jesd204b_to_c_migration.md` | JESD204B 到 204C IP 迁移 -- 端口、寄存器、常见陷阱 |
  114. | `vu9p_guide.md` | 纯 FPGA(无 PS)工程流程 -- UltraScale+/UltraScale/7 系列 |
  115. | `tcl_commands.md` | 常用 Vivado Tcl 命令参考 |
  116. | `official-docs/index.md` | Xilinx/AMD 官方文档索引 -- UG/PG/DS/XAPP 编号、标题、用途,以及与本仓库参考指南的对应关系 |
  117. ---
  118. ## 生成的工程结构
  119. Skill 会按阶段组织输出,结构清晰:
  120. ```
  121. project_root/
  122. ├── 01_hls/ # Vitis HLS(可选)
  123. │ ├── hls_create.tcl
  124. │ └── src/
  125. ├── 02_vivado/ # 硬件设计
  126. │ ├── create_project.tcl
  127. │ ├── create_bd.tcl
  128. │ ├── constraints/*.xdc
  129. │ ├── build.tcl
  130. │ └── output/ # .bit + .xsa
  131. ├── 03_vitis/ # 嵌入式软件
  132. │ ├── create_platform.tcl
  133. │ └── src/
  134. └── 04_petalinux/ # Linux(可选)
  135. ├── build.sh
  136. └── config/
  137. ```
  138. ---
  139. ## 贡献
  140. 本项目由社区共同维护,欢迎参与贡献!
  141. **贡献方式:**
  142. - 添加新 IP 核或器件系列的参考文档
  143. - 补充版本特定的 API 细节
  144. - 修正错误或补全 Tcl API 覆盖
  145. - 翻译参考文档
  146. 详见 [CONTRIBUTING.md](CONTRIBUTING.md)。
  147. ---
  148. ## Star 趋势
  149. <a href="https://www.star-history.com/?type=date&repos=QingquanYao%2Fxilinx-skill">
  150. <picture>
  151. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=QingquanYao/xilinx-skill&type=date&theme=dark&legend=top-left" />
  152. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=QingquanYao/xilinx-skill&type=date&legend=top-left" />
  153. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=QingquanYao/xilinx-skill&type=date&legend=top-left" />
  154. </picture>
  155. </a>
  156. ---
  157. ## 许可证
  158. MIT
  159. ---
  160. <p align="center">
  161. <sub>由 <a href="https://github.com/QingquanYao">@QingquanYao</a> 使用 Claude Code 构建</sub>
  162. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.