← Back to Skills Marketplace
117
Downloads
0
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install consul-deregister
Description
Consul service deregistration tool. Triggered when users mention Consul deregister, remove service instance, service removal, or offline. Supports batch dere...
README (SKILL.md)
Consul Service Deregister
Deregister service instances from Consul via the HTTP API.
Usage
Mode 1: Service ID + Agent List (Most Common)
User: Deregister service my-service-id on consul-agent-1, consul-agent-2, and consul-agent-3
AI executes:
python3 /Users/shiheng/.qclaw/workspace/skills/consul-deregister/scripts/deregister.py \
--service-id my-service-id \
--agents http://\x3CCONSUL_HOST_1>:8500 http://\x3CCONSUL_HOST_2>:8500 http://\x3CCONSUL_HOST_3>:8500
Mode 2: Paste Raw curl Commands (Easiest)
User pastes existing curl commands, AI parses and replays them:
User: Execute these deregister commands:
curl -XPUT http://\x3CCONSUL_HOST_1>:8500/v1/agent/service/deregister/\x3CSERVICE_ID>
curl -XPUT http://\x3CCONSUL_HOST_2>:8500/v1/agent/service/deregister/\x3CSERVICE_ID>
AI executes:
python3 /Users/shiheng/.qclaw/workspace/skills/consul-deregister/scripts/deregister.py \
--from-curl "curl -XPUT http://\x3CCONSUL_HOST>:8500/v1/agent/service/deregister/\x3CSERVICE_ID> ..."
Mode 3: Read Agent List from File
python3 /Users/shiheng/.qclaw/workspace/skills/consul-deregister/scripts/deregister.py \
--service-id my-service-id \
--agents-file ./agents.txt
agents.txt format (supports # comments):
# Consul Agent node list
\x3CCONSUL_HOST_1>:8500
\x3CCONSUL_HOST_2>:8500
\x3CCONSUL_HOST_3>:8500
Dry-Run Preview
Add --dry-run to any mode to preview the requests without actually sending them:
python3 /Users/shiheng/.qclaw/workspace/skills/consul-deregister/scripts/deregister.py \
--service-id my-service-id \
--agents http://\x3CCONSUL_HOST_1>:8500 http://\x3CCONSUL_HOST_2>:8500 \
--dry-run
With ACL Token
python3 /Users/shiheng/.qclaw/workspace/skills/consul-deregister/scripts/deregister.py \
--service-id my-service-id \
--agents http://\x3CCONSUL_HOST>:8500 \
--token your-consul-acl-token
Common Workflows
Scenario 1: Batch Deregister Gray Nodes User provides a service ID and multiple IP:port pairs.
Scenario 2: Release Rollback User triggers rollback; AI finds the old version's service ID from config/docs and deregisters.
Scenario 3: Service Migration Moving a service from old cluster to new cluster — deregister from all old cluster nodes first.
Notes
service-idmust exactly match the ID registered in Consul (no extra spaces)- Agent addresses accept both
host:portand full URL (http://host:port) — auto-completed - Parallel requests by default (up to 10 concurrent), automatic speedup for many nodes
- Non-zero exit code on any failure; AI will surface failure details
- Use
--jsonfor JSON output suitable for scripting / pipeline integration
Usage Guidance
This skill appears coherent and implements Consul service deregistration as described, but deregistration is a destructive operation. Before using it: (1) run with --dry-run to verify target URLs and service IDs; (2) double-check the list of agents (agents file or pasted curl commands) to avoid accidental broad impact; (3) never paste production ACL tokens into untrusted contexts — provide tokens only when necessary and prefer short-lived tokens scoped to deregistration if your environment supports them; (4) be aware the script will send PUT requests to arbitrary host:port addresses you supply, so confirm network targets are correct; (5) if you want extra assurance, review or run the included scripts/deregister.py locally in a test environment before using in production.
Capability Analysis
Type: OpenClaw Skill
Name: consul-deregister
Version: 1.0.4
The 'consul-deregister' skill is a utility designed to deregister service instances from Consul agents via the HTTP API. The Python script (scripts/deregister.py) uses the standard library's urllib to send PUT requests and includes features like parallel execution, dry-run mode, and ACL token support. No evidence of data exfiltration, malicious execution, or prompt injection was found; the code logic strictly follows the stated purpose of managing Consul services.
Capability Assessment
Purpose & Capability
The name/description match the included Python script and SKILL.md. The script implements Deregister via Consul's /v1/agent/service/deregister endpoint and supports the documented modes (service-id + agents, parse curl, agents file, dry-run, ACL token, parallel execution). Nothing requested or installed is unrelated to Consul deregistration.
Instruction Scope
Instructions explicitly tell the agent to run the bundled Python script and describe reading an agents file or parsing curl text — all within the scope of deregistration. Minor caveat: example commands reference a user-specific absolute path (/Users/shiheng/.qclaw/...), which may not match the runtime environment; the agent should run the skill's script from the correct workspace path. The skill will also accept arbitrary agent addresses and ACL tokens and will send HTTP requests to them (expected but potentially destructive if used incorrectly).
Install Mechanism
No install spec or external downloads — instruction-only with a small included script. There are no external packages or network-based installers to review.
Credentials
No required environment variables or declared credentials. The script accepts an optional --token argument for Consul ACL tokens (documented). The requested inputs are proportional to the stated function — no unrelated secrets or services are requested.
Persistence & Privilege
Skill is not always-enabled and does not request persistent or elevated platform privileges. It does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install consul-deregister - After installation, invoke the skill by name or use
/consul-deregister - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
Clean description with no Chinese text remaining.
v1.0.3
Full English localization for international audience.
v1.0.2
Remove real IPs from examples, use placeholder tokens instead.
v1.0.1
Remove real IPs from examples, use placeholder tokens instead.
v1.0.0
Initial release: batch deregister Consul service instances by ID or curl commands, supports dry-run, parallel execution, and ACL tokens.
Metadata
Frequently Asked Questions
What is Consul Service Deregister?
Consul service deregistration tool. Triggered when users mention Consul deregister, remove service instance, service removal, or offline. Supports batch dere... It is an AI Agent Skill for Claude Code / OpenClaw, with 117 downloads so far.
How do I install Consul Service Deregister?
Run "/install consul-deregister" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Consul Service Deregister free?
Yes, Consul Service Deregister is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Consul Service Deregister support?
Consul Service Deregister is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Consul Service Deregister?
It is built and maintained by strongant (@strongant); the current version is v1.0.4.
More Skills