sf-ai-agentforce: Standard Agentforce Platform Development

Use this skill for the Setup UI / Agent Builder path: declarative topics, Builder-managed actions, GenAiFunction / GenAiPlugin metadata, PromptTemplate integration, Models API usage from Apex, and custom Lightning types.

For new code-first agent development, prefer sf-ai-agentscript.

When This Skill Owns the Task

Use sf-ai-agentforce when the user is:

maintaining existing Builder-based agents
working in Setup → Agentforce → Agents
creating or fixing GenAiFunction, GenAiPlugin, or PromptTemplate metadata
wiring Builder topics to Flow / Apex / Prompt Template actions
using Models API or LightningTypeBundle in the context of Builder-based agents

Do not use it for:

.agent files or deterministic FSM design → sf-ai-agentscript
agent test suites and coverage loops → sf-ai-agentforce-testing
persona / voice design → sf-ai-agentforce-persona

Required Context to Gather First

Ask for or infer:

whether this is a Builder / Setup UI project or a code-first Agent Script project
agent type: Service Agent or Employee Agent
whether the work targets topics, actions, PromptTemplates, Models API, or custom Lightning types
what supporting Flow / Apex / metadata dependencies already exist
whether the user needs authoring help, publish help, or troubleshooting

Two Agentforce Paths

Path	Skill	Best fit
Setup UI / Agent Builder	`sf-ai-agentforce`	Declarative maintenance, existing Builder agents, metadata-driven action registration
Agent Script DSL	`sf-ai-agentscript`	Code-first `.agent` authoring, deterministic routing, version-controlled agent logic

If the user is starting from scratch and wants strong control over flow/state, route to Agent Script.

Recommended Workflow

Builder Workflow Summary

Confirm this is a Builder / Setup UI project
Pick Service Agent vs Employee Agent
Define topics with strong descriptions, scope, and instructions
Prepare supporting actions (Flow, Apex, PromptTemplate)
Configure inputs / outputs carefully
Validate dependencies
Publish, then activate

Expanded workflow: references/builder-workflow.md

Key Platform Rules

Topic quality matters

Topic descriptions are routing instructions for the planner. They must be:

specific
scenario-based
non-overlapping with sibling topics

Actions are wrappers around real targets

Target type	Typical use	Registered via
Flow	safest default for Builder actions	`GenAiFunction`
Apex	complex business logic via `@InvocableMethod`	`GenAiFunction`
Prompt Template	generated summaries / drafts / recommendations	`GenAiFunction`

Supporting metadata deploys first

Before publishing the agent itself, deploy the supporting stack:

metadata / fields if needed
Apex if needed
Flows if needed
PromptTemplate / GenAiFunction / GenAiPlugin
then publish the agent

Publish does not activate

After publish, run sf agent activate separately.

Metadata Guidance

GenAiFunction

Use when registering a single callable action. Validate:

target exists
target is active / deployable
input names match the target contract
output names match the target contract
capability text clearly says when the action should be used

GenAiPlugin

Use when grouping related functions into one logical package.

PromptTemplate

Use for generated content, not deterministic business rules.

Models API

Use when the solution belongs in Apex-driven AI orchestration rather than Builder-only actions.

Custom Lightning Types

Use when the action needs richer structured input or output presentation.

Expanded reference: references/metadata-reference.md

Cross-Skill Integration

Recommended Orchestration Order

sf-metadata → sf-apex → sf-flow → sf-ai-agentforce → sf-deploy

Required delegations

Requirement	Delegate to	Why
Create / fix Flows	sf-flow	Action target creation and Flow validation
Create / fix Apex actions	sf-apex	`@InvocableMethod` and Apex correctness
Deploy / publish	sf-deploy	Deployment orchestration
Test the agent	sf-ai-agentforce-testing	Formal test execution and assertions

High-Signal Failure Patterns

Symptom	Likely cause	Read next
Action not available in Builder	target metadata missing or not deployed	references/metadata-reference.md
Prompt output is poor	PromptTemplate shape / bindings are weak	references/prompt-templates.md
Apex AI logic times out	Models API work placed in the wrong context	references/models-api.md
Rich input/output UI not rendering	Lightning type config or prerequisites are incomplete	references/custom-lightning-types.md
Agent publishes but is not usable	forgot explicit activation	references/cli-commands.md

Reference Map

Start here

Deep technical docs

Rubric

references/scoring-rubric.md

Cross-skill reads

Score Guide

Score	Meaning
90+	Ready to deploy
80–89	Strong, minor cleanup only
70–79	Review before deploy
60–69	Needs work
< 60	Block deployment

Full rubric: references/scoring-rubric.md