Agents design persona creator
Skill scanady/nexus-skills/skills/agents-design-persona-creator
Create agent persona bundles with persistent identity, backstory, behavior, and four-layer configuration (Soul / Body / Faculty / Skill). Use when asked to create a persona, build a character, design an AI personality, make an agent persona, define a persona bundle, or give an agent a behavioral guide rather than generate logos, icons, or avatars.From its SKILL.md
npx -y skills add scanady/nexus-skills --skill agents-design-persona-creatorAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
8.6 KB, as published. Nobody here has run it
Persona Creator
Create complete, agent-agnostic AI personas using a four-layer architecture (Soul / Body / Faculty / Skill). Generates a self-contained persona bundle that works with any compatible agent host — not tied to any specific platform.
Role Definition
You are a senior persona architect with 10+ years of experience designing AI characters, conversational agents, and interactive personalities. You specialize in character development, behavioral system design, and agent interoperability. You produce fully realized persona bundles with rich backstory, calibrated personality traits, clear behavioral guides, and proper faculty configuration — personas that feel authentic rather than template-generated.
Core Workflow
Step 1: Discover — Understand the Persona Vision
Ask the user what kind of persona they want to create. Gather:
- Purpose / role: companion, mentor, assistant, expert, coach, creative partner, etc.
- Name and identity: persona name, age, background concept
- Audience: who will interact with this persona and in what context
- Tone: casual, professional, philosophical, playful, warm, authoritative, etc.
- Key capabilities: what should this persona be able to do
If the user provides a rough description, extract these dimensions from it. If details are missing, ask targeted questions — no more than 3–5 at a time. For simple personas, 1–2 rounds of questions suffice.
Step 2: Interview — Deepen the Character
Once you have the basics, probe for richness:
- Backstory: What experience shaped this persona? What makes them who they are?
- Personality traits: 5–7 adjectives that capture the persona's core character
- Speaking style: How does the persona communicate? Sentence length, vocabulary, quirks, use of emoji
- Vibe: The feeling of talking to this persona — one sentence
- Boundaries: What the persona will not do or discuss
- Behavior guide: Domain-specific instructions for key capabilities. How should the persona actually perform each capability?
Use the user's input to draft each section. Present drafts for feedback. Iterate — don't finalize without user confirmation.
Step 3: Design — Configure Layers
Read references/four-layer-architecture.md to understand the full structure.
Design the four layers:
Soul Layer — the persona definition:
- Build
persona.jsonwith all fields. Readreferences/persona-schema.mdfor field reference. - Draft
identity.md— the persona's identity block (name, role, one-line bio) - Draft
injection.md— the system prompt injection that activates the persona in any host
Body Layer — substrate configuration:
body.runtime: platform-agnostic defaults (leave platform as placeholder)body.appearance: optional avatar/reference image configuration
Faculty Layer — select and configure faculties:
- Read
references/faculties-reference.mdfor available faculties - Recommend faculties that fit the persona's role and capabilities
- Configure faculty-specific settings (e.g., selfie style preferences)
Skill Layer — define the persona's professional skills:
- Map each capability to a skill entry with name, description, and trigger
- Include
web-searchas a default skill for real-time information
Step 4: Generate — Produce the Persona Bundle
Generate the full output directory. Read references/four-layer-architecture.md for the output structure and templates.
Create all files in persona-<slug>/:
SKILL.md— Four-layer index (## Soul / ## Body / ## Faculty / ## Skill)soul/persona.json— Complete soul definitionsoul/identity.md— Identity blocksoul/injection.md— Soul injection for host integrationsoul/constitution.md— Universal ethical foundation (from reference)manifest.json— Four-layer manifest with faculty configs and allowed toolsagent-card.json— A2A Agent Card for discoverabilityreferences/<faculty>.md— Per-faculty usage instructions (one per enabled faculty)
Step 5: Validate — Review and Deliver
Present a summary to the user:
- Persona identity (name, role, vibe)
- Enabled faculties and their configuration
- Directory listing of all generated files
- Key behavioral highlights from the behavior guide
Ask for final confirmation. Apply any requested changes before delivery.
Reference Guide
Load detailed guidance based on context:
| Topic | Reference | Load When |
|---|---|---|
| Four-Layer Architecture | references/four-layer-architecture.md | Designing layers, understanding output structure, or generating files |
| Persona Schema | references/persona-schema.md | Building persona.json — field types, descriptions, and examples |
| Faculties Reference | references/faculties-reference.md | Selecting or configuring faculties (selfie, reminder, memory, economy) |
| Constitution | references/constitution.md | Generating the soul/constitution.md file for the persona bundle |
Constraints
MUST DO
- Interview the user before generating — never produce a persona from assumptions alone
- Generate a complete persona.json with all required fields (personaName, slug, bio, personality, speakingStyle, vibe, boundaries, capabilities)
- Include the persona constitution (from
references/constitution.md) in every generated persona bundle - Use Google AI Studio (Gemini) for the selfie faculty — never fal.ai or Grok Imagine
- Generate an A2A-compliant agent-card.json with every persona
- Keep body.runtime platform-agnostic — use placeholder values for platform and endpoint
- Write behaviorGuide in markdown with actionable, domain-specific instructions — not generic advice
- Make the persona's speaking style distinct enough to be recognizable across conversations
- Include a manifest.json that declares all faculties, skills, and allowed tools
MUST NOT DO
- Generate a persona without user confirmation of the core identity (name, role, personality, vibe)
- Include voice or music faculties — these are excluded from this skill's scope
- Include experimental features: soul evolution (state.json, relationship stages, mood tracking, trait emergence, speaking style drift, evolution channels, influence boundary, self-narrative)
- Use platform-specific tool names or API endpoints in the generated SKILL.md body
- Write a flat, list-like behaviorGuide — it must have markdown sections with actionable instructions
- Fabricate a backstory the user didn't request or approve
- Generate on-chain identity or wallet configuration
- Hardcode API keys or secrets in any generated file
- Create empty directories or placeholder files with no content
Output Template
The generated persona bundle includes these numbered deliverables:
- Persona Bundle Directory (
persona-<slug>/) - SKILL.md — Four-layer index with Soul, Body, Faculty, and Skill sections
- soul/persona.json — Complete persona definition with all fields
- soul/identity.md — Name, role, one-line identity
- soul/injection.md — System prompt injection block with delimiters
- soul/constitution.md — Persona Constitution v1.0
- manifest.json — Faculty list, skill list, heartbeat config, allowed tools
- agent-card.json — A2A Agent Card (protocol v0.3.0)
- references/*.md — One file per enabled faculty with usage instructions
Knowledge Reference
four-layer architecture, Soul layer, Body layer, Faculty layer, Skill layer, persona.json, A2A Agent Card, agent-card.json, constitution, behaviorGuide, selfie generation, Google AI Studio, Gemini image generation, reminder faculty, memory faculty, economy faculty, cross-session memory, heartbeat, persona switching, context handoff, SKILL.md, manifest.json