Onboard Arch Precheck

Detect the host's actual Ascend silicon and refuse mismatched onboard hardware tests. On shared hosts, acquire a task-submit device allocation first and run the precheck and hardware test in that same job. Skip for a2a3sim and a5sim.

49 stars 102 forksTesting & QA

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add hw-native-sys/simpler --skill onboard-arch-precheck
Manual install
git clone --depth 1 https://github.com/hw-native-sys/simpler.git /tmp/simpler
mkdir -p ~/.claude/skills
cp -r /tmp/simpler/.claude/skills/onboard-arch-precheck ~/.claude/skills/onboard-arch-precheck

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Onboard Arch Precheck

Gate to prevent running wrong-arch onboard tests on a dev box. CI already
handles this (each onboard runner is labeled with its arch and only gets
matching jobs). Local hardware work bypasses that protection — this skill
restores it.

## Why this exists (DO NOT STRIP — non-obvious failure-mode context)

This repo supports two onboard arches:

- **`a2a3`** — Ascend 910 family (`Ascend910B*` = Atlas A2 silicon;
  `Ascend910_93*` = Atlas A3 silicon; both build via `dav-c220` and share
  `src/a2a3/`)
- **`a5`** — different silicon (`Ascend950*` family, builds via `dav-c310`,
  `src/a5/`)

A given dev box has ONE of them. **Running tests built for the wrong arch
produces error cascades that look like genuine refactor bugs but aren't.**
Typical signatures:

| Error code | Surface | Meaning when arch-mismatched |
| ---------- | ------- | ---------------------------- |
| **507018** (`ACL_ERROR_RT_AICPU_EXCEPTION`) | `aclrtSynchronizeStreamWithTimeout` | AICPU kernel built against the wrong silicon contract faults at runtime; host sees a timeout / aicpu exception. |
| **507899** | `rtStreamCreate` / `rtMalloc` | Driver rejects an operation because the resource model doesn't match the silicon. |

**Critical**: BOTH codes can also be GENUINE bugs (real flaky tests,
real refactor regressions, real AICPU OS issues — see issue #822 for a
historical example). This is precisely what makes the misdiagnosis costly.
Read the full skill on GitHub

Details

Skill name
onboard-arch-precheck
Path
.claude/skills/onboard-arch-precheck/SKILL.md
Repo updated
18 November 2026

FAQ

What does the Onboard Arch Precheck skill do?

Detect the host's actual Ascend silicon and refuse mismatched onboard hardware tests. On shared hosts, acquire a task-submit device allocation first and run the precheck and hardware test in that same job. Skip for a2a3sim and a5sim.

How do I install the Onboard Arch Precheck skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add hw-native-sys/simpler --skill onboard-arch-precheck. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Onboard Arch Precheck popular?

It lives in hw-native-sys/simpler, which has 49 GitHub stars and 102 forks.

Related skills

Benchmark

49

hw-native-sys/simpler

Benchmark runtime performance on hardware. If the current branch has commits ahead of upstream/main or uncommitted changes, compares against the fork point (merge-base). Otherwise benchmarks current state only. Use when the user asks to benchmark, measure performance, or compare latency.

Git & Code Review102

Checkout PR

49

hw-native-sys/simpler

Add a remote for a given PR's head repository and checkout a local pr-xxx-work branch. Use when the user wants to work on someone else's PR locally.

Git & Code Review102

Clean Branches

49

hw-native-sys/simpler

Remove stale local and remote git branches that have been merged into main. Detects regular merges and squash merges. Cleans up fork remote branches and prunes tracking refs. Use when the user asks to clean up branches, remove merged branches, or tidy up git.

Git & Code Review102

Perf Runtime Device

49

hw-native-sys/simpler

Benchmark the hardware performance of all scene tests under a runtime (tests/st/<arch>/<runtime>/, $ARGUMENTS). Use when the user asks to benchmark all examples of a runtime on hardware.

Testing & QA102

Offer Card

49

Liamrjohnston/offer-master-skill

Formats a finished offer as a short paste-ready card and page section. Every number labelled (yours) or (estimate), plus a Check these list and one test to run this month.

Testing & QA

Plan Audit

49

lllyys/vreader

Audit an implementation against a plan (dev-docs/plans/*). Use when a user asks to check for gaps, logic errors, or missing tests relative to a plan or Work Items.

Testing & QA21

Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.