Guide · Agent skill
Evil Twin Wi-Fi Attacks agent skill: install and use it safely
Updated · written with AI from the project's own documentation and checked against our catalogue data
The offensive-evil-twin skill is a methodology file for an AI agent. It describes how a rogue Wi-Fi access point can imitate a real network so nearby devices connect to it, and it is written as an offensive security playbook. This page explains what the skill covers, how to install it, what it needs, and the authorization and safety limits that apply. It does not reproduce the attack procedures or commands, because those are only appropriate inside a written engagement.
Quick start
- 1Download the ZIP. Get the offensive-evil-twin ZIP from this directory page.
- 2Unzip into a skills folder. Extract it into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project.
- 3Or upload it in the Claude apps. Open Settings, go to Capabilities, then Skills, and upload the ZIP.
- 4Confirm your authorization. Have the written scope and permission for the target network before you begin.
- 5Ask for planning help. Describe the authorized engagement and the outcome you need, such as a test plan or report section.
- 6Review outputs against scope. Check every suggestion against your rules of engagement before acting on it.
What the skill makes the agent do
The skill covers a family of rogue access point techniques: Evil Twin, KARMA, Mana, Known Beacons and captive portal pages. It also covers deauthentication used to push clients off a legitimate network, traffic interception after a device connects, and detection-evasion tactics. The source frames these as ways to coerce client devices onto an attacker-controlled access point, intercept their traffic, harvest credentials or deliver payloads.
Because the content is attack-oriented, the value of the skill for a legitimate tester is mainly in organizing a wireless assessment: reviewing which techniques are in scope, which tools the engagement names, and how results should be documented. The skill names tools such as hostapd, wifiphisher, airgeddon, eaphammer, bettercap and aireplay-ng.
Install the skill (ZIP or Claude app upload)
Download the skill ZIP from the directory page, then either unzip it into your personal skills folder at ~/.claude/skills/ or into a project's .claude/skills/ folder. The skill package contains a single file, SKILL.md.
You can also upload the ZIP in the Claude apps under Settings, then Capabilities, then Skills.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project folder
- Claude apps: Settings, Capabilities, Skills, then upload
What you need before using it
The source lists a Linux system with a wireless adapter that supports monitor and AP mode, plus several tools: hostapd, hostapd-mana, dnsmasq, iptables, the aircrack-ng suite, wifiphisher, airgeddon, eaphammer, mitmproxy, bettercap, hcxdumptool and Flask for Python. The skill itself runs no scripts and makes no network requests. Any real activity happens through tools you install and run yourself.
Hardware and tooling are not the main requirement. A signed scope document from the network owner is.
- Linux machine with a suitable wireless adapter
- Only the tools listed in the source, installed by you
- Own lab equipment, or written permission for the target network
How to trigger the skill with natural requests
Agents load a skill when your request matches its description. For this skill, the most useful requests are about planning and reviewing an authorized assessment, not about running attacks against a specific network. Name the engagement, the scope and the permission you hold.
Expect the agent to ask about authorization and scope before giving detailed guidance. That is intended behaviour for this kind of material.
- Help me write the rules of engagement for an approved wireless assessment of our office network.
- Summarize which evil twin variants a red team should consider when testing whether staff devices auto-connect to unknown networks.
- Draft a test plan and reporting template for a wireless engagement that we have written permission to run.
- List the detection signals a rogue access point test should document, for a lab built on our own equipment.
Safety, scope and legal limits
Use this skill only on networks you own or have written permission to test. The source itself says that targeting public, cafe, hotel or corporate Wi-Fi without permission is illegal interception and credential theft in most jurisdictions. Casual use to pick up other people's logins is outside the intended use.
Keep any lab completely isolated from real networks and real users. Record the scope, the authorization, the time windows and what was captured, and handle any captured credentials under your engagement's data rules.
- Get written authorization that names the networks, devices and dates
- Test only your own lab or the approved target
- Do not connect rogue equipment to public or third-party networks
- Document and delete captured data as the engagement requires
Tips for getting value from the skill
Ask for planning output rather than step-by-step attack execution. Good outputs include scope checklists, risk notes, defensive recommendations and report sections. If you are a defender, the source notes it is weighted toward attacker techniques and does not explain detection in depth, so pair it with dedicated wireless intrusion detection documentation.
- Start every request with the engagement name and authorization
- Ask for reporting and remediation advice alongside findings
- Pair with your organization's wireless security policy
What people use it for
- Drafting the rules of engagement and scope document for an approved wireless assessment
- Building a test plan that covers which device classes and networks are in scope
- Writing report sections that explain rogue access point risk to non-specialist managers
- Preparing a lab exercise for security students using their own equipment
Frequently asked questions
How do I install the offensive-evil-twin skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into .claude/skills/ in a project. You can also upload the ZIP in the Claude apps under Settings, Capabilities, then Skills.
Is the offensive-evil-twin skill free?
The skill is published under the MIT licence, as stated on this page. Check the licence file in the source repository for the full terms.
What do I need to use it?
The source lists a Linux system with a wireless adapter that supports monitor and AP mode, plus tools such as hostapd, dnsmasq, aircrack-ng, wifiphisher and bettercap. The skill itself runs no scripts and makes no network requests.
Is it legal to run an evil twin attack?
Only on networks you own or have written permission to test. The source states that attacking public or corporate Wi-Fi without permission is illegal interception in most jurisdictions.
What are alternatives to this skill?
For a wireless assessment, you can use the tools the skill names directly, such as wifiphisher or airgeddon, with your own documentation. For defensive work, look for wireless intrusion detection guides, since this skill focuses on attacker techniques.
Why won't the skill give me full attack commands here?
This page does not reproduce operational attack steps. Outside a written, authorized engagement those steps cause real harm, so the agent should ask about scope before giving detailed guidance.
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
This skill suits authorized penetration testers and red teams who need help planning a wireless engagement, and students working in their own lab. It is a poor choice for anyone without written permission to test a network, and for defenders who want a detection guide, since it focuses on attacker techniques.
Download the skill