{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/planetscale-cli-skills",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=planetscale-cli-skills",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "pscale-auth/SKILL.md",
      "pscale-auth/references/commands.md",
      "pscale-backup/SKILL.md",
      "pscale-backup/references/commands.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/planetscale-cli-skills",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "PlanetScale CLI Skills",
        "body": "Comprehensive pscale command reference and workflows for managing PlanetScale databases via terminal."
      },
      {
        "title": "Overview",
        "body": "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."
      },
      {
        "title": "Sub-Skills",
        "body": "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"
      },
      {
        "title": "Should I use a branch or deploy request?",
        "body": "What's your goal?\n├─ Experimenting with schema changes → Create branch (pscale-branch)\n├─ Testing schema in isolation → Create branch (pscale-branch)\n├─ Ready to deploy schema to production → Create deploy request (pscale-deploy-request)\n└─ Reviewing schema changes before production → Review deploy request (pscale-deploy-request)"
      },
      {
        "title": "Service token vs password?",
        "body": "What's your use case?\n├─ CI/CD pipeline → Service token (pscale-service-token)\n├─ Local development → Password (pscale-password)\n├─ Production application → Service token (rotatable, secure)\n└─ One-off admin task → Password (temporary)"
      },
      {
        "title": "Direct promotion vs deploy request?",
        "body": "Production readiness?\n├─ Immediate promotion (dangerous) → pscale branch promote (pscale-branch)\n├─ Review + approval workflow → pscale deploy-request create (pscale-deploy-request)\n└─ Safe production deployment → Always use deploy requests"
      },
      {
        "title": "Schema Migration Workflow",
        "body": "Complete workflow from branch creation to production deployment:\n\n# 1. Create development branch\npscale branch create <database> <branch-name>\n\n# 2. Make schema changes (via shell, ORM, or direct SQL)\npscale shell <database> <branch-name>\n\n# 3. View schema diff\npscale branch diff <database> <branch-name>\n\n# 4. Create deploy request\npscale deploy-request create <database> <branch-name>\n\n# 5. Review and deploy\npscale deploy-request deploy <database> <deploy-request-number>\n\n# 6. Verify deployment\npscale deploy-request show <database> <deploy-request-number>\n\nSee scripts/ directory for automation."
      },
      {
        "title": "Branch Development Workflow",
        "body": "# Create branch from main\npscale branch create <database> <feature-branch> --from main\n\n# Work on schema changes\npscale shell <database> <feature-branch>\n\n# Check diff before deploying\npscale branch diff <database> <feature-branch>\n\n# Create deploy request when ready\npscale deploy-request create <database> <feature-branch>"
      },
      {
        "title": "CI/CD Integration",
        "body": "# Create service token for CI/CD\npscale service-token create --org <org>\n\n# Use in CI/CD pipelines (GitHub Actions, GitLab CI, etc.)\nexport PLANETSCALE_SERVICE_TOKEN_ID=<token-id>\nexport PLANETSCALE_SERVICE_TOKEN=<token>\n\n# Deploy via CI/CD\npscale deploy-request create <database> <branch> --auto-approve"
      },
      {
        "title": "Most Common Commands",
        "body": "# Authentication\npscale auth login\npscale auth logout\n\n# Branch management\npscale branch create <database> <branch> [--from <source-branch>]\npscale branch list <database>\npscale branch delete <database> <branch>\n\n# Deploy requests\npscale deploy-request create <database> <branch>\npscale deploy-request list <database>\npscale deploy-request deploy <database> <number>\n\n# Database operations\npscale database create <database> --org <org>\npscale database list\npscale shell <database> <branch>"
      },
      {
        "title": "Related Skills",
        "body": "drizzle-kit - ORM schema management and migrations\ngitlab-cli-skills - GitLab MR workflow integration\ngithub - GitHub PR and CI/CD integration"
      },
      {
        "title": "Automation Scripts",
        "body": "See scripts/ directory for token-efficient automation:\n\ncreate-branch-for-mr.sh - Create PlanetScale branch matching your MR/PR branch name\ndeploy-schema-change.sh - Complete schema migration workflow\nsync-branch-with-main.sh - Sync development branch with main\n\nScripts execute without loading into context (~90% token savings)."
      },
      {
        "title": "Resources",
        "body": "Official docs: https://planetscale.com/docs/reference/planetscale-cli\nGitHub: https://github.com/planetscale/cli\nCommunity: https://github.com/planetscale/discussion"
      }
    ],
    "body": "PlanetScale CLI Skills\n\nComprehensive pscale command reference and workflows for managing PlanetScale databases via terminal.\n\nOverview\n\nThe 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.\n\nSub-Skills\nCommand\tSkill\tUse When\nauth\tpscale-auth\tLogin, logout, service tokens, authentication management\nbranch\tpscale-branch\tCreate, delete, promote, diff, list database branches\ndeploy-request\tpscale-deploy-request\tCreate, review, deploy, revert schema changes\ndatabase\tpscale-database\tCreate, list, show, delete databases\nbackup\tpscale-backup\tCreate, list, show, delete branch backups\npassword\tpscale-password\tCreate, list, delete connection passwords\norg\tpscale-org\tList, show, switch organizations\nservice-token\tpscale-service-token\tCreate, manage CI/CD service tokens\nDecision Trees\nShould I use a branch or deploy request?\nWhat's your goal?\n├─ Experimenting with schema changes → Create branch (pscale-branch)\n├─ Testing schema in isolation → Create branch (pscale-branch)\n├─ Ready to deploy schema to production → Create deploy request (pscale-deploy-request)\n└─ Reviewing schema changes before production → Review deploy request (pscale-deploy-request)\n\nService token vs password?\nWhat's your use case?\n├─ CI/CD pipeline → Service token (pscale-service-token)\n├─ Local development → Password (pscale-password)\n├─ Production application → Service token (rotatable, secure)\n└─ One-off admin task → Password (temporary)\n\nDirect promotion vs deploy request?\nProduction readiness?\n├─ Immediate promotion (dangerous) → pscale branch promote (pscale-branch)\n├─ Review + approval workflow → pscale deploy-request create (pscale-deploy-request)\n└─ Safe production deployment → Always use deploy requests\n\nCommon Workflows\nSchema Migration Workflow\n\nComplete workflow from branch creation to production deployment:\n\n# 1. Create development branch\npscale branch create <database> <branch-name>\n\n# 2. Make schema changes (via shell, ORM, or direct SQL)\npscale shell <database> <branch-name>\n\n# 3. View schema diff\npscale branch diff <database> <branch-name>\n\n# 4. Create deploy request\npscale deploy-request create <database> <branch-name>\n\n# 5. Review and deploy\npscale deploy-request deploy <database> <deploy-request-number>\n\n# 6. Verify deployment\npscale deploy-request show <database> <deploy-request-number>\n\n\nSee scripts/ directory for automation.\n\nBranch Development Workflow\n# Create branch from main\npscale branch create <database> <feature-branch> --from main\n\n# Work on schema changes\npscale shell <database> <feature-branch>\n\n# Check diff before deploying\npscale branch diff <database> <feature-branch>\n\n# Create deploy request when ready\npscale deploy-request create <database> <feature-branch>\n\nCI/CD Integration\n# Create service token for CI/CD\npscale service-token create --org <org>\n\n# Use in CI/CD pipelines (GitHub Actions, GitLab CI, etc.)\nexport PLANETSCALE_SERVICE_TOKEN_ID=<token-id>\nexport PLANETSCALE_SERVICE_TOKEN=<token>\n\n# Deploy via CI/CD\npscale deploy-request create <database> <branch> --auto-approve\n\nQuick Reference\nMost Common Commands\n# Authentication\npscale auth login\npscale auth logout\n\n# Branch management\npscale branch create <database> <branch> [--from <source-branch>]\npscale branch list <database>\npscale branch delete <database> <branch>\n\n# Deploy requests\npscale deploy-request create <database> <branch>\npscale deploy-request list <database>\npscale deploy-request deploy <database> <number>\n\n# Database operations\npscale database create <database> --org <org>\npscale database list\npscale shell <database> <branch>\n\nRelated Skills\ndrizzle-kit - ORM schema management and migrations\ngitlab-cli-skills - GitLab MR workflow integration\ngithub - GitHub PR and CI/CD integration\nAutomation Scripts\n\nSee scripts/ directory for token-efficient automation:\n\ncreate-branch-for-mr.sh - Create PlanetScale branch matching your MR/PR branch name\ndeploy-schema-change.sh - Complete schema migration workflow\nsync-branch-with-main.sh - Sync development branch with main\n\nScripts execute without loading into context (~90% token savings).\n\nResources\nOfficial docs: https://planetscale.com/docs/reference/planetscale-cli\nGitHub: https://github.com/planetscale/cli\nCommunity: https://github.com/planetscale/discussion"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/vince-winkintel/planetscale-cli-skills",
    "publisherUrl": "https://clawhub.ai/vince-winkintel/planetscale-cli-skills",
    "owner": "vince-winkintel",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}