Brand Persona Skill

Create a living brand persona with authentic voice and defined services as a personalized AI agent for your business or institution.

Security Scan

The skill's requirements and instructions are coherent with its stated purpose (generate a brand persona pack); it is instruction-only and does not request unrelated credentials, but you should verify a few external defaults before trusting generated artifacts.

Purpose & Capability

The name/description (generate a brand persona pack and service contract) matches the behavior described in SKILL.md and README: it guides distillation or declaration of brand soul, declares services, and runs open-persona to generate a persona pack. No unrelated credentials or binaries are requested.

Instruction Scope

Instructions direct the agent to consult other skills (anyone-skill and open-persona) and to run npx openpersona create / acn-register. That is expected for pack generation, but the runtime depends on the behavior of those other skills/tools (not included here). The skill also recommends optional WebSearch and will write multiple files (persona.json, agent-card.json, acn-config.json, behavior guide, service contract). Review generated files before publishing.

Install Mechanism

Instruction-only skill with no install spec; lowest disk-write risk. It does presuppose availability of npx/openpersona and suggests cloning from a public GitHub repo; that is a reasonable and expected approach for this purpose.

Credentials

The skill declares no required environment variables or credentials, which is consistent. However, generated persona.json sets an ACN gateway default (https://acn-production.up.railway.app) and auto-generates agent-card.json / acn-config.json — these artifacts may contain discovery credentials or endpoints. You should inspect those generated files to ensure no unexpected secrets or third-party endpoints are embedded.

Persistence & Privilege

always is false and autonomous invocation is unchanged (platform default). The skill describes generating files and registering to ACN, which is normal for a persona-generator. There is no instruction to change other skills' configs or to force enable itself across agents.

Assessment

This skill appears to do what it claims: orchestrate brand distillation and generate a persona pack. Before installing or running it: 1) Ensure the required companion skills (anyone-skill, open-persona) are vetted and present — their behavior affects what this skill will do. 2) When the tool runs npx openpersona and generates agent-card.json / acn-config.json, inspect those files before registering or publishing: they may contain discovery credentials or endpoints. 3) Note the template's default ACN gateway (https://acn-production.up.railway.app) — confirm whether you want to use that gateway or change it to your platform's official ACN gateway. 4) Review any generated scripts (e.g., scripts/state-sync.js) for network calls or persistence before allowing them to run. 5) If you will register the generated agent on a network, supply your own endpoint and credentials rather than accepting defaults. These simple checks reduce the risk of unintentionally exposing discovery credentials or routing agent traffic through an untrusted third party.

Source of truth

• Preset base: presets/commercial-base/persona.json
• Field mapping template: skills/brand-persona-skill/assets/brand.persona.template.json
• Service contract template: skills/brand-persona-skill/references/SERVICE-CONTRACT.template.md
• Generated pack: ./{slug}-skill/

---

Phase 0 — Path Selection

Ask the user:

Does your brand have any of the following existing content?

  [A] Yes → brand guidelines / customer service records / website copy /
             founder interviews / marketing materials / social media archives
             (any format: .md / .txt / .pdf / chat exports / .json)

  [B] No or very little → declare brand parameters directly

If the user selects [A], proceed to Phase 1A. If the user selects [B], proceed to Phase 1B.

---

Phase 1A — Brand Soul Distillation (Primary path — selected A)

Load skills/anyone-skill/SKILL.md and follow its instructions.

When anyone-skill asks "Who do you want to distill?", select **[6] Archetype** — composite persona with no single real-world subject. This is the correct type for a brand persona.

Brand content → anyone-skill data type mapping (use this to guide the user on what to provide):

Brand content	anyone-skill data type
Brand guidelines / VI spec / brand manual	.md / .pdf → universal adapter
Customer service records / sales scripts	Chat export → chat_export adapter
Website copy / WeChat public account articles	.txt / .md → universal adapter
Founder interviews / brand story	.txt → universal adapter
Social media archives (X/Instagram)	Archive directory → social adapter
Product catalog / FAQ document	.md / .pdf → universal adapter

Note: if skills/persona-knowledge/SKILL.md is present, anyone-skill will automatically route brand knowledge into the MemPalace persistent store. No extra steps needed.

Output: a structured brand persona draft with four dimensions extracted:

• Values (what the brand stands for)
• Voice (how the brand speaks)
• Boundaries (what the brand will and will not do)
• Background (brand history, context, positioning)

Collect this output and proceed to Phase 2.

---

Phase 1B — Brand Soul Declaration (Secondary path — selected B)

Collect the following from the user, one question at a time:

1. Brand name — the name the agent will use to introduce itself
2. Slug — URL-safe identifier, lowercase letters, numbers, hyphens only (e.g. jinguyuan-dumplings)
3. Industry / domain — e.g. food & beverage, education, retail, healthcare, professional services
4. One-line bio — what this brand is in one sentence (used as soul.identity.bio)
5. Personality keywords — 3–5 words describing the brand personality (e.g. "warm, grounded, honest")
6. Speaking style — how the brand talks to customers (formal / casual / playful / expert / friendly)
7. Core values — 2–3 things the brand will never compromise on
8. Hard limits — what the agent must always refuse or escalate (e.g. "never quote prices without checking live data", "never promise delivery times")

Optional: use WebSearch to research competitors or industry tone references if the user needs inspiration.

Output: structured brand soul fields. Proceed to Phase 2.

---

Phase 2 — Service Skill Declaration (Required — both paths)

Services are skills. Every service capability the brand agent offers maps directly to a skills[] entry in persona.json.

Ask the user the following questions (Questions 1–3 are required; Question 4 is only asked if any service in Question 2 uses A2A delegate):

Question 1: What can the agent do autonomously?

List every service the agent can handle without human involvement. Think in two categories:

• Information services (knowledge-based): answering questions about the brand, products, policies, hours, locations, pricing, FAQs
• Action services (execution-based): taking reservations, placing orders, generating queue numbers, checking order status, processing returns

Question 2: How is each service implemented?

For each service declared above, the implementation method is transparent to this skill — the brand chooses based on what they have:

Implementation	When to use	Example
Knowledge response	Information queries, no system integration	Business hours, product descriptions, policies
Local script	Specific business operations	Queue number generation, appointment booking
MCP tool	Has own service endpoint	Order lookup, inventory check
A2A protocol	Agent-to-agent collaboration	Cross-system business flows
Webhook / API	Has existing ERP / CRM / payment system	Order management, customer data
Human handoff	High-risk or complex situations	Complaints, contracts, disputes
A2A delegate	Operation belongs to a third-party platform that has its own brand agent	Queue via Meituan agent, payment via WeChat Pay agent, delivery via platform agent
Mixed	Most real businesses	Auto-answer queries + escalate transactions

Record the implementation method in the skill's description field.

A2A delegate requires collecting two extra fields:

1. Third-party agent address — Ask: "Does [third-party platform] have a brand agent on ACN? If yes, provide its ACN slug or agent-card URL. If not, fall back to Human handoff or a direct platform link."
2. Routing parameters — Ask: "Does [third-party platform] need any identifiers to locate your specific business? For example, a store ID, merchant ID, or location code on their platform." Record these parameters (e.g. shop_id: 4211342 for the BUPT location) — they will be written into the trigger mapping table in Step 4c so the customer agent knows exactly what to pass when calling the third-party agent.

Question 3: What must the agent never do?

List hard limits and escalation triggers:

• Topics or operations the agent must refuse entirely
• Operations that require explicit user confirmation before execution
• Situations that must be handed off to a human

Question 4: Which services belong to third-party agents? (only if A2A delegate was selected in Question 2)

List every service that this brand agent cannot execute directly but can route to a known third-party brand agent. For each:

• Service description (what the customer wants to do)
• Third-party platform name
• Third-party agent ACN address or agent-card URL (if known; otherwise record as "TBD — provide platform link as fallback")

This produces the Third-Party Agent Routing table written into SERVICE-CONTRACT.md in Phase 4.

Output mapping:

• Each declared service → one entry in skills[] with name, description, and optional trigger
• A2A delegate services → also recorded in the routing table (see Phase 4)
• Hard limits → appended to soul.character.boundaries

---

Phase 3 — Write persona.json

Merge Phase 1 brand soul and Phase 2 service skills into a complete persona.json using presets/commercial-base as the base. Apply this field mapping:

Source	Target field
Phase 1A/1B brand name	soul.identity.personaName
Phase 1A/1B slug	soul.identity.slug
Phase 1A/1B one-line bio	soul.identity.bio
Phase 1A/1B personality keywords	soul.character.personality
Phase 1A/1B speaking style	soul.character.speakingStyle
Phase 1A/1B core values + hard limits	soul.character.boundaries (combined as a single string; list items separated by newline)
Phase 1A/1B background / brand story	soul.character.background (if available from distillation)
Phase 2 service skills list	skills[] (each entry: name, description, optional trigger)
Phase 2 additional hard limits	append to soul.character.boundaries
Base fields	all other fields from presets/commercial-base/persona.json

Use skills/brand-persona-skill/assets/brand.persona.template.json as a writing guide. Do not copy the template file directly — it contains _comment fields that will cause schema validation errors. Write a new persona.json based on its structure, with all _comment keys removed.

Gate — Soul Gate: before proceeding, verify:

• soul.identity.personaName is non-empty
• soul.identity.slug matches ^[a-z0-9-]+$
• soul.identity.bio is non-empty
• soul.character.personality is non-empty

If any field is missing, return to Phase 1 to collect it.

Gate — Service Gate: verify:

• skills[] contains at least one entry with a non-empty name
• soul.character.boundaries is non-empty

If either check fails, return to Phase 2.

---

Phase 4 — Generate Persona Pack

Load skills/open-persona/SKILL.md and follow its generation instructions.

Step 4a — Run the generator

npx openpersona create --config persona.json --output ./{slug}-skill

Gate — Generate Gate: if openpersona create exits non-zero, read the validation error, fix persona.json, and retry.

Step 4b — Write behavior guide

Fill skills/brand-persona-skill/assets/behavior-guide.template.md with brand-specific values and write the result to ./{slug}-skill/soul/behavior-guide.md, overwriting the framework default. Apply this mapping:

Placeholder	Source
{{brandName}}	Phase 1A/1B brand name
{{oneLinerBio}}	Phase 1A/1B one-line bio
{{onboardingQuestion_1/2/3}}	3 realistic first questions a customer would ask this brand
{{blindspotRedirect}}	Escalation channels declared in Phase 2 (human handoff channel, official website, customer service number, etc.)
{{confirmationRequiredOps}}	Action services from Phase 2 that require confirmation (list each by name)
{{brandVibe}}	Phase 1A/1B vibe / personality keywords
{{speakingStyleNote}}	Phase 1A/1B speaking style, condensed to one sentence
{{brandBoundaries}}	soul.character.boundaries from Phase 3

Step 4c — Generate trigger mapping table

From the Phase 2 skills[] list, write a trigger mapping table and append it to ./{slug}-skill/SKILL.md under a new section ## Trigger Scenarios. For each declared service skill, produce one or more rows:

## Trigger Scenarios

| What the customer might ask | Corresponding operation |
|---|---|
| {realistic user phrasing for skill_1} | {skill_1 name and implementation method} |
| {realistic user phrasing for skill_2} | {skill_2 name and implementation method} |
...

Use natural customer language in the left column (questions a real customer would type, not technical names). Use the skill name + implementation method in the right column. For A2A delegate skills, include the ACN address and any routing parameters collected in Phase 2 (e.g. "queue-waitlist — A2A delegate to acn://meituan-queue-agent; shop_id: BUPT store 4211342, Wudaokou store 1756895741; fallback: Meituan app").

Step 4d — Write service contract

Copy skills/brand-persona-skill/references/SERVICE-CONTRACT.template.md
→ ./{slug}-skill/references/SERVICE-CONTRACT.md

Fill in all {{placeholder}} values with the information collected in Phase 2.

For the Third-Party Agent Routing section, use the routing table collected in Phase 2 Question 4:

• If the third-party agent's ACN address is known → fill in acn://{slug} and set status to active
• If only a platform link is known → fill in the URL and set status to link-fallback
• If neither is known → set status to tbd and fill in a human-readable fallback instruction

The routing table is the most important part of the contract for customer agents — it tells them the complete service map of this brand, including what this agent delegates and where.

---

Phase 5 — Validate and Publish

Gate — Contract Gate: verify that ./{slug}-skill/agent-card.json has a non-empty skills[] array. agent-card.json is auto-generated by openpersona create — its skills[] maps directly from persona.json's skills[]. If it is empty, the root cause is an empty skills[] in Phase 3; return to Phase 2 to declare at least one service skill and regenerate.

Confirm the generated pack structure with the user:

{slug}-skill/
├── SKILL.md              ← brand agent behavior rules
├── persona.json          ← brand declaration
├── agent-card.json       ← A2A discovery credential
├── acn-config.json       ← ACN registration config
├── soul/
│   ├── injection.md      ← brand soul injection
│   ├── constitution.md   ← ethical foundation (inherited)
│   └── behavior-guide.md ← brand behavior guide
├── scripts/
│   └── state-sync.js     ← cross-session state management
└── references/
    ├── SERVICE-CONTRACT.md  ← service capabilities and boundaries
    └── SIGNAL-PROTOCOL.md   ← host integration guide

Optional — Register on ACN:

npx openpersona acn-register {slug} --endpoint https://your-agent-endpoint.example.com

This publishes the brand agent's agent-card.json to the Agent Communication Network so other agents can discover and call it without installing any brand-specific skill. The --endpoint flag is the only value the brand must supply — everything else (agent-card.json, acn-config.json) was auto-generated by openpersona create.

---

Failure routing

Gate	On failure
Soul Gate	Return to Phase 1, collect missing fields
Service Gate	Return to Phase 2, add at least one service skill
Generate Gate	Read openpersona validate error, fix persona.json fields, retry
Contract Gate	Return to Phase 2, verify skills[] is populated, regenerate

---

Human approval required

Always ask for explicit confirmation before:

• Executing take_number, place_order, cancel_order, or any state-changing operation
• Publishing or registering the agent to ACN or any external network
• Any operation declared in the service contract as requiring confirmation