xcloud-agent-skills

Imported from xCloudDev/xcloud-agent-skills (SKILL.md). Install upstream with npx skills add xCloudDev/xcloud-agent-skills. Copyright stays with the author.

xCloud Agent Skills v4.3.0

Version MCP License xCloud ClawHub OpenClaw

Built for xCloud hosting operators by xCloud · GitHub · MCP Docs · User Guide · Install Guide · API Docs · OpenClaw Tutorial · Tutorial Video · Security Notes

Security notice: agent-only xCloud operations toolkit. This package contains skill routing instructions, reference docs, and a small bash/curl wrapper. It ships no API tokens and only calls the xCloud API after a user or agent explicitly invokes a skill — via the OAuth-connected xCloud MCP server (recommended) or with XCLOUD_API_TOKEN configured.

This root skill describes the official xCloud Public API plugin bundle for agent marketplaces such as ClawHub and skills.mp.com.

The runnable skills live under plugins/xcloud/skills/ and are invoked as:

• xcloud:deploy
• xcloud:servers
• xcloud:sites
• xcloud:wordpress
• xcloud:ssl
• xcloud:billing
• xcloud:account

What It Provides

Use this package when an agent needs to operate xCloud hosting infrastructure. It pairs with the xCloud MCP server (https://app.xcloud.host/mcp — one native tool per authenticated Public API operation plus xcloud_agent_search and xcloud_docs_search, a five-tool compact profile, OAuth, per-action confirmation on destructive operations) and falls back to the bundled REST wrapper on agents without MCP support:

• Deploy any GitHub, GitLab or Bitbucket URL end to end — detect the app, preview with a dry run, ask once, provision, poll, verify the live URL — and diagnose and retry a failed deploy on the same site
• Deploy Docker Compose and Dockerfile apps, install one-click apps (Ghost, Uptime Kuma, Vaultwarden, …), create Git staging environments from a branch, and create WordPress sites
• Buy xCloud-managed servers (plans, prices, regions, provisioning progress); manage services, Node.js and PHP versions, verified reboots, monitoring, firewall rules, fail2ban, sudo users, cron, and DNS checks
• Manage sites, domains, cache, backups (including Docker app backups), staging, rescue workflows, SSH/SFTP, cron jobs, access logs, and safe site deletion
• Manage WordPress health, updates, plugins, themes, vulnerabilities (per site and team-wide), PageSpeed, broken links, WP_DEBUG, and magic-login URLs
• Manage SSL certificates, renewals, custom certificates, certificate status, and Cloudflare certificates
• Read plan, invoices, bills and prices; pay invoices and buy mailboxes or mail delivery — only after explicit approval
• Work across several teams from one connection; read and clear incident alerts; read identity, API tokens, Git and Cloudflare integrations, and WordPress blueprints

Agent Experience

• Every user-facing reply is xCloud branded with a clear header and _via xcloud:*_ footer.
• The first xCloud interaction greets the user and shows the xCloud startup banner once per conversation.
• If no connection is configured, xCloud offers the MCP connector first (OAuth, no secret to store), then falls back to explaining how to create a scoped API token stored in the agent runtime as XCLOUD_API_TOKEN; it does not ask users to paste production tokens into chat by default.
• After setup, xCloud verifies the connection (user_show via MCP, or /health + /user via REST) before continuing operational tasks.

Setup

Recommended — connect the xCloud MCP server (OAuth; no token to store):

claude mcp add xcloud --transport http https://app.xcloud.host/mcp

Then /mcp → Authenticate. Other clients: add a custom connector with URL https://app.xcloud.host/mcp. Docs: https://app.xcloud.host/mcp/docs

REST fallback (agents without MCP support):

Create an xCloud API token from:

https://app.xcloud.host/settings/api-tokens

Then configure your runtime:

export XCLOUD_API_TOKEN="your-token-here"
export XCLOUD_API_BASE_URL="https://app.xcloud.host"

The shared command wrapper is:

"${CLAUDE_PLUGIN_ROOT}"/scripts/xcloud.sh GET /user

Official Links

• xCloud: https://xcloud.host
• MCP docs: https://app.xcloud.host/mcp/docs
• Dashboard: https://app.xcloud.host
• User guide: https://github.com/xCloudDev/xcloud-agent-skills/blob/main/docs/USER_GUIDE.md
• Install guide: https://github.com/xCloudDev/xcloud-agent-skills/blob/main/docs/SKILLS-GUIDE.md
• Official repository: https://github.com/xCloudDev/xcloud-agent-skills
• Development fork: https://github.com/Asif2BD/xcloud-agent-skills
• Public API docs: https://app.xcloud.host/api/v1/docs
• OpenClaw + ClawHub tutorial: https://xcloud.host/openclaw-skills-and-clawhub-on-xcloud-openclaw-agent/
• Tutorial video: https://www.youtube.com/watch?v=oEE9OHo3_48

Safety

This package contains documentation, skill routing instructions, and a small shell wrapper. It does not include real API tokens and does not run API calls during installation. Network requests are made only after a user or agent explicitly invokes an xCloud skill with an API token configured in the environment.