sf-metadata-management

Convert and deploy Salesforce metadata between source and Metadata API formats.

13|2|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/jiten-singh-shahi/salesforce-claude-code --skill sf-metadata-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sf-metadata-management
Source: https://github.com/jiten-singh-shahi/salesforce-claude-code/tree/main/.cursor/skills/sf-metadata-management
Command: npx skills add https://github.com/jiten-singh-shahi/salesforce-claude-code --skill sf-metadata-management

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides clear guidance and workflows for managing Salesforce metadata across source and metadata API formats, reducing deployment errors and unexpected org changes when retrieving, converting, or deploying components.

Core Features & Use Cases

  • Source vs Metadata Conversion: Explains how to convert between Salesforce DX source format and Metadata API format for accurate deployments.
  • Targeted Retrieval & Deployment: Shows manifest-based and metadata-type retrievals, source-tracking workflows, and safe deploy practices including preview and conflict handling.
  • Configuration & Best Practices: Covers .forceignore usage, sfdx-project.json settings, and guidance on profiles versus permission sets to avoid permission regressions.
  • Use Case: Retrieve a subset of Apex classes and permission sets from a staging org, compare with a target org, and deploy only the changed components while preserving target-only permissions.

Quick Start

Use this skill to retrieve specified metadata with a manifest or metadata type, compare two org exports, and deploy the selected changes safely.

Frequently Asked Questions about sf-metadata-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy Salesforce metadata from a source tree to a target org?

You can deploy Salesforce metadata by using manifest-based retrievals and source-tracking workflows to fetch components, preview changes, and push only the selected updates to the target org safely.

What is the difference between source format and Metadata API format in Salesforce?

Salesforce DX source format and Metadata API format differ in structure, and converting between them ensures accurate deployments and prevents unexpected org changes when retrieving or deploying components.

How do I configure .forceignore to prevent deployment conflicts?

You can configure .forceignore to exclude specific files and components from source-tracking and deployment operations, applying ignore-conflicts semantics to avoid unintended metadata changes during CI/CD workflows.

Can I compare metadata between two Salesforce orgs before deploying?

Yes, you can retrieve specified metadata from a staging org, compare the exports with a target org, and deploy only the changed components while preserving target-only permissions like profile and permission set settings.

What is the best way to manage profiles versus permission sets during Salesforce retrieval?

Using permission sets over profiles is recommended to avoid permission regressions, ensuring that target-only permissions are preserved during metadata retrieval, conversion, and deployment workflows.

Does sf-cli support safe deploy previews for targeted metadata deployments?

Yes, sf-cli supports safe deploy previews by allowing you to run manifest-based retrievals, apply ignore-conflicts semantics, and prepare targeted deployments to reduce deployment errors before committing changes.