Agent Skills

Agent Skills provide task guides for working with Simplifyd Cloud through the edge CLI.

What are agent skills?

Agent Skills are markdown files that package task-specific instructions for supported developer tools. They follow the Agent Skills specification.

Skills are markdown files (SKILL.md) that contain:

• Metadata — Name and description in YAML frontmatter
• Instructions — Step-by-step guidance for completing a task
• Examples — Concrete examples of expected behaviour and error handling

Supported tools use these files to map requests to the right edge CLI commands.

Supported tools

• Claude Code
• OpenAI Codex
• OpenCode
• Cursor

Installation

Install the Simplifyd Cloud skills from the public GitHub repository with the skills CLI:

npx skills add simplifyd-systems/cloud-skills

Re-running this command updates an existing installation. After installation, each skill is placed in the appropriate skills directory for your tool.

The Simplifyd Cloud plugin currently includes 11 skills:

Skills

Context & status

Status

Checks the current CLI context — authenticated user, active workspace, project, and environment.

Examples:

"What workspace am I in?" · "Am I logged in?" · "Show me the current context" · "edge status"

edge status --json

Authentication

Auth

Manages authentication with Simplifyd Cloud. Handles login, logout, and showing the current user.

Examples:

"Log me in" · "Log out" · "Who am I logged in as?" · "Authenticate"

edge auth login
edge auth whoami --json
edge auth logout

Token

Creates, lists, and deletes API tokens for CI/CD pipelines and programmatic access.

Examples:

"Create an API token" · "I need a token for my pipeline" · "Rotate my token" · "List my tokens"

edge token create --name "CI Production"
edge token list --json
edge token delete <id>

Infrastructure

Workspace

Lists, creates, and switches between workspaces. Also manages workspace members and resource usage.

Examples:

"List my workspaces" · "Create a workspace" · "Switch to the acme workspace" · "Show workspace usage"

edge workspace list --json
edge workspace create --name "My Team"
edge workspace use <slug>
edge workspace usage

Project

Lists, creates, and switches between projects within a workspace.

Examples:

"List my projects" · "Create a project" · "Switch to the backend project"

edge project list --json
edge project create --name "backend"
edge project use <slug>

Environment

Lists, creates, and switches between environments within a project. Also handles directory linking.

Examples:

"List environments" · "Create a staging environment" · "Switch to production" · "Link this directory"

edge env list --json
edge env create --name staging
edge env use production
edge link --workspace my-team --project backend --env production

Service operations

Service

Creates, lists, inspects, updates, configures, connects to, and deletes services. Also manages ingress rules, config mounts, pending changesets, and shell access.

Examples:

"List my services" · "Create a Docker service" · "Add a Postgres database" · "Add Redis" · "Open a shell" · "Delete the worker service"

# List
edge service list --json

# Create Docker service
edge service create \
  --name api \
  --type docker \
  --image node \
  --tag 20

# Create managed Postgres
edge service create --name db --type postgres --storage 20 --mode standalone

# Create managed Redis
edge service create --name cache --type redis --storage 10 --mode standalone

# Update
edge service update api --memory 1024

# Review pending changes
edge service changeset api

# Open a shell
edge service shell api

# Delete
edge service delete api

Supported service types:

Common service commands:

edge service get api --json
edge service update api --vcpus 500
edge service update api --memory 1024
edge service update api --image sdcr.io/my-registry/api:2.0
edge service ingress add api --protocol HTTP --port 8080
edge service config add api --name app-config --mount-path /app/config.json --file ./config.json

Deploy

Deploys, redeploys, and stops services. Also shows deployment history.

Examples:

"Deploy my api" · "Redeploy" · "Stop the worker" · "List deployments" · "What's the deployment status?"

edge deploy up api        # deploy or redeploy
edge deploy down api      # stop the service
edge deploy list --json   # deployment history

Monitoring & debugging

Logs

Streams real-time logs from a service deployment. Useful for watching a deploy in progress or debugging failures.

Examples:

"Show me the logs" · "Tail the logs" · "Why is it failing?" · "Watch the deployment"

edge deploy logs api
edge deploy logs api --follow
edge deploy logs api --deployment <dep-slug>

Configuration

Registry

Pushes local Docker images to the Simplifyd Cloud workspace registry.

Examples:

"Push this image" · "Publish my Docker image" · "Use my local image" · "Push to sdcr.io"

# Push a local image
edge registry push myapp:latest --json

# Use the returned image in a service
edge service update api --image sdcr.io/<registry-name>/myapp:latest
edge deploy up api

Variables

Lists, sets, and deletes environment variables at the environment level or scoped to a specific service. Setting an existing variable updates it, and deletion accepts a variable name or slug.

Examples:

"Set DATABASE_URL" · "Add an API key" · "List my env vars" · "Delete OLD_VAR" · "Configure my service with secrets"

# List
edge variables list --json

# Set (environment-level)
edge variables set NODE_ENV=production DATABASE_URL="postgres://..."

# Set (service-level)
edge variables set --service api PORT=8080

# Delete
edge variables delete OLD_VAR

Variable scopes:

Learning & docs

Simplifyd Docs

Provides reference material about Simplifyd Cloud features, capabilities, and plans.

Examples:

"What is Simplifyd Cloud?" · "What service types are supported?" · "How does billing work?" · "What regions are available?"

This skill does not run CLI commands; it provides reference information from the bundled documentation.

Typical workflow

Here is a complete example from scratch to a running service:

# 1. Authenticate
edge auth login

# 2. Set context
edge workspace use my-team
edge project use backend
edge env use production

# 3. Create service
edge service create --name api --type docker --image node --tag 20

# 4. Configure
edge variables set NODE_ENV=production DATABASE_URL="postgres://..."

# 5. Deploy
edge deploy up api

# 6. Watch logs
edge deploy logs api --follow

Each step above maps to a dedicated skill.

Further reading