hardware-hardspoof-spoofing-toolkit — Claude Code skill
hardware-hardspoof-spoofing-toolkit — a skill that walks the agent through hardsp00f: MAC swaps, SMBIOS strings, DNS and SNI behaviour, browser fingerprint traits. Built for permitted testing on a box you control.
no license 218 installs ★ 13 updated 2026-10-09
npx skills add reason-machines/security-skills --skill hardware-hardspoof-spoofing-toolkit -a claude-codeWhat hardware-hardspoof-spoofing-toolkit does
The skill covers the hardsp00f suite: a background daemon hardsp00fd, a control CLI hardsp00f-cli, and YAML profiles kept in /etc/hardsp00f/profiles/. A profile spells out the persona to present (CPU vendor and core count, memory type, drive model, MAC vendor prefixes) and the tactics to run: ARP refresh with jitter, DNS resolver rotation, TLS 1.2 and 1.3 probabilities at the SNI layer, canvas noise, a chosen WebGL renderer, TTL variation. A stripped-down profile can leave only ARP switched on.
Interfaces change one at a time (hardsp00f-cli spoof-interface eth0 --randomize-mac) or all at once with --mode adaptive; revert-interface puts the original back. Python bindings expose HardSpoofClient, Profile and NetworkInterface, so a MAC can be randomised from a vendor prefix or set by hand.
On Linux you need build-essential, headers for the running kernel and libyaml-dev. The module is built with make kernel-module, installed by sudo make install and loaded with modprobe hardsp00f. Everything runs as root. The author's own warning is blunt: the suite is for security testing you have permission to do. It loads a kernel module and rewrites network settings, so give it a throwaway machine rather than your daily driver.
What it helps with
- swap the MAC on
eth0before a test run - build a YAML profile for one lab session
- set canvas noise and a WebGL renderer in the browser fingerprint
- restore an interface to its original MAC
- list active spoofs and export the config to a file
Example prompts for the agent
- Spoof my MAC and device fingerprint using the
stealth.yamlprofile - Create a
custom_stealthprofile from thedefaulttemplate and apply it - Show what is currently spoofed and export the config to
current_config.yaml
How to install hardware-hardspoof-spoofing-toolkit
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill hardware-hardspoof-spoofing-toolkit -a claude-code2Manually: put the files in place
~/.claude/skills/hardware-hardspoof-spoofing-toolkit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hardware-hardspoof-spoofing-toolkit/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill hardware-hardspoof-spoofing-toolkit -a codex2Manually: put the files in place
.agents/skills/hardware-hardspoof-spoofing-toolkit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill hardware-hardspoof-spoofing-toolkit -a cursor2Manually: put the files in place
.cursor/skills/hardware-hardspoof-spoofing-toolkit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/security-skills skills/hardware-hardspoof-spoofing-toolkit2Manually: put the files in place
.github/skills/hardware-hardspoof-spoofing-toolkit/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill hardware-hardspoof-spoofing-toolkit -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/security-skills --path skills/hardware-hardspoof-spoofing-toolkitManually: put the files in place
.devin/skills/hardware-hardspoof-spoofing-toolkit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill hardware-hardspoof-spoofing-toolkit -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 hardware-hardspoof-spoofing-toolkit
How do I install hardware-hardspoof-spoofing-toolkit in Claude Code?
Run npx skills add reason-machines/security-skills --skill hardware-hardspoof-spoofing-toolkit -a claude-code. The skill file lands at ~/.claude/skills/hardware-hardspoof-spoofing-toolkit/SKILL.md.
What does this skill do?
It tells the agent how to drive the hardsp00f suite: YAML profiles, MAC and SMBIOS changes, DNS and SNI settings, canvas noise in the browser fingerprint. Control goes through the daemon and hardsp00f-cli.
What does hardsp00f need on Linux?
Root access, plus build-essential, libyaml-dev and headers for the running kernel. Build the module, install it with sudo make install, then load it with sudo modprobe hardsp00f.