Skip to content

kugamon/salesforce-core-skills / plugins/salesforce-core/skills/sf-metadata

sf-metadata

Verified

Salesforce metadata operations expert. Use when creating custom objects, fields, validation rules, record types, permission sets, or querying org metadata structures via a Salesforce MCP server. Do NOT use for comparing metadata across two orgs (use sf-orgdiff), Named or External Credentials and Platform Events (use sf-integration), or querying and loading records (use sf- data). Usage: /sf-metadata [create|update|delete|describe] {ObjectName|FieldName|type} ...

FileKindSize
CREDITS.mdmarkdown2.3 KB
LICENSEother1.1 KB
README.mdmarkdown3.5 KB
SKILL.mdskill md33.8 KB
assets/fields/checkbox-field.xmlconfig971 B
assets/fields/currency-field.xmlconfig1.3 KB
assets/fields/date-field.xmlconfig1.0 KB
assets/fields/email-field.xmlconfig1.1 KB
assets/fields/formula-field.xmlconfig2.3 KB
assets/fields/lookup-field.xmlconfig2.1 KB
assets/fields/master-detail-field.xmlconfig1.8 KB
assets/fields/multi-select-picklist.xmlconfig2.0 KB
assets/fields/number-field.xmlconfig1.4 KB
assets/fields/phone-field.xmlconfig1.0 KB
assets/fields/picklist-field.xmlconfig2.1 KB
assets/fields/rollup-summary-field.xmlconfig2.7 KB
assets/fields/text-field.xmlconfig1.2 KB
assets/fields/textarea-field.xmlconfig1.1 KB
assets/fields/url-field.xmlconfig940 B
assets/layouts/page-layout.xmlconfig6.5 KB
assets/objects/custom-object.xmlconfig2.4 KB
assets/permission-sets/permission-set.xmlconfig5.7 KB
assets/profiles/profile.xmlconfig5.2 KB
assets/record-types/record-type.xmlconfig3.7 KB
assets/validation-rules/validation-rule.xmlconfig5.1 KB
references/best-practices-scoring.mdmarkdown3.6 KB
references/customfield-metadata-schema.jsonconfig16.1 KB
references/customobject-metadata-schema.jsonconfig49.9 KB
references/execution-modes.mdmarkdown7.0 KB
references/field-types-guide.mdmarkdown8.8 KB
references/flexipage-metadata-schema.jsonconfig11.6 KB
references/fls-best-practices.mdmarkdown7.8 KB
references/layout-metadata-schema.jsonconfig17.8 KB
references/mcp-pagination.mdmarkdown3.1 KB
references/metadata-types-reference.mdmarkdown8.5 KB
references/naming-conventions.mdmarkdown5.6 KB
references/permset-auto-generation.mdmarkdown2.8 KB
references/quickaction-metadata-schema.jsonconfig6.9 KB
references/recordtype-metadata-schema.jsonconfig2.9 KB
references/validationrule-metadata-schema.jsonconfig1.2 KB
scripts/mcp_validator.pyscript4.5 KB
scripts/pre-mcp-validate.pyscript4.3 KB
scripts/validate_metadata_operation.pyscript13.9 KB

scripts/mcp_validator.py

View on GitHub
#!/usr/bin/env python3
"""MCP validator adapter for Salesforce metadata operations."""

from __future__ import annotations

import importlib.util
import os
from typing import Any

_SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
_VALIDATE_SCRIPT = os.path.join(_SCRIPT_DIR, "validate_metadata_operation.py")

_spec = importlib.util.spec_from_file_location("validate_metadata_operation", _VALIDATE_SCRIPT)
_mod = importlib.util.module_from_spec(_spec)
_spec.loader.exec_module(_mod)
MetadataOperationValidator = _mod.MetadataOperationValidator
SUPPORTED_METADATA_TYPES = _mod.SUPPORTED_METADATA_TYPES

SUPPORTED_TOOLS = ("metadata_create", "metadata_update", "tooling_api_dml", "metadata_read")


def _extract_metadata(tool: str, params: dict[str, Any]) -> tuple[str, dict[str, Any], str, int]:
    """Return (metadata_type, payload, full_name, batch_size)."""
    metadata_type = ""
    payload: dict[str, Any] = {}
    full_name = ""
    batch_size = 0

    if tool in ("metadata_create", "metadata_update"):
        metadata_type = params.get("type", "")
        metadata = params.get("metadata", [])
        if isinstance(metadata, list):
            batch_size = len(metadata)
            if metadata:
                first = metadata[0]
                if isinstance(first, dict):
                    payload = first
                    full_name = str(first.get("fullName", first.get("masterLabel", "")))

    elif tool == "metadata_read":
        metadata_type = params.get("type", "")
        full_names = params.get("fullNames", [])
        batch_size = len(full_names) if isinstance(full_names, list) else 0
        if full_names:
            full_name = str(full_names[0])
        # metadata_read is read-only; provide a minimal payload for type-level checks.
        payload = {"fullName": full_name} if full_name else {}

    elif tool == "tooling_api_dml":
        sobject = params.get("sObject", "")
        record = params.get("record", {})
        metadata_type = sobject
        batch_size = 1
        if isinstance(record, dict):
            payload = record.get("Metadata", {}) if isinstance(record.get("Metadata"), dict) else {}
            full_name = str(record.get("FullName", ""))
            if full_name and "fullName" not in payload:
                payload = {**payload, "fullName": full_name}

    return metadata_type, payload, full_name, batch_size


def validate_metadata_deployment(input_data: dict[str, Any]) -> dict[str, Any]:
    tool = input_data.get("tool", "")
    params = input_data.get("params", {})

    base = {
        "tier": "metadata_deployment",
        "tool": tool,
        "metadata_type": "",
        "status": "error",
        "validator": "MetadataOperationValidator",
    }

    if tool not in SUPPORTED_TOOLS:
        return {**base, "message": f"Unsupported tool '{tool}'"}

    metadata_type, payload, full_name, batch_size = _extract_metadata(tool, params)
    base.update({"metadata_type": metadata_type, "full_name": full_name})

    if not metadata_type:
        return {**base, "message": "Could not determine metadata type from MCP payload"}

    if metadata_type not in SUPPORTED_METADATA_TYPES:
        return {
            **base,
            "status": "skipped",
            "message": f"Metadata type '{metadata_type}' is not handled by this validator",
        }

    if not payload:
        return {**base, "message": "Missing or empty metadata payload"}

    # metadata_read is read-only — skip full payload validation and return
    # a lightweight acknowledgement that the type is supported.
    if tool == "metadata_read":
        return {
            **base,
            "status": "scored",
            "quality_status": "pass",
            "overall_score": 0,
            "max_score": 0,
            "categories": {},
            "issues": [],
            "message": f"Read operation for '{metadata_type}' — no payload to validate",
        }

    result = MetadataOperationValidator(metadata_type, payload).validate()
    quality_status = result.pop("status", "unknown")
    response = {**base, **result, "status": "scored", "quality_status": quality_status}
    if batch_size > 1:
        response["batch_warning"] = (
            f"Only the first of {batch_size} metadata items was validated. "
            "Submit items individually for complete coverage."
        )
    return response


class MetadataMCPValidator:
    """Entry point wrapper used by hooks and tests."""

    def validate(self, input_data: dict[str, Any]) -> dict[str, Any]:
        return validate_metadata_deployment(input_data)
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall