Agent skill

Xsimdebug

by BLANK2077 in BLANK2077/xverif

当 AI agent 需要定位 SystemVerilog/UVM 验证问题、重新编译代价过高或不允许再次编译,并需要直接通过终端 PTY 使用 Synopsys VCS UCLI 或 Cadence Xcelium/Xrun Tcl 实时调试正在运行的仿真时使用,包括断点、Ctrl-C 暂停、运行时变量查询和控制流。若已有仿真 log 已足以定位问题,则不使用本 skill。

MITAuto-check passed

Install Xsimdebug

skills CLI
$ npx skills add BLANK2077/xverif --skill xsimdebug -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BLANK2077/xverif xsimdebug --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BLANK2077/xverif.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xsimdebug .claude/skills/xsimdebug && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
xsimdebug
GitHub stars
107
Token cost
~590 tokens
SKILL.md length
156 words
Files
5 (incl. scripts, references)
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

当 AI agent 需要定位 SystemVerilog/UVM 验证问题、重新编译代价过高或不允许再次编译,并需要直接通过终端 PTY 使用 Synopsys VCS UCLI 或 Cadence Xcelium/Xrun Tcl 实时调试正在运行的仿真时使用,包括断点、Ctrl-C 暂停、运行时变量查询和控制流。若已有仿真 log 已足以定位问题,则不使用本 skill。

  • SKILL.md covers 是否触发, 路由, 共同边界 and 交互终端与 tmux, plus 1 more section

What it does

Xsimdebug is an agent skill from BLANK2077/xverif. 当 AI agent 需要定位 SystemVerilog/UVM 验证问题、重新编译代价过高或不允许再次编译,并需要直接通过终端 PTY 使用 Synopsys VCS UCLI 或 Cadence Xcelium/Xrun Tcl 实时调试正在运行的仿真时使用,包括断点、Ctrl-C 暂停、运行时变量查询和控制流。若已有仿真 log 已足以定位问题,则不使用本 skill。

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/vcs-ucli.md` and `references/xrun-tcl.md`).

It works with tmux. The repository describes itself as: xverif is a local toolkit for chip-verification debug agents. It contains deterministic tools for design and waveform debug, coverage, bit calculations, structured entry…. The licence is MIT.

Example prompts

  • “/xsimdebug”

What it can do on your machine

Read from SKILL.md and the folder at commit 6aa13f9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Xsimdebug loads about 590 tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 156 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~590
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from BLANK2077/xverif at commit 6aa13f9, republished under its MIT licence (© BLANK2077). 156 words, ~590 tokens.

Download SKILL.mdSave it as .claude/skills/xsimdebug/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
xsimdebug
description
当 AI agent 需要定位 SystemVerilog/UVM 验证问题、重新编译代价过高或不允许再次编译,并需要直接通过终端 PTY 使用 Synopsys VCS UCLI 或 Cadence Xcelium/Xrun Tcl 实时调试正在运行的仿真时使用,包括断点、Ctrl-C 暂停、运行时变量查询和控制流。若已有仿真 log 已足以定位问题,则不使用本 skill。

xsimdebug

直接持有模拟器 PTY session,通过 stdin/stdout/stderr 实时交互。不要为此搭建 Python、MCP、UDS 或额外 daemon。

是否触发

先阅读已有仿真 log。若 log 已经给出足够证据,可直接定位根因或明确下一步修复,则不触发本 skill。只有仍需观察运行时状态,并符合以下任一场景时才使用:

  • 需要通过交互式运行时现场定位验证问题;
  • 重新编译代价过高,希望复用已有可调试仿真产物;
  • 当前流程不允许再次编译,只能在已有仿真上继续调查。

本 skill 不是默认的日志分析入口,也不应替代成本更低且证据已经充分的 log 定位流程。

路由

先确认实际模拟器,再只读取对应参考:

不要把两个模拟器的命令混用,也不要在一个入口失败后静默切换模拟器。

共同边界

  • 遵守项目对 license 和真实 EDA 工具的宿主执行要求;在 xverif 仓库中直接在沙箱外运行。
  • 保持同一个 PTY session。启动后持续向该 session 写命令,不为每条命令新建 shell 进程。
  • 不确定命令、选项或版本差异时,先在模拟器 prompt 执行 help 和 help <command>;以当前安装版本返回的帮助为准。
  • 运行中需要主动暂停时,向同一个 PTY 注入 Ctrl-C 字节 0x03;返回 prompt 后检查当前位置和调用栈。
  • 交互运行会自动产生 key 命令历史文件:VCS 为启动目录下的 ucli.key,Xrun 为运行目录下的 xrun.key;不要为此修改启动参数。回看执行过哪些命令时第一选择是 key;需要命令输出、错误和上下文时,再读取启动命令现有 -l 所指向的 log,不依赖终端 scrollback。
  • key/log 是模拟器生成的记录,不是 PTY 的逐字节录像;Ctrl-C 等控制字节、终端回显和 prompt 可能不会完整出现。
  • 不把 prompt 返回当作命令成功;检查模拟器原始 error/warning 输出。
  • 保留关键命令、断点 ID、时间、源码位置、实例路径和查询值作为证据。

交互终端与 tmux

优先使用 agent 自带的交互式 terminal/PTY 工具。若 agent 只能执行一次性 shell 命令、不能持续读写同一个 PTY,但宿主提供 tmux,可用一个唯一命名的 tmux session 承载模拟器:

bash
tmux new-session -d -s xsimdebug-vcs \
  'cd /abs/path/to/run-dir && exec ./simv -ucli -no_save'
tmux capture-pane -p -S -200 -t xsimdebug-vcs
tmux send-keys -t xsimdebug-vcs 'help stop' Enter
sed -n '1,240p' /abs/path/to/run-dir/ucli.key
tmux send-keys -t xsimdebug-vcs C-c

Xrun 使用相同机制,把启动命令替换为项目实际的 xrun ... -input /dev/null,不要仅为记录历史追加 -k 或 -l。tmux 只替代 PTY 传输层,不改变 VCS UCLI 或 Xrun Tcl 命令语义。使用前确认 tmux 存在,保留同一 session;capture-pane 只用于确认 prompt/readiness。历史命令先看 key,输出和错误再查看已有 log。不要靠固定 sleep 猜测 ready,也不要为每条命令创建新 session。结束时先向模拟器发送 exit,只管理本次创建且名称明确的 session。

结果要求

  • 明确断点是全实例还是指定 object/component 实例。
  • 条件断点应报告实际条件和命中时变量值。
  • 局部变量离开 block/frame 后不可见是正常生命周期,不误判为设计数据库损坏。
  • 验证实例过滤时,确认非目标实例能够经过目标位置而不触发最终断点。

© BLANK2077, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/xsimdebug of BLANK2077/xverif.

  • SKILL.md
  • agents/openai.yaml
  • references/vcs-ucli.md
  • references/xrun-tcl.md
  • scripts/uvm_component_break.tcl

Open the folder on GitHubat commit 6aa13f9

Compare with similar skills

Xsimdebug next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Xsimdebug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xsimdebug this skillBLANK2077/xverif107—~590Automated safety check: PassMIT
Codex Plugin QAcode-yeongyu/oh-my-openagent70k1 repos~1.9kAutomated safety check: PassCustom licence
Tmuxopenclaw/openclaw392k2 repos~640Automated safety check: PassMIT
1passwordtrpc-group/trpc-agent-go1.8k15 repos~656Automated safety check: PassApache-2.0
CodeGraph Agent Evalcolbymchenry/codegraph73k—~950Automated safety check: PassMIT
Tmuxtrpc-group/trpc-agent-go1.8k24 repos~868Automated safety check: PassApache-2.0

Similar skills

  • Codex Plugin QA

    code-yeongyu/oh-my-openagent

    Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.

    70k GitHub starsUsed in 1 repo~1.9k tokens
    Testing & QAAuto-check passed
  • Tmux

    openclaw/openclaw

    Control tmux sessions/panes for interactive CLIs: list, capture output, send keys, paste text, monitor prompts.

    392k GitHub starsUsed in 2 repos~640 tokens
    Auto-check passed
  • 1password

    trpc-group/trpc-agent-go

    Set up and use 1Password CLI (op). An agent skill from trpc-group/trpc-agent-go.

    1.8k GitHub starsUsed in 15 repos~656 tokens
    AI & LLM EngineeringAuto-check passed
  • CodeGraph Agent Eval

    colbymchenry/codegraph

    Benchmarks how much CodeGraph helps a coding agent on a real repository, comparing runs with and without it for a chosen local or published version.

    73k GitHub stars~950 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Tmux

    trpc-group/trpc-agent-go

    Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.

    1.8k GitHub starsUsed in 24 repos~868 tokens
    Data & AnalyticsAuto-check passed
  • CodexBar Live QA

    steipete/CodexBar

    Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.

    22k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed

More from BLANK2077/xverif

  • X Npi

    BLANK2077/xverif

    当 AI agent 需要使用 Synopsys pynpi 编写 Python 脚本,进行批量 FSDB 波形统计、值扫描、APB/AXI/valid-ready stream 协议分析、VCS/Verdi coverage database 查询,或静态设计 driver/load 查询时使用。离线大规模分析脚本和报告优先使用本 skill;xdebug 风格的实时…

    107 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Xwiki

    BLANK2077/xverif

    当 AI agent 需要在芯片验证任务中复用持续记忆时使用:查询或维护由 XWIKIDIR 指向的验证项目 LLM wiki,了解验证环境、DUT 功能、 接口、testbench、sequence、checker、coverage、workflow、debug 入口、 BT/IT/ST/SoC 项目上下文,并在用户明确要求、项目 AGENTS.md 授权或任务明确…

    107 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Xverif

    BLANK2077/xverif

    用于芯片验证中的确定性事实查询和计算:daidir/FSDB debug、coverage、 SystemVerilog bit 计算、entry 解码、日志位置恢复、SVA 解释和波形渲染。

    107 GitHub stars~931 tokensUpdated today
    Auto-check passed
  • Xverif Admin

    BLANK2077/xverif

    用于 xverif 的安装配置、MCP direct/LSF backend、ssh 远端 MCP(mcpssh)、 SDK-free LSF CLI、UDS/TCP/file transport、session tombstone/gc、timeout、 环境变量、license 和 server 启动排障。普通波形、coverage、bit 或协议查询使用 xverif。

    107 GitHub stars~428 tokensUpdated today
    Auto-check passed

Works with

Questions about Xsimdebug

What does Xsimdebug do?

当 AI agent 需要定位 SystemVerilog/UVM 验证问题、重新编译代价过高或不允许再次编译,并需要直接通过终端 PTY 使用 Synopsys VCS UCLI 或 Cadence Xcelium/Xrun Tcl 实时调试正在运行的仿真时使用,包括断点、Ctrl-C 暂停、运行时变量查询和控制流。若已有仿真 log 已足以定位问题,则不使用本 skill。. Xsimdebug is an agent skill from BLANK2077/xverif.

How do I install Xsimdebug in Claude Code?

Run `npx skills add BLANK2077/xverif --skill xsimdebug -a claude-code`. Or copy the skill folder (skills/xsimdebug in BLANK2077/xverif) into .claude/skills/xsimdebug in your project. Claude Code loads it when a task matches its description.

How do I install Xsimdebug in Codex?

Run `npx skills add BLANK2077/xverif --skill xsimdebug -a codex`. Or copy the skill folder (skills/xsimdebug in BLANK2077/xverif) into .agents/skills/xsimdebug in your project. Codex loads it when a task matches its description.

Can I use Xsimdebug in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BLANK2077/xverif --skill xsimdebug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xsimdebug, .gemini/skills/xsimdebug, .github/skills/xsimdebug and .opencode/skills/xsimdebug in your project.

What does Xsimdebug need to run?

SKILL.md names no scripts, command-line tools or credentials: Xsimdebug is instructions for the agent only.

Does Xsimdebug access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Xsimdebug safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Xsimdebug use?

Xsimdebug is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Xsimdebug use?

About 590 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.2k tokens, read only when the agent opens those files.

What are the alternatives to Xsimdebug?

Skills that share tags, products or a category with Xsimdebug: Codex Plugin QA (code-yeongyu/oh-my-openagent, 70k stars), Tmux (openclaw/openclaw, 392k stars), 1password (trpc-group/trpc-agent-go, 1.8k stars) and CodeGraph Agent Eval (colbymchenry/codegraph, 73k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xsimdebug?

BLANK2077 (a GitHub user) maintains it in BLANK2077/xverif, which has 107 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 8, 2026.

Source: BLANK2077/xverif on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.