Agent skill

Sf AI Agentforce

by Jaganpro in Jaganpro/sf-skills

Agentforce Builder metadata path for Builder-managed topics/actions, Prompt Builder templates, GenAiFunction/GenAiPlugin, Models API, and custom Lightning types.

MITAuto-check passedAgent Workflows

Install Sf AI Agentforce

skills CLI
$ npx skills add Jaganpro/sf-skills --skill sf-ai-agentforce -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Jaganpro/sf-skills sf-ai-agentforce --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Jaganpro/sf-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sf-ai-agentforce .claude/skills/sf-ai-agentforce && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sf-ai-agentforce
GitHub stars
424
Token cost
~2.6k tokens
SKILL.md length
919 words
Files
12 (incl. references)
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Agentforce Builder metadata path for Builder-managed topics/actions, Prompt Builder templates, GenAiFunction/GenAiPlugin, Models API, and custom Lightning types.

  • Works in 9 steps: Confirm this is a Builder / Setup UI… → Pick Service Agent vs Employee Agent → For Service Agents, provision the… → …
  • : user maintains
  • SKILL.md covers When This Skill Owns the Task, Required Context to Gather First, Two Agentforce Paths and Builder Workflow Summary, plus 6 more sections
  • Calls sf

What it does

Sf AI Agentforce is an agent skill from Jaganpro/sf-skills. Agentforce Builder metadata path for Builder-managed topics/actions, Prompt Builder templates, GenAiFunction/GenAiPlugin, Models API, and custom Lightning types. TRIGGER when: user maintains or configures Builder metadata agents, creates topics/actions, works with Prompt Builder templates, or touches .genAiFunction, .genAiPlugin, or .genAiPromptTemplate metadata XML files. DO NOT TRIGGER when: Agent Script DSL .agent files (use sf-ai-agentscript), agent testing (use sf-ai-agentforce-testing), or persona design…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including reference files (for example `CREDITS.md`, `README.md` and `references/builder-workflow.md`). Compatibility notes: Requires API v66.0+ (Spring '26)

It sits in Agent Workflows, covering Agent evaluation and testing. The repository describes itself as: [ARCHIVED — migrated to forcedotcom/afv-library] Salesforce Skills for Agentic Coding Tools — Apex, Flow, LWC, SOQL, Agentforce, Data Cloud, OmniStudio. Read-only archive; active… The licence is MIT.

When your agent uses it

  • : user maintains
  • Configures Builder metadata agents
  • Creates topics/actions
  • Works with Prompt Builder templates

Example prompts

  • “/sf-ai-agentforce”

Requirements

  • Compatibility (from SKILL.md): Requires API v66.0+ (Spring '26)

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Confirm this is a Builder / Setup UI project
  2. Pick Service Agent vs Employee Agent
  3. For Service Agents, provision the running user (prefer sf org create agent-user)
  4. For Employee Agents, plan visibility with a Permission Set containing
  5. Define topics with strong descriptions, scope, and instructions
  6. Prepare supporting actions (Flow, Apex, Prompt Builder template)
  7. Configure inputs / outputs carefully
  8. Validate dependencies and template status
  9. Publish, then activate

What it can do on your machine

Read from SKILL.md and the folder at commit 53c9956. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • sf

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires API v66.0+ (Spring '26)

    From compatibility in the SKILL.md frontmatter.

Context cost

Sf AI Agentforce loads about 2.6k tokens when it runs, and up to ~20k if it reads all its reference files. Until then it costs about 141 tokens; SKILL.md has 919 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~141
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~20k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Jaganpro/sf-skills at commit 53c9956, republished under its MIT licence (© Jaganpro). 919 words, ~2,564 tokens.

Download SKILL.mdSave it as .claude/skills/sf-ai-agentforce/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
sf-ai-agentforce
description
Agentforce Builder metadata path for Builder-managed topics/actions, Prompt Builder templates, GenAiFunction/GenAiPlugin, Models API, and custom Lightning types. TRIGGER when: user maintains or configures Builder metadata agents, creates topics/actions, works with Prompt Builder templates, or touches .genAiFunction, .genAiPlugin, or .genAiPromptTemplate metadata XML files. DO NOT TRIGGER when: Agent Script DSL .agent files (use sf-ai-agentscript), agent testing (use sf-ai-agentforce-testing), or persona design (use sf-ai-agentforce-persona).
compatibility
Requires API v66.0+ (Spring '26)
license
MIT
metadata.version
2.2.0
metadata.author
Jag Valaiyapathy

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, Prompt Builder templates stored as GenAiPromptTemplate metadata, Models API usage from Apex, and custom Lightning types.

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

If the work produces or edits a .agent file — including Builder Script / Canvas work that results in an authoring bundle — use 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 GenAiPromptTemplate metadata
  • wiring Builder topics to Flow / Apex / Prompt Builder actions
  • using Models API or LightningTypeBundle in the context of Builder-based agents

Do not use it for:


Required Context to Gather First

Ask for or infer:

  • whether this is a Builder / Setup UI project or a code-first Agent Script project
  • whether the user is editing Builder metadata or a .agent authoring bundle
  • agent type: Service Agent or Employee Agent
  • whether the work targets topics, actions, Prompt Builder templates, 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

PathSkillBest fit
Builder metadata pathsf-ai-agentforceDeclarative maintenance, existing Builder agents, metadata-driven action registration
Agent Script authoring bundle pathsf-ai-agentscriptCode-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.


Builder Workflow Summary

  1. Confirm this is a Builder / Setup UI project
  2. Pick Service Agent vs Employee Agent
  3. For Service Agents, provision the running user (prefer sf org create agent-user)
  4. For Employee Agents, plan visibility with a Permission Set containing <agentAccesses>
  5. Define topics with strong descriptions, scope, and instructions
  6. Prepare supporting actions (Flow, Apex, Prompt Builder template)
  7. Configure inputs / outputs carefully
  8. Validate dependencies and template status
  9. 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 typeTypical useRegistered via
Flowsafest default for Builder actionsGenAiFunction
Apexcomplex business logic via @InvocableMethodGenAiFunction
Prompt Builder templategenerated summaries / drafts / recommendationsGenAiFunction
Prompt Template vs GenAiPromptTemplate
  • Prompt Template is the plain-English / UI term used in Prompt Builder.
  • GenAiPromptTemplate is the current Metadata API type for source-driven template work.
  • Prefer current source format: genAiPromptTemplates/*.genAiPromptTemplate-meta.xml.
  • For flexible Prompt Builder templates, plan around the 5-input maximum and consolidate inputs when needed.
  • Prompt content should reference inputs with the current merge-field shape, e.g. {!$Input:TargetRecord} or {!$Input:AdditionalContext}.
Supporting metadata deploys first

Before publishing the agent itself, deploy the supporting stack:

  1. metadata / fields if needed
  2. Apex if needed
  3. Flows if needed
  4. GenAiPromptTemplate / GenAiFunction / GenAiPlugin
  5. then publish the agent
Service Agent running user

For Service Agents, prefer the native GA command: sf org create agent-user --target-org <alias> --json Use the returned username in the running-user configuration.

Employee Agent visibility

For Employee Agents, ensure end users receive a Permission Set containing <agentAccesses>. Without this, the agent can be active but still invisible in Lightning Experience. See ../sf-permissions/references/agent-access-guide.md.

Show full SKILL.md (366 more words)Show less
Publish does not activate

After publish, run sf agent activate separately. For automation, prefer sf agent activate --api-name <AgentName> --version <n> --target-org <alias> --json so the rollout is deterministic and machine-readable.


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.

GenAiPromptTemplate

Use for generated content, not deterministic business rules.

Prefer the current metadata shape:

  • metadata type: GenAiPromptTemplate
  • folder: genAiPromptTemplates/
  • file suffix: .genAiPromptTemplate-meta.xml
  • content lives under templateVersions
  • use published template versions before wiring actions that depend on them
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 references:


Cross-Skill Integration

text
sf-metadata → sf-apex → sf-flow → sf-ai-agentforce → sf-deploy
Required delegations
RequirementDelegate toWhy
Create / fix Flowssf-flowAction target creation and Flow validation
Create / fix Apex actionssf-apex@InvocableMethod and Apex correctness
Deploy / publishsf-deployDeployment orchestration
Test the agentsf-ai-agentforce-testingFormal test execution and assertions
Employee Agent visibility / accesssf-permissionsPermission Set <agentAccesses> setup

High-Signal Failure Patterns

SymptomLikely causeRead next
Action not available in Buildertarget metadata missing or not deployedreferences/metadata-reference.md
Prompt action fails during publish or activationtemplate is Draft, missing inputs, or old metadata shape is being usedreferences/genaiprompttemplate.md
Need more than 5 template inputsflex template input limit hitreferences/genaiprompttemplate.md
Apex AI logic times outModels API work placed in the wrong contextreferences/models-api.md
Rich input/output UI not renderingLightning type config or prerequisites are incompletereferences/custom-lightning-types.md
Agent publishes but is not usableforgot explicit activationreferences/cli-commands.md
Service Agent publish/runtime failuremissing or invalid running user../sf-ai-agentscript/references/agent-user-setup.md
Employee Agent active but not visible to usersmissing <agentAccesses> permission set../sf-permissions/references/agent-access-guide.md

Reference Map

Start here
Terminology and template planning
Rubric
Cross-skill reads

Score Guide

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

Full rubric: references/scoring-rubric.md

© Jaganpro, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (references) in skills/sf-ai-agentforce of Jaganpro/sf-skills.

  • SKILL.md
  • CREDITS.md
  • LICENSE
  • README.md
  • references/builder-workflow.md
  • references/cli-commands.md
  • references/custom-lightning-types.md
  • references/genaiprompttemplate.md
  • references/metadata-reference.md
  • references/models-api.md
  • references/prompt-templates.md
  • references/scoring-rubric.md

Open the folder on GitHubat commit 53c9956

Compare with similar skills

Sf AI Agentforce next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sf AI Agentforce compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sf AI Agentforce this skillJaganpro/sf-skills424—~2.6kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Diagnosing Superpowers Sessionsobra/superpowers297k3 repos~1.7kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Skill Release Gaterohitg00/ai-engineering-from-scratch66k—~1kAutomated safety check: PassMIT
CodeGraph Agent Evalcolbymchenry/codegraph74k—~950Automated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Investigates a session where Superpowers went wrong, reads the transcripts on disk and produces an evidence-cited report, optionally prepared as a bug report for the maintainers.

    297k GitHub starsUsed in 3 repos~1.7k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    66k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • CodeGraph Agent Eval

    colbymchenry/codegraph

    Benchmarks how much CodeGraph helps a coding agent on a real repository, comparing runs with and without it for a chosen local or published version.

    74k GitHub stars~950 tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Mines local Copilot CLI session logs for dotnet/maui to rank costly or failing runs, tag recurring failure modes, propose repo edits and emit guard evals.

    23k GitHub stars~3.4k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from Jaganpro/sf-skills

All 36 skills in this repo
  • Agentforce session tracing extraction and analysis. An agent skill from Jaganpro/sf-skills.

    424 GitHub stars~1.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Sf AI Agentscript

    Jaganpro/sf-skills

    Agent Script DSL for deterministic Agentforce agents. An agent skill from Jaganpro/sf-skills.

    424 GitHub stars~3.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Sf Datacloud

    Jaganpro/sf-skills

    Salesforce Data Cloud product orchestrator for connect→prepare→harmonize→segment→act workflows.

    424 GitHub stars~2.7k tokensUpdated 5 mo ago
    Auto-check passed
  • Sf Diagram Mermaid

    Jaganpro/sf-skills

    Salesforce architecture diagrams using Mermaid with ASCII fallback.

    424 GitHub stars~1.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Sf Diagram Nanobananapro

    Jaganpro/sf-skills

    AI-powered image generation for Salesforce visuals via Nano Banana Pro.

    424 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Sf Flow

    Jaganpro/sf-skills

    Creates and validates Salesforce Flows with 110-point scoring.

    424 GitHub stars~1.8k tokensUpdated 5 mo ago
    Auto-check passed

Categories

Questions about Sf AI Agentforce

What does Sf AI Agentforce do?

Agentforce Builder metadata path for Builder-managed topics/actions, Prompt Builder templates, GenAiFunction/GenAiPlugin, Models API, and custom Lightning types. Sf AI Agentforce is an agent skill from Jaganpro/sf-skills. Agentforce Builder metadata path for Builder-managed topics/actions, Prompt Builder templates, GenAiFunction/GenAiPlugin, Models API, and custom Lightning types.

When should I use Sf AI Agentforce?

Sf AI Agentforce fits situations like: : user maintains; configures Builder metadata agents; creates topics/actions; works with Prompt Builder templates.

How do I install Sf AI Agentforce in Claude Code?

Run `npx skills add Jaganpro/sf-skills --skill sf-ai-agentforce -a claude-code`. Or copy the skill folder (skills/sf-ai-agentforce in Jaganpro/sf-skills) into .claude/skills/sf-ai-agentforce in your project. Claude Code loads it when a task matches its description.

How do I install Sf AI Agentforce in Codex?

Run `npx skills add Jaganpro/sf-skills --skill sf-ai-agentforce -a codex`. Or copy the skill folder (skills/sf-ai-agentforce in Jaganpro/sf-skills) into .agents/skills/sf-ai-agentforce in your project. Codex loads it when a task matches its description.

Can I use Sf AI Agentforce in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Jaganpro/sf-skills --skill sf-ai-agentforce -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sf-ai-agentforce, .gemini/skills/sf-ai-agentforce, .github/skills/sf-ai-agentforce and .opencode/skills/sf-ai-agentforce in your project.

What does Sf AI Agentforce need to run?

Going by SKILL.md and its folder, Sf AI Agentforce needs the command-line tools its instructions call (sf). Compatibility (from SKILL.md): Requires API v66.0+ (Spring '26).

Does Sf AI Agentforce access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sf AI Agentforce safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sf AI Agentforce use?

Sf AI Agentforce is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sf AI Agentforce use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 18k tokens, read only when the agent opens those files.

What are the alternatives to Sf AI Agentforce?

Skills that share tags, products or a category with Sf AI Agentforce: MCP Server Builder (anthropics/skills, 180k stars), Diagnosing Superpowers Sessions (obra/superpowers, 297k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Skill Release Gate (rohitg00/ai-engineering-from-scratch, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sf AI Agentforce?

Jaganpro (a GitHub user) maintains it in Jaganpro/sf-skills, which has 424 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on April 27, 2026.

Source: Jaganpro/sf-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.