forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-generate
agentforce-generate
FlaggedBuild, modify, audit, repair, optimize, debug, and deploy agents with Agentforce Agent Script. TRIGGER when: user creates, reviews, or changes .agent files or aiAuthoringBundle metadata; asks to fix AgentScript, audit an existing agent, run an AgentScript health check, common-pitfall review, or baseline-versus-candidate repair loop; changes a response, action, subagent, route, state flow, or Agent Spec; migrates or upgrades a legacy GenAiPlannerBundle Agentforce agent (NOT an Einstein Bot) to an aiAuthoringBundle (Agent Script) agent; previews, debugs, deploys, publishes, or tests agents; uses sf agent generate/preview/publish/test; or manages Agentforce MCP servers, tools, assets, or authentication. DO NOT TRIGGER when: Apex, Flow, Prompt Template, Experience Cloud, or general Salesforce CLI work is unrelated to Agent Script; the source is an Einstein Bot (BotDefinition/BotVersion) — use agentforce-bot-upgrade; or the primary input is a production session or trace ID rather than an agent artifact.
references/feature-validity.md
View on GitHub# Feature Validity by Context
> **Key distinction**: Many action metadata properties are valid on **action definitions with targets** (`flow://`, `apex://`) but NOT on **utility actions** (`@utils.transition`).
>
> Use this as a companion to `actions-reference.md`, not a replacement.
| Feature | On `@utils.transition` | On action definitions with `target:` | Notes |
|---------|------------------------|---------------------------------------|-------|
| `label:` on subagents | ❌ | ✅ | Valid on subagent blocks |
| `label:` on actions | ❌ | ✅ | Valid on Level 1 action definitions |
| `label:` on I/O fields | ❌ | ✅ | Valid on inputs/outputs |
| `require_user_confirmation:` | ❌ | ✅ | Compiles; runtime no-op |
| `include_in_progress_indicator:` | ❌ | ✅ | Shows spinner during action execution |
| `progress_indicator_message:` | ❌ | ✅ | Works on both `flow://` and `apex://` |
| `output_instructions:` | ❌ | ❓ Untested | Not tested on target-backed actions |
| `always_expect_input:` | ❌ | ❌ | NOT implemented anywhere |
**What works on `@utils.transition` actions:**
```yaml
actions:
go_next: @utils.transition to @subagent.next
description: "Navigate to next subagent" # ✅ ONLY description works
```
**What works on action definitions with `target:`:**
```yaml
actions:
process_order:
label: "Process Order" # ✅ Display label
description: "Process the customer's order" # ✅ LLM description
require_user_confirmation: True # ✅ Compiles (runtime issue)
include_in_progress_indicator: True # ✅ Shows spinner
progress_indicator_message: "Processing..." # ✅ Custom spinner message
inputs:
order_id: string
label: "Order ID" # ✅ I/O display label
description: "The order identifier"
outputs:
status: string
label: "Order Status" # ✅ I/O display label
description: "Current order status"
target: "apex://OrderProcessor"
```Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |