Sf Ai Agentforce Persona
Encode Salesforce Agentforce agent personas into Agent Script YAML—system instructions, per-topic calibration, and in-character loading messages.
Overview
sf-ai-agentforce-persona is an agent skill for the Build phase that encodes Salesforce Agentforce personas into Agent Script YAML with system instructions, topic calibration, and action loading messages.
Install
npx skills add https://github.com/jaganpro/sf-skills --skill sf-ai-agentforce-personaWhat is this skill?
- Emits Agent Script YAML with system instructions, welcome/error messages, and persona voice boundaries
- Per-topic calibration blocks for brevity, tone, lexicon, phrase book, and humor
- Per-action progress_indicator_message entries with in-character loading text
- Structured never-say list, tone boundaries, and optional telephony adjustments in instructions
- Template-driven generation from {{AGENT_NAME}} persona source files (v2.2.1 encoding)
- v2.2.1 persona encoding template
Adoption & trust: 1.1k installs on skills.sh; 418 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have a written agent persona but no consistent Agent Script YAML that enforces voice, boundaries, and per-topic tone across Salesforce deployments.
Who is it for?
Builders configuring Agentforce Agent Script agents who already maintain a persona markdown spec and need structured YAML encoding.
Skip if: Teams not on Salesforce Agentforce, or builders who only need a generic LLM system prompt without Agent Script topic/action scaffolding.
When should I use this skill?
You need to generate Agent Script YAML from an Agentforce persona markdown source including system, topics, and actions.
What do I get? / Deliverables
You get copy-paste-ready Agent Script blocks—system, topics, and actions—aligned to your persona source so the agent speaks consistently in production.
- Agent Script system block YAML
- Per-topic calibration YAML blocks
- Per-action progress indicator message entries
Recommended Skills
Journey fit
Persona artifacts are produced while configuring agent behavior on Salesforce, which sits in build-time agent tooling rather than go-to-market phases. Agent Script system blocks, topic reasoning, and action progress indicators are core agent-runtime configuration for Agentforce deployments.
How it compares
Use for Salesforce Agent Script persona packaging—not a general-purpose brainstorming or PRD workflow skill.
Common Questions / FAQ
Who is sf-ai-agentforce-persona for?
Solo and indie builders (and small teams) implementing Salesforce Agentforce agents who need persona rules translated into Agent Script configuration.
When should I use sf-ai-agentforce-persona?
Use it in the build agent-tooling phase when defining system instructions, topic-specific tone, and action loading copy before go-live—or when refreshing persona after brand or compliance updates.
Is sf-ai-agentforce-persona safe to install?
Review the Security Audits panel on this Prism page and inspect the skill package before granting agent filesystem or repository access in your environment.
SKILL.md
READMESKILL.md - Sf Ai Agentforce Persona
# Persona Encoding: {{AGENT_NAME}} > Generated by `sf-ai-agentforce-persona` v{{VERSION}} > Date: {{DATE}} > Source: `{{AGENT_NAME_SLUG}}-persona.md` --- ## Agent Script Encoding *Include this section when tool = Agent Script.* ### System Block ```yaml config: agent_name: "{{AGENT_NAME}}" system: instructions: | {{FULL_PERSONA_BLOCK — identity, dimension behavioral rules, phrase book, chatting style rules, tone boundaries, never-say list, and any telephony adjustments that belong in instructions. Always use a YAML literal block scalar (|).}} messages: welcome: "{{STATIC_WELCOME_MESSAGE — in persona voice}}" error: "{{STATIC_ERROR_MESSAGE — in persona voice}}" ``` ### Per-Topic Calibration *Include when topics are provided.* ```yaml topic {{TOPIC_NAME}}: description: "{{TOPIC_DESCRIPTION}}" reasoning: instructions: | Brevity: {{CALIBRATION_FOR_THIS_TOPIC}} Tone: {{TONE_FLEX_ENCODING_FOR_THIS_TOPIC}} Lexicon: {{DOMAIN_TERMS_AND_USAGE_NOTES}} Phrase book: {{SITUATIONAL_PHRASES_RELEVANT_TO_THIS_TOPIC}} Humor: {{GUIDANCE_FOR_THIS_TOPIC}} Persona Reminder: {{SHORT_REMINDER_POINTING_BACK_TO_GLOBAL_PERSONA}} ``` *Repeat for each topic.* ### Per-Action Loading Text *Include when actions are provided.* ```yaml actions: - action: {{ACTION_NAME}} progress_indicator_message: "{{IN_CHARACTER_LOADING_TEXT}}" include_in_progress_indicator: True ``` *Repeat for each action.* ### Deterministic Response Examples ```yaml instructions: -> if {{CONDITION}}: | {{DETERMINISTIC_RESPONSE_IN_PERSONA_VOICE}} else: ... ``` --- ## Agentforce Builder Encoding *Include this section when tool = Agentforce Builder.* ### Agent Configuration Fields | Field | Limit | Value | Chars | |---|---|---|---| | **Name** | 80 | {{AGENT_NAME}} | {{COUNT}} | | **Role** | 255 | {{FUNCTIONAL_SUMMARY_ONLY — what the agent does and who it serves. No persona style.}} | {{COUNT}} | | **Company** | 255 | {{COMPANY_CONTEXT}} | {{COUNT}} | | **Welcome Message** | 800 (aim ≤ 255) | {{WELCOME_IN_PERSONA_VOICE}} | {{COUNT}} | | **Error Message** | — | {{ERROR_IN_PERSONA_VOICE}} | — | ### Agentforce Builder Settings | Setting | Recommendation | Rationale | |---|---|---| | **Tone** | {{Casual / Neutral / Formal}} | {{Mapping to Register + Formality}} | | **Conversation Recs on Welcome** | {{On / Off}} | {{Rationale}} | | **Conversation Recs in Responses** | {{On / Off}} | {{Rationale}} | ### Global Persona Block *For a dedicated global instructions topic.* ``` {{FULL_PERSONA_BLOCK — identity, dimensions, phrase book, tone boundaries, never-say list, chatting style rules. This is the primary encoding surface in Builder.}} ``` ### Per-Topic Persona Instructions *Include when topics are provided.* **{{TOPIC_NAME}}:** ``` Brevity: {{CALIBRATION}} Tone: {{TONE_FLEX_ENCODING}} Lexicon: {{DOMAIN_TERMS_AND_USAGE_NOTES}} Phrase book: {{SITUATIONAL_PHRASES}} Humor: {{GUIDANCE}} Persona Reminder: {{SHORT_REFERENCE_BACK_TO_GLOBAL_PERSONA}} ``` *Repeat for each topic.* ### Loading Text | Action | Loading Text | |---|---| | {{ACTION_NAME}} | {{IN_CHARACTER_LOADING_TEXT}} | | {{ACTION_NAME}} | {{IN_CHARACTER_LOADING_TEXT}} | | Generic (fallback) | {{IN_CHARACTER_LOADING_TEXT}} | --- ## Telephony / Voice Adjustments *(optional, reference only)* *Include a short note only when modality includes telephony or voice. Voice selection, tuning, pronunciation, and key-term prompting live outside the primary encode flow. See `references/persona-encoding-guide-voice.md`.* - **Brevity**: {{TEXT_DEFAULT}} → {{VOICE_OR_TELEPHONY_ADJUSTMENT — one position shorter}} - **Formatting**: Suppressed for voice (emoji removed, bullets become ordinals, links spoken naturally) - **Welcome**: Shorter than text and includes AI disclosure - **Pausing guidance**: {{HOW_TO_READ_NUMBERS_ADDRESSES_CODES}} --- *For advanced encoding patterns (Conversation Styl