How do I install the Xops Agent skill?

Run npx skillmds@latest add wentf9/xops-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Xops Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Xops Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Xops Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Xops Agent?

wentf9 (@wentf9) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Xops Agent by wentf9 — Agent Skill

Name: Xops Agent
Author: wentf9

Xops Agent

Automate server O&M, execute batch commands, test network connectivity, transfer files, and manage host assets using the XOps CLI toolkit. Triggers when managing server clusters, performing concurrent tasks across multiple machines, checking network ports, or synchronizing configuration files.

wentf9 afb89a3 3.6 KB Updated Sep 17, 2026

File contents

XOps CLI (IT Operations Automation Tool) Skill Guide

This skill empowers you to manage server clusters, execute batch tasks, and perform network security diagnostics via the XOps command-line tool (xops).

🎯 Environment Self-Check & Bootstrap Installation

Before attempting any operations, please run xops --version to check if the tool is installed. If you receive a command not found error, instruct the user to execute the following installation command:

curl -sSL https://raw.githubusercontent.com/wentf9/xops-cli/master/install.sh | bash

🎯 Core Capabilities & Precise Command Usage

1. Host & Asset Management (`xops host`)

Manage the inventory of servers, credentials, and grouping tags.

Initialize Local Configuration and Import OpenSSH Hosts:
```
xops init
```
List All Hosts:
```
xops host list
```
View All Unique Tags:
```
xops host tags
```

Add a New Host:

xops host add --address "192.168.1.10" --user "root" --key ~/.ssh/id_ed25519 --alias "web-01" --tags "web"

Batch Import Hosts from CSV:

xops host import hosts.csv --tag "production"

2. Batch Execution (`xops exec`)

Run commands or local scripts concurrently across multiple targets.

Execute Command via Tag:
```
xops exec --tag "web" -c "uptime"
```

Run Local Script Remotely:

xops exec --tag "db" --shell "./backup.sh" --task 5

3. Distributed File Transfer (`xops scp`)

Transfer files or directories between local and remote hosts.

Upload to Tagged Hosts:

xops scp ./config.conf --tag "web" --dest "/etc/app/"

4. Unified Firewall Management (`xops firewall`)

Abstracts different firewall backends (firewalld, ufw, iptables, nftables).

List Rules for a Host:
```
xops firewall list -H "web-01"
```

Manage Ports:

#open port 80/tcp,81/tcp and reload firewall
xops firewall port 80,81 -H "web-01" --reload
#remove port 80/udp
xops firewall port 80 --remove --proto udp -H "web-01"
#allow port 80/tcp from source 192.168.0.1
xops firewall rule 80 192.168.0.1 -H "web-01"

5. Network & Security Tools

Smart Ping (Supports ICMP and TCP port checks):

xops ping 1.1.1.1           # ICMP
xops ping 1.1.1.1 443       # TCP Port Check

Netcat (nc) (Port scanning):

#listen on local port 8080 and print requests to stdout
xops nc -l 8080
#send "scan me" to local port 8080
echo "scan me" | xops nc 127.0.0.1 8080

DNS Diagnostics:
```
xops dns "google.com"
```

Data Encoding:

xops encode base64 "hello"
xops encode base64 --decode "aGVsbG8="

🛠️ Execution Principles & Safety Guardrails

Host Verification: Before executing batch tasks on a tag, run xops host list to verify which hosts will be affected.
Non-Interactive Preference: Always prefer xops exec and xops scp over xops ssh or xops tui for automation.
High-Risk Operations: You MUST obtain explicit user confirmation via ask_user before running destructive commands (e.g., rm -rf, format, systemctl stop) on multiple hosts.
Credential Protection: NEVER print or log passwords/keys used in xops host add commands.

---name: xops-agentdescription: Automate server O&M, execute batch commands, test network connectivity, transfer files, and manage host assets using the XOps CLI toolkit. Triggers when managing server clusters, performing concurrent tasks across multiple machines, checking network ports, or synchronizing configuration files.---# XOps CLI (IT Operations Automation Tool) Skill GuideThis skill empowers you to manage server clusters, execute batch tasks, and perform network security diagnostics via the XOps command-line tool (`xops`).## 🎯 Environment Self-Check & Bootstrap InstallationBefore attempting any operations, please run `xops --version` to check if the tool is installed.If you receive a `command not found` error, instruct the user to execute the following installation command:```bashcurl -sSL https://raw.githubusercontent.com/wentf9/xops-cli/master/install.sh | bash```## 🎯 Core Capabilities & Precise Command Usage### 1. Host & Asset Management (`xops host`)Manage the inventory of servers, credentials, and grouping tags.- **Initialize Local Configuration and Import OpenSSH Hosts**: ```bash xops init ```- **List All Hosts**: ```bash xops host list ```- **View All Unique Tags**: ```bash xops host tags ```- **Add a New Host**: ```bash xops host add --address "192.168.1.10" --user "root" --key ~/.ssh/id_ed25519 --alias "web-01" --tags "web" ```- **Batch Import Hosts from CSV**: ```bash xops host import hosts.csv --tag "production" ```### 2. Batch Execution (`xops exec`)Run commands or local scripts concurrently across multiple targets.- **Execute Command via Tag**: ```bash xops exec --tag "web" -c "uptime" ```- **Run Local Script Remotely**: ```bash xops exec --tag "db" --shell "./backup.sh" --task 5 ```### 3. Distributed File Transfer (`xops scp`)Transfer files or directories between local and remote hosts.- **Upload to Tagged Hosts**: ```bash xops scp ./config.conf --tag "web" --dest "/etc/app/" ```### 4. Unified Firewall Management (`xops firewall`)Abstracts different firewall backends (firewalld, ufw, iptables, nftables).- **List Rules for a Host**: ```bash xops firewall list -H "web-01" ```- **Manage Ports**: ```bash #open port 80/tcp,81/tcp and reload firewall xops firewall port 80,81 -H "web-01" --reload #remove port 80/udp xops firewall port 80 --remove --proto udp -H "web-01" #allow port 80/tcp from source 192.168.0.1 xops firewall rule 80 192.168.0.1 -H "web-01" ```### 5. Network & Security Tools- **Smart Ping** (Supports ICMP and TCP port checks): ```bash xops ping 1.1.1.1 # ICMP xops ping 1.1.1.1 443 # TCP Port Check ```- **Netcat (nc)** (Port scanning): ```bash #listen on local port 8080 and print requests to stdout xops nc -l 8080 #send "scan me" to local port 8080 echo "scan me" | xops nc 127.0.0.1 8080 ```- **DNS Diagnostics**: ```bash xops dns "google.com" ```- **Data Encoding**: ```bash xops encode base64 "hello" xops encode base64 --decode "aGVsbG8=" ```## 🛠️ Execution Principles & Safety Guardrails1. **Host Verification**: Before executing batch tasks on a tag, run `xops host list` to verify which hosts will be affected.2. **Non-Interactive Preference**: Always prefer `xops exec` and `xops scp` over `xops ssh` or `xops tui` for automation.3. **High-Risk Operations**: You MUST obtain explicit user confirmation via `ask_user` before running destructive commands (e.g., `rm -rf`, `format`, `systemctl stop`) on multiple hosts.4. **Credential Protection**: NEVER print or log passwords/keys used in `xops host add` commands.

Frequently asked questions