Home / openxiangshan / xiangshanlab · tools/RISC-V skill/openclaw-skills-main/riscv-spec/SKILL.md · GitHub

riscv-spec skillA

riscv-spec is agent-read markdown (skill) from openxiangshan/xiangshanlab: Look up RISC-V ISA specification details using the local riscv-unified-db (UDB) repository. Activate when answering questions about RISC-V extensions, instructions, encodings, assembly syntax, CSR fields, architectural parameters (hardware configuration knobs), profile requirements (RVA20/22/23, RVB23, etc.), or any ISA-level spec claim. Also use for verifying RISC-V spec claims before stating them - including claims in patches, commit messages, or upstream discussions about spec compliance. For.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# RISC-V Spec Lookup

## Rule

Never state RISC-V spec claims without verifying against UDB or upstream spec sources. If UDB doesn't cover it, say so explicitly.

## Local Database

Path: `~/repos/riscv-unified-db/`

If the directory does not exist, **ask the user for confirmation before cloning** (~200MB). Do not clone silently.

### Keeping UDB Fresh

After cloning or fetching, record the date in `<skill_dir>/.last-update` (same directory as this SKILL.md).

On each activation, check the file. If older than 7 days (or missing), run:
```bash
cd ~/repos/riscv-unified-db && git fetch origin && git merge --ff-only origin/main
```
Then update the timestamp.

## Lookup Procedure

### Extensions
```
spec/std/isa/ext/<Name>.yaml
```
Key fields: `name`, `long_name`, `description`, `versions[]` (state, ratification_date), `requirements`

If unsure of exact name: `find spec/std/isa/ext/ -iname '*keyword*'`

### Instructions
```
spec/std/isa/inst/<Ext>/<name>.yaml
```
Key fields: `name`, `long_name`, `description`, `assembly` (syntax), `encoding.match` (bitmask), `encoding.variables[]` (operand bit locations), `access` (s/u/vs/vu permissions), `definedBy`, `operation()`
…

Read the whole file at its exact version.

How to install

Latest version
mdr add openxiangshan/xiangshanlab/riscv-spec@git:20260920.b781a6d
Exact content
mdr add openxiangshan/xiangshanlab/riscv-spec@sha256:20f903e194348b67

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.b781a6d latest2026-09-20 b781a6d 5,461 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (5461 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 · 41 stars · license none · pushed 2026-09-22 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_sbpn4tjjx4woqjme
GET https://markdownregistry.com/api/v1/resolve?ref=openxiangshan/xiangshanlab/riscv-spec
GET https://markdownregistry.com/api/v1/blob/20f903e194348b67f4b5c2a132e67378026b14965c4a53ec0a623793a1827c92

Your agent 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.

More from openxiangshan/xiangshanlab

english-word-card 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 · 41 stars
analyze-xiangshan-wavekit 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 · 41 stars
riscv-skill-pack 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 · 41 stars
scenarios-extractor 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 · 41 stars
riscv-security-hc-spec 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 · 41 stars
xiangshan-bug-pipeline 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 · 41 stars
get-xiangshan-bug 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 · 41 stars
xiangshan-bug-analysis 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 · 41 stars
analyze-xiangshan-kunminghu 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 · 41 stars
analyze-xiangshan-kunminghu 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 · 41 stars
xiangshan-bug-fixer 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 · 41 stars
difftest-tracer skill
openxiangshan/xiangshanlab · tools/xiangshan-debug/difftest-tracer/SKILL.md · Analyze XiangShan and RISC-V difftest failures from simulator logs plus program BIN, ELF, and objdump/disassembly…
git:20260828.1e67491 · audit A · 41 stars

Every file in openxiangshan/xiangshanlab

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