skills.rest
TylerSimons1127
TylerSimons1127COMMUNITY
Explore all skills by this author →
GitHub

kali-wsl2-ops

Builds, maintains, and recovers a Kali Linux WSL2 penetration testing lab environment.

Updated Aug 21, 2026
Search Tags:#troubleshooting#postgresql#penetration testing#MCP servers#wsl2#Metasploit#kali linux
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill kali-wsl2-ops-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kali-wsl2-ops
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/security/kali-wsl2-ops
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill kali-wsl2-ops-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running a Kali Linux pentest toolkit inside WSL2 on a small Windows drive leads to recurring failures: apt I/O errors from disk pressure, hung WSL daemons, broken Metasploit database connections, and friction wiring security MCP servers into the Hermes agent. This Skill provides the operational runbook to install, recover, and keep that environment healthy. ## Core Features & Use Cases - Disk-Pressure Recovery: Step-by-step procedure to clear Windows temp and npm caches, restart the WSL service, and verify free space before large apt batches. - Metasploit Database Repair: Commands to restart the PostgreSQL cluster, recreate the msf database, regenerate database.yml, and verify connectivity from msfconsole. - MCP Security Server Registration: Instructions for building cyproxio/mcp-for-security servers (nmap, sqlmap, ffuf, nuclei, and more) and exposing them to Hermes via a Windows launcher batch file. - Use Case: After apt fails with "Input/output error" mid-install on a 250 GB C: drive, follow the recovery sequence to free space, restart WSL, and resume the toolkit installation in small batches. ## Quick Start Ask the agent to recover the Kali WSL2 environment after apt I/O errors and verify the Metasploit database connection. ## Notes WSL2 has hard limits: no wireless, USB, monitor mode, or packet injection, so WiFi tooling like aircrack-ng cannot see real networks. The companion skill ethical-pentest-kali covers engagement workflow and the scope/consent gate; this Skill covers environment mechanics only.

Frequently Asked Questions about kali-wsl2-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix apt Input/output error in Kali WSL2?▼

Apt I/O errors in Kali WSL2 usually mean the Windows disk is nearly full. Shut down WSL, clear C:\Windows\Temp, the user Temp folder, and the npm-cache directory from elevated PowerShell, then confirm more than 10 GB free before retrying the install.

How to fix Metasploit database no connection error in Kali?▼

Metasploit db connection failures in WSL2 Kali are fixed by starting the PostgreSQL cluster with pg_ctlcluster, resetting the msf user password, recreating the msf database, and rewriting the database.yml config file. Verify with msfconsole db_status showing Connected to msf.

How do I register an MCP security server in Hermes?▼

Build the cyproxio mcp-for-security server with its build.sh script, create a Windows mcp-launch.bat that calls wsl.exe with the server path, then add an entry under mcp_servers in the Hermes config.yaml. Confirm registration with hermes mcp catalog.

Can Kali WSL2 do wireless attacks with aircrack-ng?▼

No, Kali in WSL2 cannot perform wireless attacks because WSL2 has no wireless, USB, monitor mode, or packet injection support. Tools like aircrack-ng, wifite, and reaver install but cannot see real WiFi; live wireless work needs native Linux with an Alfa AWUS036ACM adapter.

Why do WSL commands time out with distros showing Stopped?▼

WSL timeouts with stopped distros indicate a hung WSL daemon. Restart it from an admin prompt with net stop WSLService followed by net start WSLService, or reboot the machine if the service restart does not recover the environment.

Related Skills

Explore More Software Engineering Skills→
louzhengshuailouzhengshuai

deepscientist-windows-wsl-setup

Set up DeepScientist on Windows with WSL2 and Codex authentication.

Community
Advanced
xalgordxalgord
954

performing-external-network-penetration-test

Conducts external network penetration tests using PTES methodology from reconnaissance through reporting.

Community
Advanced
davila7davila7
30.5k

Ethical Hacking Methodology

Guides authorized penetration testing from reconnaissance through exploitation to professional reporting.

Community
Intermediate
xalgordxalgord
954

performing-wifi-password-cracking-with-aircrack

Captures WPA/WPA2 handshakes and cracks wireless passphrases offline using aircrack-ng and hashcat.

Community
Intermediate