digital-ocean_skill

Overview

This skill manages DigitalOcean droplets, domains, and infrastructure using the DigitalOcean API. It provides command-line helpers and curl examples to inspect account details, list resources, create droplets, and perform droplet actions like reboot or power on/off. It requires a DO_API_TOKEN with the appropriate scopes configured as an environment variable. The skill is focused on practical management tasks and automation-friendly operations.

How this skill works

The skill uses the DigitalOcean REST API and simple Python CLI wrappers to call endpoints for droplets, domains, records, and account information. Common operations are exposed as scripts (list droplets, get droplet details, manage power state) and as direct curl examples for immediate integration into shell scripts. Actions that change state (create, reboot, power-off) require a token with read/write permissions and should be confirmed before execution.

When to use it

• When you need to list or inspect all droplets and their public IPs quickly.
• When you need to automate droplet lifecycle tasks (create, reboot, power on/off) from scripts or CI pipelines.
• When managing DNS domains and records hosted on DigitalOcean.
• When you want quick account info or to validate API access and token scopes.
• When you need reproducible curl examples to integrate into tooling or monitoring.

Best practices

• Store DO_API_TOKEN in environment variables, not in code or version control.
• Use tokens scoped to the minimum required permissions (read-only for inspection, read/write for management).
• Confirm destructive operations (power-off, destroy) interactively or via explicit flags in automation.
• Rate-limit or back off on repeated API calls to avoid hitting API limits.
• Log API responses and action IDs to correlate operations with DigitalOcean account activity.

Example use cases

• Inventory all droplets and export their IDs, names, status, and public IPs for an asset report.
• Automate nightly backups by creating a droplet snapshot via API calls in a CI job.
• Provision a new test droplet from a script using the create-droplet curl example.
• Restart or power-cycle unresponsive droplets from a maintenance script.
• Add or update domain records when deploying services that require DNS changes.