← Back to Skills Marketplace
Runcloud Skill
by
Nesho Sabakov
· GitHub ↗
· v1.0.0
· MIT-0
162
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install runcloud
Description
Query Runcloud servers, databases, web apps, services, cronjobs, deployments, and health via the Runcloud API v3. Trigger when the user mentions Runcloud, wa...
Usage Guidance
This skill appears to be what it says: a Runcloud API helper that uses curl + jq. Before installing: 1) Only provide a Runcloud API token you trust — it grants workspace-wide access; prefer a token with the least privileges possible and rotate it if needed. 2) Confirm jq is available on any environment where the skill will run. 3) Be aware the skill includes examples of POST actions (deploy, restart service, enable SSL); those change server state — require explicit confirmation/authorization before running on production. 4) Don’t store the token in public or shared repo files; use secure environment configuration. 5) If you do not want autonomous agents to perform changes, avoid giving the agent broad permissions or restrict when it can invoke skills that perform write actions.
Capability Analysis
Type: OpenClaw Skill
Name: runcloud
Version: 1.0.0
The runcloud skill is a well-documented integration for managing Runcloud servers via their official API v3. It uses standard tools like curl and jq to perform read-only queries and safe management actions (e.g., service restarts, deployments), while explicitly omitting destructive operations like resource deletion or password changes in SKILL.md.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (Runcloud API queries and safe actions) align with required items: jq (for output formatting) and RUNCLOUD_API_TOKEN (needed to authenticate to the Runcloud API). No unrelated binaries or credentials are requested.
Instruction Scope
SKILL.md provides explicit curl commands against manage.runcloud.io and lists both read endpoints and several 'non-destructive' POST actions (deploy, restart service, test cronjob, enable Let's Encrypt). These instructions stay within Runcloud's domain and repeatedly warn to confirm before running writes, but they do provide examples of actions that change server state — operator confirmation is advised before performing those. The doc also shows exporting RC and AUTH variables (examples) even though only RUNCLOUD_API_TOKEN is declared required; this is a minor documentation vs. metadata mismatch.
Install Mechanism
Instruction-only skill with no install spec and no code files. It requires the jq binary to be present on PATH; this is reasonable for command-line JSON formatting. No remote downloads or archive extraction are used.
Credentials
Only one required environment variable is declared: RUNCLOUD_API_TOKEN — which is appropriate for an API-driven Runcloud skill. However, the token grants full workspace access per the notes in SKILL.md, so it is a high-value secret; ensure the token is scoped appropriately and treated like a password.
Persistence & Privilege
always:false and user-invocable:true (default) — the skill is not force-included and requires invocation. disable-model-invocation is false (normal), so an agent could autonomously call the skill if allowed; this is platform-default behavior and not itself a coherence issue.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install runcloud - After installation, invoke the skill by name or use
/runcloud - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Runcloud skill.
- Query servers, web apps, databases, cronjobs, deployments, users, and health via Runcloud API v3.
- Retrieve stats, hardware info, services, SSL certificates, supervisor jobs, and domains.
- Trigger safe actions: deploy web apps, restart services, test cronjobs, issue Let's Encrypt SSL.
- Provides bash/curl+jq usage examples for all common operations.
- Requires an API token and jq for outputs. No destructive operations exposed.
Metadata
Frequently Asked Questions
What is Runcloud Skill?
Query Runcloud servers, databases, web apps, services, cronjobs, deployments, and health via the Runcloud API v3. Trigger when the user mentions Runcloud, wa... It is an AI Agent Skill for Claude Code / OpenClaw, with 162 downloads so far.
How do I install Runcloud Skill?
Run "/install runcloud" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Runcloud Skill free?
Yes, Runcloud Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Runcloud Skill support?
Runcloud Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Runcloud Skill?
It is built and maintained by Nesho Sabakov (@neshable); the current version is v1.0.0.
More Skills