Observe Trace
ruvnet/ruflo
Trace agent execution by collecting spans and building a trace tree for a task
采集或分析 gem5/XiangShan TAGE trace,比较统计、热点分支和事件分叉. An agent skill from OpenXiangShan/GEM5.
$ npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install OpenXiangShan/GEM5 tage-trace-workflow --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/OpenXiangShan/GEM5.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tage-trace-workflow .claude/skills/tage-trace-workflow && rm -rf skills-srcUse ~/.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/
Install the "tage-trace-workflow" agent skill from https://github.com/OpenXiangShan/GEM5/tree/xs-dev/.agents/skills/tage-trace-workflow into .claude/skills/tage-trace-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tage-trace-workflow", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/OpenXiangShan/GEM5/tree/xs-dev/.agents/skills/tage-trace-workflowType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install OpenXiangShan/GEM5 tage-trace-workflow --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenXiangShan/GEM5.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/tage-trace-workflow .agents/skills/tage-trace-workflow && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tage-trace-workflow" agent skill from https://github.com/OpenXiangShan/GEM5/tree/xs-dev/.agents/skills/tage-trace-workflow into .agents/skills/tage-trace-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tage-trace-workflow", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install OpenXiangShan/GEM5 tage-trace-workflow --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenXiangShan/GEM5.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/tage-trace-workflow .cursor/skills/tage-trace-workflow && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tage-trace-workflow" agent skill from https://github.com/OpenXiangShan/GEM5/tree/xs-dev/.agents/skills/tage-trace-workflow into .cursor/skills/tage-trace-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tage-trace-workflow", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/OpenXiangShan/GEM5.git --path .agents/skills/tage-trace-workflow--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install OpenXiangShan/GEM5 tage-trace-workflow --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenXiangShan/GEM5.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/tage-trace-workflow .gemini/skills/tage-trace-workflow && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tage-trace-workflow" agent skill from https://github.com/OpenXiangShan/GEM5/tree/xs-dev/.agents/skills/tage-trace-workflow into .gemini/skills/tage-trace-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tage-trace-workflow", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install OpenXiangShan/GEM5 tage-trace-workflowInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/OpenXiangShan/GEM5.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/tage-trace-workflow .github/skills/tage-trace-workflow && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tage-trace-workflow" agent skill from https://github.com/OpenXiangShan/GEM5/tree/xs-dev/.agents/skills/tage-trace-workflow into .github/skills/tage-trace-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tage-trace-workflow", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install OpenXiangShan/GEM5 tage-trace-workflow --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenXiangShan/GEM5.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/tage-trace-workflow .opencode/skills/tage-trace-workflow && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tage-trace-workflow" agent skill from https://github.com/OpenXiangShan/GEM5/tree/xs-dev/.agents/skills/tage-trace-workflow into .opencode/skills/tage-trace-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tage-trace-workflow", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
tage-trace-workflow采集或分析 gem5/XiangShan TAGE trace,比较统计、热点分支和事件分叉. An agent skill from OpenXiangShan/GEM5.
Tage Trace Workflow is an agent skill from OpenXiangShan/GEM5. 采集或分析 gem5/XiangShan TAGE trace,比较统计、热点分支和事件分叉。
Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts and reference files (for example `references/build-trace.md`, `references/capture-trace.md` and `scripts/aggregate_rtl_condtrace.py`).
The licence is BSD-3-Clause.
3 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 096f9e1. It shows what the files ask for, not the result of running them.
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.
Ships 10 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Tage Trace Workflow loads about 629 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 17 tokens; SKILL.md has 116 words of instructions outside code blocks.
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.
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.
The full file from OpenXiangShan/GEM5 at commit 096f9e1, republished under its BSD-3-Clause licence (© OpenXiangShan). 116 words, ~629 tokens.
.claude/skills/tage-trace-workflow/SKILL.md (or your agent's skills folder). This skill also uses 12 other files; get the full folder from GitHub.stats.txt、bp.db 或 RTL sqlite:直接使用下方分析脚本,不重新编译或采集。比较前记录两边 commit、输入 checkpoint、配置和统计窗口;检查 restore/warmup 边界,相同 -I 不足以证明窗口一致。只生成结论所需的表和有界窗口。
先看计数器,再看 trace:
stats.txt 中的
updateAllocSuccess / updateAllocFailure / updateAllocFailureNoValidTable / updateResetU / resolveBranchHasProvider / resolveBranchUseProvider / resolveBranchHasAlt / resolveBranchUseAltTable / resolveBranchUseBaseTable / mispredictBranch*CondTrace_* 聚出来的同口径总量provider/alt/useAlt/alloc统计名会随 gem5 commit 变化;以上是当前 checkout 的名字,分析历史归档时要回到对应 commit 确认递增语义。
注意两个口径坑:
TAGEMISSTRACE.useAlt 表示 pred.useAlt,不等于 stats 里的 resolveBranchUseAltTableuseAlt && altFoundBpuTrainTrace 的 self / sibling / none block-level 贡献者归类:
scripts/analyze_rtl_train_contributor.pyBPTRACE 上下文窗口分析:
scripts/analyze_bptrace_context.py常用命令:
python3 .agents/skills/tage-trace-workflow/scripts/aggregate_rtl_condtrace.py \
--rtl-db /path/to/rtl.db --top 12
python3 .agents/skills/tage-trace-workflow/scripts/compare_gem5_rtl_tage.py \
--gem5-stats /tmp/debug/coremark_200k_basic/stats.txt \
--gem5-bpdb /tmp/debug/coremark_200k_basic/bp.db \
--gem5-top-branch-csv /tmp/debug/coremark_200k_basic/topMispredictsByBranch.csv \
--rtl-db /path/to/rtl.db \
--top 12© OpenXiangShan, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 12 other files (scripts, references) in .agents/skills/tage-trace-workflow of OpenXiangShan/GEM5.
Open the folder on GitHubat commit 096f9e1
Tage Trace Workflow 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Tage Trace Workflow this skillOpenXiangShan/GEM5 | 161 | — | ~629 | Automated safety check: Pass | BSD-3-Clause | |
| Observe Traceruvnet/ruflo | 74k | — | ~522 | Automated safety check: Notes | MIT | |
| Tracezereight/gitlab-mcp | 2k | 1 repos | ~412 | Automated safety check: Pass | MIT | |
| Distributed Tracingwshobson/agents | 40k | 12 repos | ~527 | Automated safety check: Pass | MIT | |
| Arize Tracegithub/awesome-copilot | 40k | 1 repos | ~5.9k | Automated safety check: Notes | MIT | |
| Evidence-Driven TraceYeachan-Heo/oh-my-claudecode | 40k | — | ~2.6k | Automated safety check: Pass | MIT |
ruvnet/ruflo
Trace agent execution by collecting spans and building a trace tree for a task
zereight/gitlab-mcp
Evidence-driven tracing with competing hypotheses in parallel.
wshobson/agents
Implement distributed tracing with Jaeger and Tempo to track requests across microservices and identify performance bottlenecks.
github/awesome-copilot
Downloads, exports, and inspects existing Arize traces and spans to understand what an LLM app is doing or debug runtime issues.
Yeachan-Heo/oh-my-claudecode
Explains why something happened by generating competing hypotheses, gathering evidence in parallel, ranking explanations and proposing the next discriminating probe.
jeremylongshore/tons-of-skills-marketplace
A skill your agent uses when encountering bugs, test failures, runtime errors, broken builds, or "this doesn't work" reports.
OpenXiangShan/GEM5
运行或分析 MGSC 微测试的 SC 子表 A/B 实验,用分支与 MGSCTRACE 统计归因并改进测试. An agent skill from OpenXiangShan/GEM5.
OpenXiangShan/GEM5
定位 GEM5 性能 CI 的归档与分数,比较 run 的 benchmark 表现并用 stats 分析变化. An agent skill from OpenXiangShan/GEM5.
OpenXiangShan/GEM5
仅做 BPU 计数器提取与批量汇总(机器可读 JSON/CSV)。配置文件只需要写原始 stats 计数器名. An agent skill from OpenXiangShan/GEM5.
OpenXiangShan/GEM5
编写或校验 GEM5 SolveSpec 参数搜索,并按请求准备或触发 manual-solve.yml. An agent skill from OpenXiangShan/GEM5.
OpenXiangShan/GEM5
为 GEM5 PR 准备或发布性能对比报告,选择可比 baseline 并汇总分数与关键计数器证据. An agent skill from OpenXiangShan/GEM5.
OpenXiangShan/GEM5
用于在本地通过 gh 远程触发 OpenXiangShan/GEM5 的 manual-perf.yml,并在触发后检查 run 是否正常创建。适用于用户明确要求触发 manual-perf、组装 gh workflow run 命令、校验 workflow 输入项、或确认触发后的 Actions run 状态。
采集或分析 gem5/XiangShan TAGE trace,比较统计、热点分支和事件分叉. An agent skill from OpenXiangShan/GEM5. Tage Trace Workflow is an agent skill from OpenXiangShan/GEM5.
Run `npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a claude-code`. Or copy the skill folder (.agents/skills/tage-trace-workflow in OpenXiangShan/GEM5) into .claude/skills/tage-trace-workflow in your project. Claude Code loads it when a task matches its description.
Run `npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a codex`. Or copy the skill folder (.agents/skills/tage-trace-workflow in OpenXiangShan/GEM5) into .agents/skills/tage-trace-workflow in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tage-trace-workflow, .gemini/skills/tage-trace-workflow, .github/skills/tage-trace-workflow and .opencode/skills/tage-trace-workflow in your project.
Going by SKILL.md and its folder, Tage Trace Workflow needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.
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.
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.
Tage Trace Workflow is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 629 tokens (SKILL.md is roughly 2.5k 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 671 tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Tage Trace Workflow: Observe Trace (ruvnet/ruflo, 74k stars), Trace (zereight/gitlab-mcp, 2k stars), Distributed Tracing (wshobson/agents, 40k stars) and Arize Trace (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
OpenXiangShan (a GitHub organization) maintains it in OpenXiangShan/GEM5, which has 161 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 9, 2026.
Source: OpenXiangShan/GEM5 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.