Skip to main content
skill CX Codex

platform-agenticsetup-categories-get — Claude Code skill

platform-agenticsetup-categories-get fetches Agentic Setup prompt categories from a connected Salesforce org through the Connect API. It can include prompts nested under each category.

Apache-2.0 235 installs ★ 1,183 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-code
Open on GitHub

What platform-agenticsetup-categories-get does

The skill checks the Salesforce connection with sf org display --json, then sends a GET request to /services/data/v67.0/agenticsetup/categories using sf api request rest. It presents each category’s name and label. Add fetchPrompts=true to the request when nested prompts are wanted; the API returns categories and prompts in alphabetical order.

A Salesforce org must already be authenticated. If there is no default org, select one with --target-org. The skill uses Salesforce CLI sf version 2.0.0 or later and API version 67.0, unless the user chooses another version. The endpoint is read-only, so it cannot create or edit categories. Nested prompts are included only on request, since they can make the response larger.

What it helps with

  • retrieve Agentic Setup prompt categories
  • show category names and labels from a Salesforce org
  • list prompts nested under each category
  • inspect an authorization error from a category request

Example prompts for the agent

  • List the Agentic Setup categories in my connected Salesforce org.
  • Fetch the prompt library categories and include their nested prompts.
  • Show the Agentforce categories and explain any request error.

How to install platform-agenticsetup-categories-get

1Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-code

2Manually: put the files in place

~/.claude/skills/platform-agenticsetup-categories-get/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/platform-agenticsetup-categories-get/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about platform-agenticsetup-categories-get

How do I install platform-agenticsetup-categories-get in Claude Code?

Run npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-code. The skill file is placed at ~/.claude/skills/platform-agenticsetup-categories-get/SKILL.md.

What does platform-agenticsetup-categories-get do?

It fetches Agentic Setup categories from an authenticated Salesforce org through the Connect API. It can also return prompts nested within those categories.

What does the skill need to run?

Authenticate a Salesforce org first and use Salesforce CLI sf version 2.0.0 or later. The API version is 67.0 unless the user selects another version.

Source text

SKILL.md · Apache-2.0
---
name: platform-agenticsetup-categories-get
description: "Get agentic setup prompt categories from a connected Salesforce org using the Connect API via sf api request rest. Use this skill to call GET /services/data/vXX.0/agenticsetup/categories and return the list of prompt categories, optionally with their nested prompts using fetchPrompts=true. TRIGGER when: user asks to get, fetch, retrieve, list, or show agentic setup categories, prompt categories, setup copilot categories, prompt library categories, available setup prompts, Agentforce prompt library, copilot prompts, or calls the agenticsetup categories Connect REST API. DO NOT TRIGGER when: user wants to create new categories, work with non-categories endpoints, or generate OpenAPI specs."
allowed-tools: Bash Read
metadata:
  version: "1.1"
  domains: ["Platform", "Agentforce"]
  minApiVersion: "67.0"
  cliTools:
    - tool: ["sf"]
      semver: ">=2.0.0"
---

# platform-agenticsetup-categories-get

Get prompt categories from the Agentic Setup Categories Connect API on a connected Salesforce org.

## Scope

**In scope:**
- Calling `GET /services/data/{apiVersion}/agenticsetup/categories` via SF CLI
- Passing the `fetchPrompts` query parameter to include nested prompts
- Parsing and presenting the JSON response (categories, labels, prompts)
- Handling errors (403 when feature is disabled, auth failures)

**Out of scope — delegate elsewhere:**
- Creating or modifying prompt categories → not supported via this API (read-only)
- Org authentication setup → use `sf org login` separately
- Permission set assignment → assigning-permission-set

---

## Required Inputs

The agent needs:
- A connected org (already authenticated via `sf org login`)
- Optionally: whether to include nested prompts (`fetchPrompts=true`)
- Optionally: target API version (default: v67.0). Replace `v67.0` in the URL with the user-specified version if provided.

---

## Workflow

### 1. Verify org connectivity

```bash
sf org display --json
```

Confirm the org is authenticated and extract the instance URL. If no default org is set, ask the user which org to target with `--target-org`.

### 2. Call the Categories API

**Basic call (categories only):**
```bash
sf api request rest /services/data/v67.0/agenticsetup/categories --method GET
```

**With nested prompts:**
```bash
sf api request rest "/services/data/v67.0/agenticsetup/categories?fetchPrompts=true" --method GET
```

### 3. Parse and present the response

The API returns a JSON object with a `categories` array. Each category has `name`, `label`, and `prompts` fields. See `references/api-response-schema.md` for the full response structure and examples for both `fetchPrompts=true` and `fetchPrompts=false`.

Present the results clearly:
- List categories with their name and label
- If `fetchPrompts=true` was used, show nested prompts under each category
- Note any categories with empty `prompts` arrays (means no prompts exist for that category)

### 4. Handle errors

| Error | Meaning | Action |
|-------|---------|--------|
| Success (exit 0) | 200 OK | Parse and display results |
| `FUNCTIONALITY_NOT_ENABLED` | Feature not enabled for this org/user | Tell user the Agentic Setup Categories feature needs to be enabled — check Setup > Einstein/Agentforce |
| `INVALID_SESSION_ID` | Session expired | Re-authenticate with `sf org login` |
| `NOT_FOUND` | Endpoint not found | API version too old or feature not deployed to this org |

---

## Rules / Constraints

| Rule | Rationale |
|------|-----------|
| Always use `sf api request rest` — never curl or raw HTTP | curl bypasses `~/.sfdx` session tokens and requires manual Authorization headers, making it brittle |
| NEVER use SOQL queries | Categories are NOT in standard objects — only available via this Connect REST API |
| NEVER generate files (LWC, Apex, XML) | This is a data-fetching task, not a code generation task |
| Default to v67.0 unless user specifies | This is the min-version where the endpoint was introduced |
| Don't pass fetchPrompts unless asked | Reduces payload size; prompts can be large |
| Categories are sorted by label | The API returns them alphabetically — don't re-sort |
| Prompts are sorted by text | Within each category, prompts come alphabetically |

---

## Output Expectations

When finishing, present:

1. **Number of categories** returned
2. **Category list** — name and label for each
3. **Prompts** (if requested) — nested under their category
4. **Any errors** encountered with suggested fixes

---

## Reference File Index

| File | When to read |
|------|--------------|
| `references/api-response-schema.md` | When you need to understand the full response structure and field descriptions |

© forcedotcom · Apache-2.0 · forcedotcom/sf-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set232

The whole set →
service-itsm-slack-itservice-configure The service-itsm-slack-itservice-configure skill guides the Employee Service setup for Slack, including org preferences, employee permissions, and linking a digital experience site. CX Codex +1 320installs service-itsm-agentic-setup-agent-runtime-access-assign service-itsm-agentic-setup-agent-runtime-access-assign is a Claude Code skill that assigns Salesforce users runtime permissions for activated ITSM agents. It addresses access errors during agent actions. CX Codex +1 314installs experience-search-coordinate experience-search-coordinate coordinates search workflows for articles, news, and media assets across Salesforce CMS channels, splitting mixed requests into structured content and media queries. CX Codex +1 275installs experience-lwc-legacy-migrate experience-lwc-legacy-migrate verifies Aura to LWC migration completeness and upgrades legacy Lightning Out Beta host pages to Lightning Out 2.0 with OAuth PKCE. CX Codex +1 245installs experience-cms-content-render experience-cms-content-render — a skill for Claude Code, Codex, Cursor and other agents that wires existing Salesforce CMS content into a React or Angular uiBundle app. CX Codex +1 226installs experience-design-validate experience-design-validate performs visual craft audits on rendered interfaces using screenshots, Figma frames, or live URLs. Generates an evidence-backed craft report. CX Codex +1 220installs platform-role-hierarchy-apply The platform-role-hierarchy-apply Claude Code skill reshapes a Salesforce role hierarchy from an org chart. It prepares grouped role and user changes for admin review before submission. CX Codex +1 178installs consumer-goods-promotion-bo-api-deploy consumer-goods-promotion-bo-api-deploy — a skill that enables Promotion BO API in Salesforce Consumer Goods Cloud, generates and deploys a custom Workflow Step, and verifies the full path via REST. CX Codex +1 160installs

Project sponsors

Companies that keep this analytics open