awawausb-webusb-firefox — Claude Code skill: WebUSB for Firefox
awawausb-webusb-firefox — a skill that walks you through putting WebUSB into Firefox: the awawausb add-on, a Rust native stub and the manifest that connects them.
no license 306 installs ★ 98 updated 2026-10-09
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a claude-codeWhat awawausb-webusb-firefox does
The skill covers awawausb, a two-piece setup that gives Firefox the navigator.usb object. One piece is a browser add-on shipped as .xpi; the other is a native stub written in Rust. They talk over native messaging, and the stub reaches the hardware through WinUSB, libusb or IOKit.
What you get is the working path. Load the add-on, then run install.sh on Linux or macOS, or install.bat on Windows. Building yourself means cargo build --release inside native-stub. A JSON manifest named awawausb_native_stub.json has to land in the right place: ~/.mozilla/native-messaging-hosts on Linux, the Mozilla NativeMessagingHosts folder under ~/Library/Application Support on macOS, or a registry key under HKCU\SOFTWARE\Mozilla\NativeMessagingHosts\awawausb_native_stub on Windows.
Two hard edges worth knowing before you start. Windows builds expect the mingw-w64 UCRT target x86_64-pc-windows-gnullvm, and MSVC won't work. Also navigator.usb is exposed on the page only — a Web Worker never sees it. Denied device access on Linux usually comes down to udev rules.
What it helps with
- get
navigator.usbworking on a Firefox page - compile the Rust stub with
cargo build --release - register the native messaging manifest on macOS, Linux or Windows
- cross-build the stub for Windows with mingw-w64
- fix denied USB device access on Linux
Example prompts for the agent
- Walk me through installing awawausb: the add-on, the native stub and the native messaging manifest.
- Build
native-stubfor Windows withx86_64-pc-windows-gnullvmand tell me whereawawausb_native_stub.jsongoes. navigator.usbis undefined on my page — debug the Firefox extension and stub setup for me.
How to install awawausb-webusb-firefox
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a claude-code2Manually: put the files in place
~/.claude/skills/awawausb-webusb-firefox/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/awawausb-webusb-firefox/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a codex2Manually: put the files in place
.agents/skills/awawausb-webusb-firefox/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a cursor2Manually: put the files in place
.cursor/skills/awawausb-webusb-firefox/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills skills/awawausb-webusb-firefox2Manually: put the files in place
.github/skills/awawausb-webusb-firefox/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/awawausb-webusb-firefoxManually: put the files in place
.devin/skills/awawausb-webusb-firefox/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about awawausb-webusb-firefox
How do I install awawausb-webusb-firefox in Claude Code?
Run npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a claude-code; the skill lands at ~/.claude/skills/awawausb-webusb-firefox/SKILL.md.
What does this skill do?
It covers the full awawausb setup for Firefox: the add-on, the Rust native stub and the manifest that lets the two talk, plus a build from source when you need one.
Does WebUSB work in a Web Worker?
No. navigator.usb is available on the main page only, so USB calls from a worker won't run.