# Send Planetscale Cli Skills to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "planetscale-cli-skills",
    "name": "Planetscale Cli Skills",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/vince-winkintel/planetscale-cli-skills",
    "canonicalUrl": "https://clawhub.ai/vince-winkintel/planetscale-cli-skills",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/planetscale-cli-skills",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=planetscale-cli-skills",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "pscale-auth/SKILL.md",
      "pscale-auth/references/commands.md",
      "pscale-backup/SKILL.md",
      "pscale-backup/references/commands.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "planetscale-cli-skills",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T03:17:44.192Z",
      "expiresAt": "2026-05-14T03:17:44.192Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=planetscale-cli-skills",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=planetscale-cli-skills",
        "contentDisposition": "attachment; filename=\"planetscale-cli-skills-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "planetscale-cli-skills"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/planetscale-cli-skills"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/planetscale-cli-skills",
    "downloadUrl": "https://openagent3.xyz/downloads/planetscale-cli-skills",
    "agentUrl": "https://openagent3.xyz/skills/planetscale-cli-skills/agent",
    "manifestUrl": "https://openagent3.xyz/skills/planetscale-cli-skills/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/planetscale-cli-skills/agent.md"
  }
}
```
## Documentation

### PlanetScale CLI Skills

Comprehensive pscale command reference and workflows for managing PlanetScale databases via terminal.

### Overview

The PlanetScale CLI brings database branches, deploy requests, and schema migrations to your fingertips. This skill provides command references, automation scripts, and decision trees for all pscale operations.

### Sub-Skills

CommandSkillUse Whenauthpscale-authLogin, logout, service tokens, authentication managementbranchpscale-branchCreate, delete, promote, diff, list database branchesdeploy-requestpscale-deploy-requestCreate, review, deploy, revert schema changesdatabasepscale-databaseCreate, list, show, delete databasesbackuppscale-backupCreate, list, show, delete branch backupspasswordpscale-passwordCreate, list, delete connection passwordsorgpscale-orgList, show, switch organizationsservice-tokenpscale-service-tokenCreate, manage CI/CD service tokens

### Should I use a branch or deploy request?

What's your goal?
├─ Experimenting with schema changes → Create branch (pscale-branch)
├─ Testing schema in isolation → Create branch (pscale-branch)
├─ Ready to deploy schema to production → Create deploy request (pscale-deploy-request)
└─ Reviewing schema changes before production → Review deploy request (pscale-deploy-request)

### Service token vs password?

What's your use case?
├─ CI/CD pipeline → Service token (pscale-service-token)
├─ Local development → Password (pscale-password)
├─ Production application → Service token (rotatable, secure)
└─ One-off admin task → Password (temporary)

### Direct promotion vs deploy request?

Production readiness?
├─ Immediate promotion (dangerous) → pscale branch promote (pscale-branch)
├─ Review + approval workflow → pscale deploy-request create (pscale-deploy-request)
└─ Safe production deployment → Always use deploy requests

### Schema Migration Workflow

Complete workflow from branch creation to production deployment:

# 1. Create development branch
pscale branch create <database> <branch-name>

# 2. Make schema changes (via shell, ORM, or direct SQL)
pscale shell <database> <branch-name>

# 3. View schema diff
pscale branch diff <database> <branch-name>

# 4. Create deploy request
pscale deploy-request create <database> <branch-name>

# 5. Review and deploy
pscale deploy-request deploy <database> <deploy-request-number>

# 6. Verify deployment
pscale deploy-request show <database> <deploy-request-number>

See scripts/ directory for automation.

### Branch Development Workflow

# Create branch from main
pscale branch create <database> <feature-branch> --from main

# Work on schema changes
pscale shell <database> <feature-branch>

# Check diff before deploying
pscale branch diff <database> <feature-branch>

# Create deploy request when ready
pscale deploy-request create <database> <feature-branch>

### CI/CD Integration

# Create service token for CI/CD
pscale service-token create --org <org>

# Use in CI/CD pipelines (GitHub Actions, GitLab CI, etc.)
export PLANETSCALE_SERVICE_TOKEN_ID=<token-id>
export PLANETSCALE_SERVICE_TOKEN=<token>

# Deploy via CI/CD
pscale deploy-request create <database> <branch> --auto-approve

### Most Common Commands

# Authentication
pscale auth login
pscale auth logout

# Branch management
pscale branch create <database> <branch> [--from <source-branch>]
pscale branch list <database>
pscale branch delete <database> <branch>

# Deploy requests
pscale deploy-request create <database> <branch>
pscale deploy-request list <database>
pscale deploy-request deploy <database> <number>

# Database operations
pscale database create <database> --org <org>
pscale database list
pscale shell <database> <branch>

### Related Skills

drizzle-kit - ORM schema management and migrations
gitlab-cli-skills - GitLab MR workflow integration
github - GitHub PR and CI/CD integration

### Automation Scripts

See scripts/ directory for token-efficient automation:

create-branch-for-mr.sh - Create PlanetScale branch matching your MR/PR branch name
deploy-schema-change.sh - Complete schema migration workflow
sync-branch-with-main.sh - Sync development branch with main

Scripts execute without loading into context (~90% token savings).

### Resources

Official docs: https://planetscale.com/docs/reference/planetscale-cli
GitHub: https://github.com/planetscale/cli
Community: https://github.com/planetscale/discussion
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: vince-winkintel
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T03:17:44.192Z
- Expires at: 2026-05-14T03:17:44.192Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/planetscale-cli-skills)
- [Send to Agent page](https://openagent3.xyz/skills/planetscale-cli-skills/agent)
- [JSON manifest](https://openagent3.xyz/skills/planetscale-cli-skills/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/planetscale-cli-skills/agent.md)
- [Download page](https://openagent3.xyz/downloads/planetscale-cli-skills)