CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/qemu-system-test-runner

Author and run QEMU system emulation as an embedded-test target - qemu-system-arm / qemu-system-aarch64 / qemu-system-riscv32 launching cross-compiled ELF binaries on virtual MCUs and SoCs. Covers machine selection (-M virt / mps2-an385 / mps2-an386 / mps2-an500 / mps2-an511 / mps3-an524 / lm3s6965evb / raspi3b / xilinx-zynq-a9), CPU selection (-cpu cortex-m0 / cortex-m3 / cortex-m4 / cortex-m33 / cortex-a15 / cortex-a57 / max), -kernel ELF load, -nographic + -serial stdio, ARM semihosting via -semihosting-config enable=on,target=native (so cross-compiled GoogleTest / Unity binaries print to host stdio and exit with the test return code), GDB stub via -S -gdb tcp::1234, QMP monitor via -qmp tcp:host:port for automated test orchestration, and CI wiring. Use when host-only test runs are insufficient and the team wants arch-correct (endianness / alignment / interrupt-vector) behaviour on a virtual MCU without committing to physical hardware-in-loop.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body built around executable QEMU commands, a useful anti-patterns table, and properly split-off reference files. The main gaps are minor prose padding in the overview sections and the absence of an explicit validate-fix-retry loop in the run workflow.

Suggestions

Tighten the Overview and 'When to use' prose (e.g. the V-cycle framing and HIL comparison) to lift conciseness toward 3 without losing context.

Add an explicit validate-fix-retry loop for the test run (e.g. 'on non-zero exit, inspect -d int,cpu_reset output, fix, re-run') to push workflow_clarity to 3.

DimensionReasoningScore

Conciseness

Mostly efficient — the body is dominated by executable commands, tables, and an anti-pattern table that earn their tokens — but the Overview and 'When to use' prose ('QEMU sits between the host build ... and the physical hardware-in-loop rig (slow, expensive)') restates V-cycle positioning that could be tightened. Not 3 because of this padding; not 1 because the bulk is concrete and high-signal rather than concept explanation.

2 / 3

Actionability

Provides copy-paste-ready, executable commands throughout — the smoke run 'qemu-system-arm -M mps2-an386 -cpu cortex-m4 -nographic -semihosting-config enable=on,target=native -kernel build/test.elf', the GDB attach block, and the QMP JSON-RPC calls. Not 2 because these are complete and runnable, not pseudocode.

3 / 3

Workflow Clarity

A clear build → run → parse-exit-code → CI-gate sequence exists with the exit code as an explicit checkpoint ('CI gates on $?'), and the anti-patterns table acts as guardrails. Not 3 because there is no explicit validate → fix → retry feedback loop for the test pipeline, only an implicit single-pass exit-code gate.

2 / 3

Progressive Disclosure

Clear overview with one-level-deep, well-signaled references that exist as real files — [references/boards.md](references/boards.md), [references/flags.md](references/flags.md), [references/ci.md](references/ci.md) — with detail appropriately split out (full board list, flag table, CI pipeline). Not 2 because references are clearly signaled and shallow, not nested or monolithic.

3 / 3

Total

10

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, capability-rich description that names concrete QEMU flags and an explicit 'Use when' trigger. Its main weakness is trigger-term quality: natural keywords are present but obscured by an over-long enumeration of machine/CPU flag syntax.

Suggestions

Trim the inline flag enumeration (e.g. '-M virt / mps2-an385 / mps2-an386 / mps2-an500 / mps2-an511 / mps3-an524 / lm3s6965evb / raspi3b / xilinx-zynq-a9') to the most common examples and defer the full list to the body, so natural trigger terms surface more clearly.

Lead with the user-facing trigger phrasing before the flag detail to improve trigger-term quality without losing specificity.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with actual flag values — 'machine selection (-M virt / mps2-an385 / mps2-an386 ...)', 'ARM semihosting via -semihosting-config enable=on,target=native', 'GDB stub via -S -gdb tcp::1234', 'QMP monitor via -qmp tcp:host:port'. Not 2 because the actions are specific and enumerated rather than merely naming a domain.

3 / 3

Completeness

Explicitly answers both: what ('Author and run QEMU system emulation as an embedded-test target') and when ('Use when host-only test runs are insufficient and the team wants arch-correct ... behaviour on a virtual MCU without committing to physical hardware-in-loop'). Not 2 because the 'Use when' clause is explicit, not merely implied.

3 / 3

Trigger Term Quality

Natural terms users would say are present (QEMU, embedded, ARM, Cortex-M, semihosting), but they are heavily diluted by dense flag-syntax enumeration (e.g. '-M virt / mps2-an385 / mps2-an386 / mps2-an500 / mps2-an511 / mps3-an524') that is jargon, not trigger phrasing. Not 3 because the natural-keyword coverage is buried under configuration syntax rather than cleanly surfaced.

2 / 3

Distinctiveness Conflict Risk

Carves a clear niche (QEMU system emulation for embedded test with semihosting + CI wiring) with distinct triggers unlikely to fire for adjacent skills like hardware-in-loop-reference. Not 2 because the embedded-test/QEMU/semihosting framing is specific enough to avoid overlap with generic build or HIL skills.

3 / 3

Total

11

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents