xiangshan-mpt-dut SKILL.md skillA

xiangshan-mpt-dut from openxiangshan/xiangshanlab is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add openxiangshan/xiangshanlab/xiangshan-mpt-dut@git:20260724.bb8f3f1

Pins git:20260724.bb8f3f1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
openxiangshan/xiangshanlab
Path
xiangshan-programming-practice/mmu-smmpt/skill/xiangshan-mpt-dut/SKILL.md
Versions recorded
1
Latest version
git:20260724.bb8f3f1, committed Jul 24, 2026
Size
2,306 bytes
Repository stars
62
License
none declared

Generate or update a compact Chisel/Scala DUT that isolates XiangShan MPT checking logic from the full core. Use when working on XiangShan MPT, MptChecker.scala, L2TLB MPT wiring, backend/decode mfence support, or the custom smmpt/mmpt CSR path, especially when asked to regenerate a simple DUT around MPT upstream/downstream logic for simulation or verification.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# XiangShan MPT DUT

## Workflow

Use this skill to rebuild a small DUT around XiangShan's MPT checker without dragging in the whole core.

1. Inspect the local XiangShan source before editing. Prefer `rg` and targeted `sed` reads.
2. Load [references/mpt-dut-generation.md](references/mpt-dut-generation.md) before implementing the DUT.
3. Keep the DUT focused on `MptChecker` and its real upstream/downstream contract:
   - upstream request/response: `MptReqBundle` and `MptRespBundle`
   - CSR input: `TlbCsrBundle.mmpt`
   - flush input: `SfenceBundle`, including `mfence` when `HasMptCheck`
   - memory side: `L2TlbMemReqBundle` request plus XLEN response
   - PMP side: `PMPReqBundle` and `PMPRespBundle`
4. Preserve the XiangShan parameter gate: the DUT should be meaningful only with `HasMptCheck = true`.
5. Do not model the full backend, ROB, LSQ, PTW cluster, or complete L2TLB unless the user explicitly asks. Replace them with small drivers, arbiters, memories, or stubs that preserve handshake semantics.

## Output Shape

Prefer one of these forms, matching the repository style:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add openxiangshan/xiangshanlab/xiangshan-mpt-dut@sha256:5aadaf6dc64ac302

The line at the top of this page pins the label git:20260724.bb8f3f1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_66igpyafpbvl7w7t.svg)](https://markdownregistry.com/a/art_66igpyafpbvl7w7t)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jul 24, 2026.

versioncommittedcommitsizeaudit
git:20260724.bb8f3f1 latest2026-07-24 bb8f3f1 2,306 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2306 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

openxiangshan/xiangshanlab · 62 stars · license none declared · pushed 2026-11-06 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_66igpyafpbvl7w7t
GET https://markdownregistry.com/api/v1/resolve?ref=openxiangshan/xiangshanlab/xiangshan-mpt-dut
GET https://markdownregistry.com/api/v1/blob/5aadaf6dc64ac302c297d71e7fdd38d201da63d9e80dabaf47a6e47ca246f2c3

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from openxiangshan/xiangshanlab

english-word-card SKILL.md skill
openxiangshan/xiangshanlab · tools/RISC-V skill/openclaw-skills-main/english-word-card/SKILL.md · Generate illustrated English word learning cards for kids. Activate when the user asks to explain an English word to…
git:20260920.b781a6d · audit A · 62 stars
riscv-spec SKILL.md skill
openxiangshan/xiangshanlab · tools/RISC-V skill/openclaw-skills-main/riscv-spec/SKILL.md · Look up RISC-V ISA specification details using the local riscv-unified-db (UDB) repository. Activate when answering…
git:20260920.b781a6d · audit A · 62 stars
analyze-xiangshan-wavekit SKILL.md skill
openxiangshan/xiangshanlab · tools/analyze-xiangshan-wavekit/SKILL.md · Use this skill when analyzing XiangShan/香山 processor simulation waveforms with the wavekit open-source repository. It…
git:20260717.48f785a · audit A · 62 stars
riscv-skill-pack SKILL.md skill
openxiangshan/xiangshanlab · tools/riscv-skill-pack/SKILL.md · One-stop RISC-V skill pack covering specification learning, gap analysis, requirement analysis, ecosystem governance…
v1.0 · audit A · 62 stars
scenarios-extractor SKILL.md skill
openxiangshan/xiangshanlab · tools/scenarios-extractor/skills/SKILL.md · Generate detailed, code-grounded XiangShan verification scenario descriptions from a microarchitecture optimization…
git:20260723.ebce76a · audit A · 62 stars
riscv-security-hc-spec SKILL.md skill
openxiangshan/xiangshanlab · tools/specification-analyzer/riscv-security-hc-spec/SKILL.md · Look up RISC-V Security Horizontal Committee related specifications, including ratified and unratified/development…
git:20260721.1f8fa49 · audit A · 62 stars
xiangshan-bug-pipeline SKILL.md skill
openxiangshan/xiangshanlab · tools/xiangshan-bugs-analyzer/SKILL.md · End-to-end XiangShan bug pipeline: fetch GitHub issues and PRs, create per-issue bug-analysis-<issue-number> workdirs…
git:20260731.b099e95 · audit A · 62 stars
get-xiangshan-bug SKILL.md skill
openxiangshan/xiangshanlab · tools/xiangshan-bugs-analyzer/fetch-xiangshan-bugs/SKILL.md · Collect XiangShan GitHub issues and pull requests into a local bug library for triage, branch-aware analysis, and cause…
git:20260728.30913b6 · audit A · 62 stars
xiangshan-bug-analysis SKILL.md skill
openxiangshan/xiangshanlab · tools/xiangshan-bugs-analyzer/xiangshan-bugs-analysis/SKILL.md · Analyze XiangShan bug waveforms from FST/VCD/FSDB, logs, disassembly, and source. Use when root-causing frontend…
git:20260728.30913b6 · audit A · 62 stars
analyze-xiangshan-kunminghu SKILL.md skill
openxiangshan/xiangshanlab · tools/xiangshan-code-analyzer/skills/analyze-xiangshan-kunminghu/SKILL.md · Analyze OpenXiangShan Kunminghu source and related design/course code. Use for code-grounded module walkthroughs…
git:20260721.1f8fa49 · audit A · 62 stars
analyze-xiangshan-kunminghu SKILL.md skill
openxiangshan/xiangshanlab · tools/xiangshan-code-analyzer/tools/analyze-xiangshan-kunminghu/SKILL.md · Analyze OpenXiangShan XiangShan Kunminghu microarchitecture source, design docs, XiangShanLab course concepts, XSCache…
git:20260721.1f8fa49 · audit A · 62 stars
xiangshan-bug-fixer SKILL.md skill
openxiangshan/xiangshanlab · tools/xiangshan-debug/bug-fixer/SKILL.md · Reproduce, diagnose, fix, and validate OpenXiangShan/XiangShan bugs from a GitHub issue number. Use when an agent must…
git:20260828.aaec939 · audit A · 62 stars

Every file in openxiangshan/xiangshanlab

Browse by kind, by grade A, or by owner.