Agent skill

Tage Trace Workflow

by OpenXiangShan in OpenXiangShan/GEM5

采集或分析 gem5/XiangShan TAGE trace,比较统计、热点分支和事件分叉. An agent skill from OpenXiangShan/GEM5.

BSD-3-ClauseAuto-check passed

Install Tage Trace Workflow

skills CLI
$ npx skills add OpenXiangShan/GEM5 --skill tage-trace-workflow -a claude-code

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

GitHub CLI
$ gh skill install OpenXiangShan/GEM5 tage-trace-workflow --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/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-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
tage-trace-workflow
GitHub stars
161
Token cost
~629 tokens
SKILL.md length
116 words
Files
13 (incl. scripts, references)
Skills in repo
10
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

采集或分析 gem5/XiangShan TAGE trace,比较统计、热点分支和事件分叉. An agent skill from OpenXiangShan/GEM5.

  • Works in 3 steps: gem5 stats.txt 中的 → RTL CondTrace_* 聚出来的同口径总量 → 再看热点 branch 的 provider/alt/useAlt/alloc
  • SKILL.md covers 按现有产物选择入口, 分析顺序 and 脚本
  • Runs Python scripts from its folder; calls python3

What it does

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.

Example prompts

  • “/tage-trace-workflow”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. gem5 stats.txt 中的
  2. RTL CondTrace_* 聚出来的同口径总量
  3. 再看热点 branch 的 provider/alt/useAlt/alloc

What it can do on your machine

Read from SKILL.md and the folder at commit 096f9e1. 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 10 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

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.

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

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 OpenXiangShan/GEM5 at commit 096f9e1, republished under its BSD-3-Clause licence (© OpenXiangShan). 116 words, ~629 tokens.

Download SKILL.mdSave it as .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.
name
tage-trace-workflow
description
采集或分析 gem5/XiangShan TAGE trace,比较统计、热点分支和事件分叉。

TAGE Trace Workflow

按现有产物选择入口

  • 已有 stats.txt、bp.db 或 RTL sqlite:直接使用下方分析脚本,不重新编译或采集。
  • 缺少所需 trace:读取 capture-trace.md,先复用版本和表支持匹配的 binary。
  • 需要构建 RTL trace binary:读取 build-trace.md。

比较前记录两边 commit、输入 checkpoint、配置和统计窗口;检查 restore/warmup 边界,相同 -I 不足以证明窗口一致。只生成结论所需的表和有界窗口。

分析顺序

先看计数器,再看 trace:

  1. gem5 stats.txt 中的 updateAllocSuccess / updateAllocFailure / updateAllocFailureNoValidTable / updateResetU / resolveBranchHasProvider / resolveBranchUseProvider / resolveBranchHasAlt / resolveBranchUseAltTable / resolveBranchUseBaseTable / mispredictBranch*
  2. RTL CondTrace_* 聚出来的同口径总量
  3. 再看热点 branch 的 provider/alt/useAlt/alloc

统计名会随 gem5 commit 变化;以上是当前 checkout 的名字,分析历史归档时要回到对应 commit 确认递增语义。

注意两个口径坑:

  • TAGEMISSTRACE.useAlt 表示 pred.useAlt,不等于 stats 里的 resolveBranchUseAltTable
  • 要和 stats 对齐时,应该优先看 useAlt && altFound

脚本

常用命令:

bash
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

Files

SKILL.md and 12 other files (scripts, references) in .agents/skills/tage-trace-workflow of OpenXiangShan/GEM5.

  • SKILL.md
  • references/build-trace.md
  • references/capture-trace.md
  • scripts/aggregate_rtl_condtrace.py
  • scripts/analyze_alloc_lifecycle.py
  • scripts/analyze_bptrace_context.py
  • scripts/analyze_bucket_stability.py
  • scripts/analyze_phist_contributor.py
  • scripts/analyze_phistory_buckets.py
  • scripts/analyze_rtl_train_contributor.py
  • scripts/compare_branch_event_sequences.py
  • scripts/compare_branch_profiles.py
  • scripts/compare_gem5_rtl_tage.py

Open the folder on GitHubat commit 096f9e1

Compare with similar skills

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.

Tage Trace Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tage Trace Workflow this skillOpenXiangShan/GEM5161—~629Automated safety check: PassBSD-3-Clause
Observe Traceruvnet/ruflo74k—~522Automated safety check: NotesMIT
Tracezereight/gitlab-mcp2k1 repos~412Automated safety check: PassMIT
Distributed Tracingwshobson/agents40k12 repos~527Automated safety check: PassMIT
Arize Tracegithub/awesome-copilot40k1 repos~5.9kAutomated safety check: NotesMIT
Evidence-Driven TraceYeachan-Heo/oh-my-claudecode40k—~2.6kAutomated safety check: PassMIT

Similar skills

  • Observe Trace

    ruvnet/ruflo

    Trace agent execution by collecting spans and building a trace tree for a task

    74k GitHub stars~522 tokensUpdated today
    Auto-check: notes
  • Trace

    zereight/gitlab-mcp

    Evidence-driven tracing with competing hypotheses in parallel.

    2k GitHub starsUsed in 1 repo~412 tokens
    DevelopmentAuto-check passed
  • Distributed Tracing

    wshobson/agents

    Implement distributed tracing with Jaeger and Tempo to track requests across microservices and identify performance bottlenecks.

    40k GitHub starsUsed in 12 repos~527 tokens
    DevOps & CloudAuto-check passed
  • Arize Trace

    github/awesome-copilot

    Official

    Downloads, exports, and inspects existing Arize traces and spans to understand what an LLM app is doing or debug runtime issues.

    40k GitHub starsUsed in 1 repo~5.9k tokens
    DevelopmentAuto-check: notes
  • Evidence-Driven Trace

    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.

    40k GitHub stars~2.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Trace

    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.

    2.8k GitHub stars~5k tokensUpdated today
    DevelopmentAuto-check passed

More from OpenXiangShan/GEM5

All 10 skills in this repo
  • Mgsc Table Probe

    OpenXiangShan/GEM5

    运行或分析 MGSC 微测试的 SC 子表 A/B 实验,用分支与 MGSCTRACE 统计归因并改进测试. An agent skill from OpenXiangShan/GEM5.

    161 GitHub stars~628 tokensUpdated today
    Auto-check passed
  • CI Perf Analysis

    OpenXiangShan/GEM5

    定位 GEM5 性能 CI 的归档与分数,比较 run 的 benchmark 表现并用 stats 分析变化. An agent skill from OpenXiangShan/GEM5.

    161 GitHub stars~545 tokensUpdated today
    Auto-check passed
  • Frontend Pmu Analysis

    OpenXiangShan/GEM5

    仅做 BPU 计数器提取与批量汇总(机器可读 JSON/CSV)。配置文件只需要写原始 stats 计数器名. An agent skill from OpenXiangShan/GEM5.

    161 GitHub stars~305 tokensUpdated today
    Auto-check passed
  • CI Param Solver

    OpenXiangShan/GEM5

    编写或校验 GEM5 SolveSpec 参数搜索,并按请求准备或触发 manual-solve.yml. An agent skill from OpenXiangShan/GEM5.

    161 GitHub stars~389 tokensUpdated today
    Auto-check passed
  • CI Perf PR Report

    OpenXiangShan/GEM5

    为 GEM5 PR 准备或发布性能对比报告,选择可比 baseline 并汇总分数与关键计数器证据. An agent skill from OpenXiangShan/GEM5.

    161 GitHub stars~462 tokensUpdated today
    Auto-check passed
  • Gem5 Manual Perf Trigger

    OpenXiangShan/GEM5

    用于在本地通过 gh 远程触发 OpenXiangShan/GEM5 的 manual-perf.yml,并在触发后检查 run 是否正常创建。适用于用户明确要求触发 manual-perf、组装 gh workflow run 命令、校验 workflow 输入项、或确认触发后的 Actions run 状态。

    161 GitHub stars~763 tokensUpdated today
    Auto-check passed

Questions about Tage Trace Workflow

What does Tage Trace Workflow do?

采集或分析 gem5/XiangShan TAGE trace,比较统计、热点分支和事件分叉. An agent skill from OpenXiangShan/GEM5. Tage Trace Workflow is an agent skill from OpenXiangShan/GEM5.

How do I install Tage Trace Workflow in Claude Code?

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.

How do I install Tage Trace Workflow in Codex?

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.

Can I use Tage Trace Workflow 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 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.

What does Tage Trace Workflow need to run?

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.

Does Tage Trace Workflow 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 Tage Trace Workflow 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 Tage Trace Workflow use?

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.

How many tokens does Tage Trace Workflow use?

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.

What are the alternatives to Tage Trace Workflow?

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.

Who maintains Tage Trace Workflow?

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.