Skills

Platform Sandbox Configure

MUST USE this skill for ANY sandbox request, including simply getting a sandbox's...

Install

npx skills add forcedotcom/sf-skills --skill platform-sandbox-configure -g -a claude-code -y
Repository
forcedotcom/sf-skills1.1k
Category
Engineering
Updated
5d ago
License
Apache-2.0
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

MUST USE this skill for ANY sandbox request, including simply getting a sandbox's details, status, license type, or pending-activation state by name or ID. TRIGGER when the user: types \"sandbox -help\"/\"sandbox help\"; mentions a sandbox ID (07E prefix); asks to list or show sandboxes; asks for the details, status, license type, or config of a sandbox by name or ID; activates or discards a completed refresh; deletes a sandbox; verifies activation or deletion; creates or refreshes a sandbox. DO NOT TRIGGER when: the user wants to clone a sandbox.

Sandbox Lifecycle Management

Manage Salesforce sandbox environments through Connect REST API, list inventory, activate or discard completed refreshes, create and refresh sandboxes, and permanently delete sandboxes.

When This Skill Owns the Task

Use platform-sandbox-configure when the work involves:

  • Listing or retrieving all sandboxes (GET /sandbox/reports)
  • Getting details or status of a specific sandbox by name or by ID (07E prefix)
  • Checking license usage and remaining capacity by license type (GET /sandbox/licenses)
  • Activating a sandbox after a refresh completes (applying the refresh)
  • Discarding a completed refresh (keeping existing sandbox data unchanged)
  • Permanently deleting a sandbox to free up licenses
  • Verifying activation or deletion completed
  • Creating a new sandbox (Developer, Developer Pro, Partial Copy, or Full)
  • Refreshing an existing sandbox with latest production data

Delegate elsewhere when the user is:

  • Cloning a sandbox → Tooling API (SandboxInfo sObject)
  • Generating a post-copy automation JSON config from an SOP → automation-sandbox-post-copy-config-generate
  • Applying/running a post-copy automation JSON config against a sandbox → automation-sandbox-post-copy-configure

Help (Interactive Menu)

When the user types sandbox -help or sandbox help, respond with ONLY a text message showing the numbered operation list below. Do NOT call any API or tool, just display this menu and wait for the user to reply with a number.

The agent MUST respond with this exact markdown (not in a code block, render it directly as a bullet list):

Sandbox Lifecycle Management

1. Inventory & Details

  • a. List all sandboxes, Names, types, statuses, IDs
  • b. Get details (by name), Status, license, config
  • c. Get details (by ID), Provide a 07E ID directly
  • d. Check license usage, Available vs. used counts by license type
Read the whole SKILL.md on GitHub

More in Engineering