platform-data-manage
Salesforce data operations with 130-point scoring. Use this skill to create, update, delete, bulk import/export, generate test data, and clean up org records using sf CLI and anonymous Apex. TRIGGER when: user creates test data, performs bulk import/export, uses sf data CLI commands, needs data fact
By forcedotcom · 5,469 installs
npx skills add forcedotcom/sf-skills --skill platform-data-manage
Source repository · Upstream listing
Salesforce Data Operations Expert (platform data manage)
Use this skill when the user needs Salesforce data work : record CRUD, bulk import/export, test data generation, cleanup scripts, or data factory patterns for validating Apex, Flow, or integration behavior.
When This Skill Owns the Task
Use platform data manage when the work involves:
sf data CLI commands
record creation, update, delete, upsert, export, or tree import/export
realistic test data generation
bulk data operations and cleanup
Apex anonymous scripts for data seeding / rollback
Delegate elsewhere when the user is:
writing SOQL only → [platform soql query](../platform soql query/SKILL.md)
running or repairing Apex tests → [platform apex test run](../platform apex test run/SKILL.md)
deploying metadata first → [platform metadata deploy](../platform metadata deploy/SKILL.md)
creating or modifying custom objects / fields → [platform custom object generate](../platform custom object generate/SKILL.md) or [platform custom field generate](../platform custom field generate/SKILL.md)
Important Mode Decision
Confirm which mode the user wants:
Mode Use when
Script generation they want reusable .apex , CSV, or JSON assets without touching an org yet
Remote execution they want records created / changed in a real org now
Do not assume remote execution if the user may only want scripts.
Required Context to Gather First
Ask for or infer:
target object(s)
org alias, if remote execution is required
operation type: query, create, update, delete, upsert, import, export, cleanup
expected volume
whether this is test data, migration data, or one off troubleshooting data
any parent child relationships that must exist first
Core Operating Rules
platform data manage acts on remote org data unless the user explicitly wants local script generation.
Objects and fields must already exist before data creation.
For automation testing, prefer 251+ records when bulk behavior matters.
Plan cleanup before creating large or noisy datasets — untracked records accumulate across runs and pollute org state.
Use synthetic, non identifying data in test records — real PII creates compliance risk and cannot be safely removed after bulk import.
Prefer CLI first for straightforward CRUD; use anonymous Apex when the operation truly needs server side orchestration.
If metadata is missing, stop and hand off to:
[platform custom object generate](../platform custom object generate/SKILL.md) or [platform custom field generate](../platform custom field generate/SKILL.md) to create the missing schema, then [platform metadata deploy](../platform metadata deploy/SKILL.md) to deploy it before retrying the data operation
Recommended Workflow
1. Verify prerequisites
Confirm object / field availability, org auth, and required parent records.
2. Run describe first pre flight validation when schema is uncertain
Before creating or updating records, use object describe data to validate:
required fields
createable vs non createable fields
picklist values
relationship fields and parent requirements
See [references/sf cli data commands.md](references/sf cli data commands.md) for the sf sobject describe command and jq filter patterns for inspecting fields, picklist values, and createable constraints.
3. Choose the smallest correct mechanism
Need Default approach
small one off CRUD sf data single record commands
large import/export Bulk API 2.0 via sf data ... bulk
parent child seed set tree import/export
reusable test dataset factory / anonymous Apex script
reversible experiment cleanup script or savepoint based approach
4. Execute or generate assets
Use the built in templates under assets/ when they fit:
assets/factories/
assets/bulk/
assets/cleanup/
assets/soql/
assets/csv/
assets/json/
5. Verify results
Check counts, relationships, and record IDs after creation or update.
6. Apply a bounded retry strategy
If creation fails:
1. try the primary CLI shape once
2. retry once with corrected parameters
3. re run describe / validate assumptions
4. pivot to a different mechanism or provide a manual workaround
Do not repeat the same failing command indefinitely.
7. Leave cleanup guidance
Provide exact cleanup commands or rollback assets whenever data was created.
High Signal Rules
Bulk safety
use bulk operations for large volumes
test automation sensitive behavior with 251+ records where appropriate
avoid one record at a time patterns for bulk scenarios
Data integrity
include required fields
validate picklist values before creation
verify parent IDs and relationship integrity
account for validation rules and duplicate constraints
exclude non createable fields from input payloads
Cleanup discipline
Prefer one of:
delete by ID
delete by pattern
delete by created date window
rollback / savepoint patterns for script based test runs
Common Failure Patterns
Error Likely cause Default fix direction
INVALID FIELD wrong field API name or FLS issue verify schema and access
REQUIRED FIELD MISSING mandatory field omitted include required values from describe data
INVALID CROSS REFERENCE KEY bad parent ID create / verify parent first
FIELD CUSTOM VALIDATION EXCEPTION validation rule blocked the record use valid test data or adjust setup
invalid picklist value guessed value instead of describe backed value inspect picklist values first
non writeable field error field is not createable / updateable remove it from the payload
bulk limits / timeouts wrong tool for the volume switch to bulk / staged import
Output Format
When finishing, report in this order:
1. Operation performed
2. Objects and counts
3. Target org or local artifact path
4. Record IDs / output files
5. Verification result
6. Cleanup instructions
Suggested shape:
Cross Skill Integration
Need Delegate to Reason
create missing custom objects [platform custom object generate](../platform custom object generate/SKILL.md) schema must exist before data operations
create missing custom fields [platform custom field generate](../platform custom field generate/SKILL.md) field level schema must exist before data creation
run bulk sensitive Apex validation [platform apex test run](../platform apex test run/SKILL.md) test execution and coverage
deploy missing schema first [platform metadata deploy](../platform metadata deploy/SKILL.md) metadata readiness
implement production Apex logic consuming the data [platform apex generate](../platform apex generate/SKILL.md) Apex class / trigger authoring
implement Flow logic consuming the data [automation flow generate](../automation flow generate/SKILL.md) Flow authoring and automation
Reference Map
Start here
[references/sf cli data commands.md](references/sf cli data commands.md)
[references/test data best practices.md](references/test data best practices.md)
[references/orchestration.md](references/orchestration.md)
[references/test data patterns.md](references/test data patterns.md)
[references/test data factory usage.md](references/test data factory usage.md)
Query / bulk / cleanup
[references/soql relationship guide.md](references/soql relationship guide.md)
[references/relationship query examples.md](references/relationship query examples.md)
[references/bulk operations guide.md](references/bulk operations guide.md)
[references/cleanup rollback guide.md](references/cleanup rollback guide.md)
[references/cleanup rollback example.md](references/cleanup rollback example.md)
Examples / limits
[references/crud workflow example.md](references/crud workflow example.md)
[references/bulk testing example.md](references/bulk testing example.md)
[references/anonymous apex guide.md](references/anonymous apex guide.md)
[references/governor limits reference.md](references/governor limits reference.md)
Validation scripts
[scripts/soql validator.py](scripts/soql validator.py) — validate SOQL queries before execution
[scripts/validate data operation.py](scripts/validate data operation.py) — pre flight check for data operations (required fields, picklist values, createable fields)
Asset templates
assets/factories/ — Apex test data factory scripts (account, contact, opportunity, lead, user, etc.)
assets/bulk/ — Bulk API 2.0 Apex templates (insert 200, 500, 10000 records; upsert by external ID)
assets/cleanup/ — Cleanup and rollback scripts (delete by name, date, pattern; transaction rollback)
assets/soql/ — SOQL query templates (aggregate, subquery, parent to child, child to parent, polymorphic)
assets/csv/ — CSV import templates for Account, Contact, Opportunity, custom objects
assets/json/ — JSON tree import templates (account contact, account opportunity, full hierarchy)
Score Guide
Score Meaning
117+ strong production safe data workflow
104–116 good operation with minor improvements possible
91–103 acceptable but review advised
78–90 partial / risky patterns present
< 78 blocked until corrected