dx-org-permission-set-assign

Assigns Salesforce permission sets to org users via the sf CLI.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/padjei/SF_Build --skill dx-org-permission-set-assign-padjei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dx-org-permission-set-assign
Source: https://github.com/padjei/SF_Build/tree/main/.claude/skills/dx-org-permission-set-assign
Command: npx skills add https://github.com/padjei/SF_Build --skill dx-org-permission-set-assign-padjei

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Assigning Salesforce permission sets to users through the CLI involves remembering exact flag syntax, handling multiple sets and users, and interpreting JSON results. This Skill removes that friction by mapping natural-language requests directly to the correct sf org assign permset command. ## Core Features & Use Cases - Command Mapping: Translates user intent into the correct sf org assign permset invocation, covering default admin assignment, specific org targets, and multiple users via --on-behalf-of. - Batch Assignment: Combines multiple --name and --on-behalf-of flags in a single command to assign several permission sets to several users at once. - Error Handling Guidance: Interprets the successes and failures arrays in JSON output, with documented resolutions for common issues like missing permission sets or unknown users. - Use Case: An admin asks to grant the DreamHouse and Analytics permission sets to two developers on a scratch org; the Skill builds and runs one command with the right flags and reports per-user results. ## Quick Start Ask the assistant to assign a named permission set to a user or org, for example: assign the DreamHouse permission set to user1@my.org on my scratch org.

Frequently Asked Questions about dx-org-permission-set-assign

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

FAQPage Schema
How do I assign a permission set to a user with the Salesforce CLI?▼

Run sf org assign permset --name <PermSetName> --on-behalf-of <username> --json. Without --on-behalf-of, the permission set is assigned to the target org's default admin user.

How to assign multiple permission sets to multiple users in one command?▼

Repeat the --name flag for each permission set and the --on-behalf-of flag for each user in a single sf org assign permset command. Users are processed sequentially to avoid auth file collisions.

Why does sf org assign permset fail with PermissionSet not found?▼

The error means the permission set name does not exist in the target org or contains a typo. Permission set names are case-sensitive, so verify the exact API name and check for spelling errors.

Does sf org assign permset support partial success?▼

Yes. The JSON output contains separate successes and failures arrays, so some assignments can succeed while others fail. The command exits with a non-zero code if any failures occurred.

Why does a user not see permissions after assignment succeeds?▼

The permission set may have hasActivationRequired set in its metadata, requiring manual activation in Setup before permissions take effect. Check the permission set definition in the org.