platform-agenticsetup-categories-get — скилл для Claude Code
Скилл platform-agenticsetup-categories-get получает категории Agentic Setup из подключённой Salesforce org через Connect API. Можно запросить и вложенные промпты.
Apache-2.0 235 установок ★ 1 183 обновлён 2026-10-23
npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-codeЧто делает platform-agenticsetup-categories-get
Скилл проверяет подключение через sf org display --json, затем вызывает GET /services/data/v67.0/agenticsetup/categories командой sf api request rest. В ответе показывает имя и метку каждой категории; с параметром fetchPrompts=true добавляет вложенные промпты. API возвращает категории и промпты в алфавитном порядке.
Для работы нужна уже авторизованная Salesforce org; если org по умолчанию не задана, потребуется выбрать её через --target-org. Скилл использует Salesforce CLI sf версии 2.0.0 или новее и API версии 67.0 либо указанной пользователем. API доступен только для чтения: создавать и менять категории с его помощью нельзя. Запрос вложенных промптов увеличивает ответ, поэтому их получают только по просьбе.
Какие задачи решает
- получить список категорий Agentic Setup
- показать метки категорий из Salesforce org
- вывести промпты внутри каждой категории
- разобраться с ошибкой авторизации при запросе категорий
Примеры запросов агенту
- Покажи категории Agentic Setup в подключённой Salesforce org.
- Получи категории библиотеки промптов и включи вложенные промпты.
- Выведи категории Agentforce и объясни ошибку запроса, если она возникнет.
Как установить platform-agenticsetup-categories-get
1Через Skills CLI (Vercel)
npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-code2Вручную: положить файлы
~/.claude/skills/platform-agenticsetup-categories-get/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/platform-agenticsetup-categories-get/
1Через Skills CLI (Vercel)
npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a codex2Вручную: положить файлы
.agents/skills/platform-agenticsetup-categories-get/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a cursor2Вручную: положить файлы
.cursor/skills/platform-agenticsetup-categories-get/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install forcedotcom/sf-skills skills/platform-agenticsetup-categories-get2Вручную: положить файлы
.github/skills/platform-agenticsetup-categories-get/SKILL.md1Через Skills CLI (Vercel)
npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a gemini-cli2Командой платформы
gemini skills install https://github.com/forcedotcom/sf-skills --path skills/platform-agenticsetup-categories-getВручную: положить файлы
.devin/skills/platform-agenticsetup-categories-get/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о platform-agenticsetup-categories-get
Как установить platform-agenticsetup-categories-get в Claude Code?
Выполните npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-code. Файл скилла будет размещён по пути ~/.claude/skills/platform-agenticsetup-categories-get/SKILL.md.
Что делает platform-agenticsetup-categories-get?
Получает категории Agentic Setup из подключённой Salesforce org через Connect API. По запросу включает промпты, вложенные в категории.
Что нужно для работы скилла?
Нужна авторизованная Salesforce org и Salesforce CLI sf версии 2.0.0 или новее. Используется API версии 67.0 или версия, заданная пользователем.
Исходный текст
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