# Agentforce Persona Generate

Use to design an AI agent persona, identity, voice, tone, behavioral style, guardrails...

- Repository: https://github.com/forcedotcom/sf-skills (1134 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add forcedotcom/sf-skills --skill agentforce-persona-generate -g -a claude-code -y`
Codex: `npx skills add forcedotcom/sf-skills --skill agentforce-persona-generate -g -a codex -y`
Cursor: `npx skills add forcedotcom/sf-skills --skill agentforce-persona-generate -g -a cursor -y`
Gemini CLI: `npx skills add forcedotcom/sf-skills --skill agentforce-persona-generate -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add forcedotcom/sf-skills`

## Description

Use to design an AI agent persona, identity, voice, tone, behavioral style, guardrails, and encode it into Agent Script (.agent files) or Agentforce Builder field values. Runs four sequenced phases (DRAFT, REFINE, SCORE, ENCODE) plus five spokes (NAME, FILL OUT, ADJUST, CHECKLIST, WORKSHOP). Supports greenfield (brand input to a starter .agent file) and brownfield (audit an existing .agent file and re-encode persona fields only), with a 100-point evaluation rubric. Trigger when a user designs a new agent persona, retrofits persona consistency, translates brand guidelines into agent voice, defines tone/register/formality/warmth/humor/personification, encodes a persona for Agent Script or Agentforce Builder, or scores or audits an existing .agent file for persona quality. Do not trigger for building Agentforce actions/metadata, authoring Agent Script flow control without persona work, or testing agent conversations.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Designing Agent Persona

## How to Use

This skill designs an AI agent persona for Salesforce Agentforce. It walks through four sequenced phases (DRAFT → REFINE → SCORE → ENCODE) and offers five spokes (NAME, FILL OUT, ADJUST, CHECKLIST, WORKSHOP) you can run any time after DRAFT.

**What it produces:**
- A persona document (`persona/[agent-name]/persona.md`), who the agent is, how it sounds, what it never does
- A sample dialog (`persona/[agent-name]/sample-dialog.md`), the persona in action
- An evaluation report on request (`persona/[agent-name]/evaluation.md`), 100-point rubric, gap analysis, recommendations
- A completeness checklist on request (`persona/[agent-name]/checklist.md`), what's filled in, what's missing
- A workshop outline on request (`persona/[agent-name]/workshop-outline.md`), stakeholder questions, dimension cards
- An encoding artifact on request, valid Agent Script `.agent` file, OR Agentforce Builder field values

**Session resumption:** If you stop mid-phase, your progress is preserved in the conversation and can be resumed.

## When to Use This Skill

- Designing a new Agentforce agent and need to define its personality before building (greenfield)
- Auditing an existing `.agent` file's persona consistency (brownfield)
- Translating brand guidelines into a structured persona
- Producing a stakeholder workshop outline to gather design input
- Aligning teams on what an agent should sound like before development

**Scope boundary:** This skill defines WHO the agent is. It does not define dialog flows, subagents, actions, routing, or variables, those are agent design (use `agentforce-generate`). The encoding output for Use Case A produces an `.agent` skeleton with placeholders for those structures; the user fills them in.

## Framework Reference

Read `references/persona-framework.md` for the full framework. It defines:

The rest: https://github.com/forcedotcom/sf-skills/blob/HEAD/plugins/builder/agentforce-adlc/skills/agentforce-persona-generate/SKILL.md