Skip to content

Guide · Agent skill

How to use the RF / SDR Security Research agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The radio-sdr skill is an instruction file that tells an AI agent how to help with authorized security research on radio signals using software-defined radio (SDR) hardware. It covers identifying a signal's frequency and modulation, decoding protocols such as ADS-B aircraft broadcasts, and assessing whether a recorded signal could be replayed in a shielded lab. This guide shows you how to install the skill, ask for work in plain language, and stay within its safety limits.

RF / SDR Security Researchzhaoxuya520/reverse-skill · MIT

Quick start

  1. 1Download the skill ZIP. Download the radio-sdr skill ZIP from this page.
  2. 2Unzip it into a skills folder. Unzip the file into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder for one project.
  3. 3Or upload it in the Claude apps. In the Claude apps, go to Settings, then Capabilities, then Skills, and upload the skill instead.
  4. 4Confirm your authorization. Write down the scope of your testing: devices, frequency bands and whether transmission is allowed. The skill requires this before testing.
  5. 5Make a receive-only request. Ask the agent to identify the frequency and modulation of a capture you already have, using your SDR hardware and analysis software.
  6. 6Review the conclusions. Check the agent's findings and ask for hardening recommendations for any device you own.

What the radio-sdr skill makes the agent do

An agent skill is a set of instructions that an AI agent reads when a task matches its description. The radio-sdr skill is written for RF and SDR security research outside classic Wi-Fi. Its stated uses are signal identification, replay feasibility studies in shielded labs, and wireless protocol analysis.

By default the skill has the agent work passively. It starts by receiving and identifying a signal, then moves to demodulation and analysis, and only then considers lab reproduction. The agent is also directed to ask about legal authorization and scope first, and to focus its conclusions on whether a device could be controlled without authorization and on hardening recommendations.

  • Identify a signal's centre frequency and modulation
  • Analyse signals with tools such as GNU Radio, URH and Inspectrum
  • Decode protocols such as ADS-B aircraft broadcasts
  • Assess whether a recorded signal could be replayed, inside a shielded lab only
  • Recommend hardening measures for your own wireless sensors or remote controls

How to install the radio-sdr skill

There are two ways to add the skill. You can download the skill ZIP from this page and unzip it into your personal skills folder at ~/.claude/skills/, or into a project's .claude/skills/ folder if you want the skill available only in that project.

If you use the Claude apps, you can instead upload the skill under Settings, then Capabilities, then Skills.

  • Personal install: unzip the downloaded file into ~/.claude/skills/
  • Project install: unzip the downloaded file into the .claude/skills/ folder of your project
  • Claude apps: go to Settings, then Capabilities, then Skills, and upload the skill

How to trigger the skill with natural requests

You do not need a special command. Describe the research task in ordinary language and mention the radio context, such as the signal type, the hardware you have, or the protocol you want to understand. The skill's description covers authorized RF/SDR work, signal identification, shielded-lab replay feasibility and wireless protocol analysis outside Wi-Fi.

Say upfront that the work is authorized and describe the scope. The skill asks about this anyway, and a clear scope lets the agent give a more useful answer.

  • Identify the centre frequency and modulation of this recording from my RTL-SDR capture
  • Help me decode the ADS-B messages in this capture using a receive-only workflow
  • Assess whether this recorded remote-control signal could be replayed in my shielded lab, under my written authorization
  • Walk me through analysing this signal in URH, step by step

What you need before you start

The skill expects compliant SDR hardware. The source names RTL-SDR and HackRF as examples and says the hardware must be compliant. For analysis software it names URH, GNU Radio and Inspectrum.

The most important requirement is not technical. The skill says any testing needs a written authorization or scope document. The file refers to this document but does not supply a template, so you must have your own. The skill also warns that spectrum use is strictly controlled, so you need to know the radio regulations where you work.

  • SDR hardware such as RTL-SDR or HackRF
  • Analysis software: URH, GNU Radio or Inspectrum
  • A written authorization or scope document covering devices, frequency bands and whether transmission is allowed
  • Knowledge of your local radio regulations

Safety notes: scripts, network and transmission

The skill does not run scripts and does not use the network, according to its listing. Its default is receive-only work. Transmission is allowed only in a shielded enclosure with a written authorization reference, and the skill says it must not be used to interfere with public communications or to transmit without authorization.

The skill also avoids protected bands such as aviation and emergency frequencies, and treats some findings as sensitive. Its lab rules say evidence should not publish unredacted frequency and location combinations where those are sensitive.

  • Default is RX only: receive and analyse, do not transmit
  • Transmission only inside a shielded enclosure with an authorization reference
  • Avoid protected bands such as aviation and emergency services
  • Do not publish unredacted frequency and location combinations where they are sensitive
  • Attacks on Wi-Fi and industrial control systems are routed to other skills, not this one

Tips for getting useful results

Start with capture and identification before asking for replay work. The skill's workflow moves from receive-only identification to analysis to lab reproduction, and the agent follows that order. Give the agent the exact hardware and software you are using so its steps match your setup.

Frame conclusions around defence. Ask what a finding means for hardening your own device, because the skill is built to focus results on that question.

  • Begin with receive-only identification of frequency and modulation
  • Name your hardware and analysis tool so instructions match your setup
  • Ask for hardening recommendations alongside any technical findings
  • For Wi-Fi or industrial control systems, use the separate skills the file points to

What people use it for

  • Identifying the centre frequency and modulation of a recorded signal from an RTL-SDR capture
  • Decoding ADS-B aircraft broadcasts in a receive-only workflow
  • Studying whether a recorded remote-control signal could be replayed in a shielded lab under written authorization
  • Assessing the wireless sensors or remote controls of your own products and recommending hardening measures
  • Learning how URH, GNU Radio and Inspectrum are used for signal analysis

Frequently asked questions

How do I install the radio-sdr skill?

Download the skill ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps, you can instead upload it under Settings, then Capabilities, then Skills.

Is the radio-sdr skill free?

The skill is published under the MIT licence, as listed on this page. The licence terms are the authority on what you may do with it, so read them before reuse.

Do I need SDR hardware to use this skill?

Yes, for hands-on work. The skill expects compliant SDR hardware, and it names RTL-SDR and HackRF as examples. You also need analysis software such as URH, GNU Radio or Inspectrum.

Can the skill transmit or replay signals over the air?

No. The skill is for receive-only analysis by default. Replay feasibility work is limited to shielded labs with written authorization, and transmitting on the air or interfering with public communications is outside its scope.

Does this skill cover Wi-Fi hacking or industrial control systems?

No. The skill focuses on general SDR RF work outside classic Wi-Fi. Wi-Fi attacks are routed to a separate wifi-wireless skill, and industrial control systems are routed to a separate ot-ics skill.

The agent does not seem to use the skill. What should I check?

The source does not list troubleshooting steps. Check that the skill folder is in ~/.claude/skills/ or the project's .claude/skills/ folder, or that it was uploaded under Settings, then Capabilities, then Skills. Then phrase your request around the radio task, such as signal identification or protocol analysis.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use this skill if you are a security researcher, student or engineer doing authorized, receive-only RF analysis in a lab or on your own wireless products, and you have written authorization for the work. Pick something else if you need to transmit on the air, attack Wi-Fi or industrial control systems, or work without authorization or knowledge of local radio rules.

Download the skill