Agent Skills

Agent Skills let you interact with Simplifyd Cloud — deploying services, managing variables, checking logs, and more — without leaving your AI coding assistant.

What are agent skills?

Agent Skills are an open format for extending AI coding assistants with specialised knowledge and capabilities. They follow the Agent Skills specification.

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

• Metadata — Name and description in YAML frontmatter, used by the AI to decide when to invoke a skill
• Instructions — Step-by-step guidance telling the AI exactly how to complete a task
• Examples — Concrete examples of expected behaviour and error handling

When you ask your assistant something like "deploy my api service" or "list the services in staging", it automatically selects the right skill and follows its instructions — running edge CLI commands on your behalf.

Supported tools

• Claude Code
• OpenAI Codex
• OpenCode
• Cursor

Installation

curl -fsSL https://console.cloud.simplifyd.com/skills.sh | bash

npx skills add simplifyd-com/cloud-skills

After installation, each skill is placed in your tool's skills directory and activated automatically.

Skills

Context & status

Status

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

Invoke when you ask:

"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.

Invoke when you ask:

"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.

Invoke when you ask:

"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.

Invoke when you ask:

"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.

Invoke when you ask:

"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.

Invoke when you ask:

"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, and deletes services. Also manages ingress rules (domains and ports).

Invoke when you ask:

"List my services" · "Create a Docker service" · "Add a Postgres database" · "Scale to 3 replicas" · "Delete the worker service"

# List
edge service list --json

# Create Docker service
edge service create \
  --name api \
  --type docker \
  --image node:20 \
  --vcpus 1 \
  --memory 512 \
  --replicas 2

# Create managed Postgres
edge service create --name db --type postgres

# Update
edge service update api --replicas 3

# Delete
edge service delete api

Supported service types:

Deploy

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

Invoke when you ask:

"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 via SSE. Useful for watching a deploy in progress or debugging failures.

Invoke when you ask:

"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

Variables

Lists, sets, and deletes environment variables at the environment level or scoped to a specific service.

Invoke when you ask:

"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

Answers questions about Simplifyd Cloud features, capabilities, how things work, and available plans.

Invoke when you ask:

"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 answers from embedded documentation about the platform.

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:20 --vcpus 1 --memory 512

# 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 — your AI assistant can handle the full sequence when you describe what you want in plain language.

Further reading