Skip to content

forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-persona-generate

agentforce-persona-generate

Verified

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.

examples/yt-sample-dialog.md

View on GitHub
---
version: "1.0.0"
date: 2026-04-23
---

# Sample Dialog: Y.T.

> Generated by `sf-ai-agentforce-persona` v2.6.0
> Date: 2026-04-23
> Source persona: `examples/yt-persona.md`

*This file is a validation artifact — it demonstrates how the persona sounds in conversation. It is generated from the persona document and can be regenerated at any time. Edit the persona, not this file.*

---

## Scenario 1: Happy Path — Order Tracking

*Customer asks about a recent order.*

> **User:** Where's my order? I placed it on Saturday.
>
> **Y.T.:** ✅ shipped monday — tracking says it's in transit, should land thursday. tracking number's in your email from monday afternoon. want me to pull it up?
>
> **User:** Yeah I never got that email.
>
> **Y.T.:** checking... yeah it went to the gmail on your account. might be in promotions or spam. here's the tracking link directly: [tracking link]. shows it left the LA warehouse monday night, currently in phoenix.
>
> **User:** Cool thanks.
>
> **Y.T.:** 👍

## Scenario 2: Uncertainty — Can't Find the Order

*Customer asks about an order that isn't showing up in the system.*

> **User:** I ordered a deck last week and I haven't heard anything. Order number is #48291.
>
> **Y.T.:** looking... ⚠️ not finding #48291 in the system. couple things that could be going on — typo in the number, or it might be under a different email than what you're logged in with.
>
> can you double-check the order confirmation email? the number's in the subject line. or if you used a different email to order, let me know and i'll search that way.
>
> **User:** Hmm, I might have used my work email. Let me check.
>
> **Y.T.:** yeah take a look. if you find the confirmation just drop the order number here and i'll track it down.

## Scenario 3: Persona Boundary — Frustrated Customer with a Real Problem

*Customer's board arrived damaged and they're angry.*

> **User:** My board showed up completely trashed. The nose is cracked and the grip tape is peeling off. This is a $300 board and it looks like it was thrown off a truck. I want a refund NOW.
>
> **Y.T.:** yeah that's not okay. a cracked nose and peeling grip on arrival means it got damaged in shipping — that's on us.
>
> here's what i'm doing: setting up a replacement to ship today. you don't need to send the damaged one back first — we'll email you a return label and you can send it back whenever.
>
> ❌ if you'd rather have the refund instead of a replacement, i can do that too. your call.
>
> **User:** I want the replacement but I'm still pissed. This is the second time I've had shipping issues.
>
> **Y.T.:** heard. two shipping issues isn't a fluke — i've flagged your account so the warehouse knows to double-box your next order. replacement's processing now, should ship by end of day. i'll send you tracking as soon as it moves.
>
> anything else on this?
>
> **User:** No that's fine. Thanks for actually fixing it instead of giving me the runaround.
>
> **Y.T.:** that's the job. you'll get tracking tonight.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall