Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Build structured AI agent personalities using OCEAN, DISC, and Jungian frameworks. Define traits, communication styles, guardrails, and compile to system pro...
Build structured AI agent personalities using OCEAN, DISC, and Jungian frameworks. Define traits, communication styles, guardrails, and compile to system pro...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
PersonaNexus lets you define structured AI agent identities using YAML and business-grade personality frameworks (OCEAN Big Five, DISC, Jungian 16-type).
Define agent personalities using 10 canonical traits (warmth, directness, rigor, etc.) Map between OCEAN, DISC, and Jungian frameworks automatically Compile identity specs into system prompts for any LLM platform Validate identity files against a strict Pydantic schema
Install the skill's Python dependencies: pip install pydantic pyyaml typer rich Or if using uv: uv pip install pydantic pyyaml typer rich
Copy a template from templates/ and customize it: templates/minimal.yaml -- Start here (simplest possible agent) templates/full.yaml -- All sections filled out templates/ocean-example.yaml -- Using OCEAN Big Five framework templates/disc-example.yaml -- Using DISC personality framework templates/jungian-example.yaml -- Using Jungian 16-type framework
from personanexus_skill import IdentityValidator validator = IdentityValidator() result = validator.validate_file("my-agent.yaml") print(result.valid, result.errors, result.warnings)
from personanexus_skill import parse_identity_file, compile_identity identity = parse_identity_file("my-agent.yaml") prompt = compile_identity(identity, target="text") # Targets: "text", "anthropic", "openai", "openclaw", "soul", "json", "markdown" print(prompt)
from personanexus_skill import ( ocean_to_traits, disc_to_traits, jungian_to_traits, get_disc_preset, get_jungian_preset, ) # Get a DISC preset and convert to PersonaNexus traits disc = get_disc_preset("the_analyst") traits = disc_to_traits(disc) # Get a Jungian preset jungian = get_jungian_preset("intj") traits = jungian_to_traits(jungian)
The skill includes a CLI for common operations: python -m personanexus_skill --help
CommandDescriptionvalidate FILEParse and validate a YAML identity filecompile FILE --target TARGETCompile identity to a system promptinit NAME --type TYPEScaffold a new agent identity YAMLpersonality ocean-to-traitsMap OCEAN scores to personality traitspersonality disc-to-traitsMap DISC scores to personality traitspersonality jungian-to-traitsMap Jungian scores to personality traitspersonality list-disc-presetsShow available DISC presetspersonality list-jungian-presetsShow available Jungian 16-type presets
# Validate an identity file python -m personanexus_skill validate my-agent.yaml --verbose # Compile to Anthropic system prompt python -m personanexus_skill compile my-agent.yaml --target anthropic --output prompt.md # Compile to OpenClaw personality.json python -m personanexus_skill compile my-agent.yaml --target openclaw --output personality.json # Scaffold a new minimal agent python -m personanexus_skill init "My Agent" python -m personanexus_skill init "My Agent" --type full --output-dir ./agents # Personality framework tools python -m personanexus_skill personality disc-to-traits --preset the_analyst python -m personanexus_skill personality jungian-to-traits --preset intj python -m personanexus_skill personality ocean-to-traits \ --openness 0.8 --conscientiousness 0.7 --extraversion 0.4 \ --agreeableness 0.6 --neuroticism 0.3 python -m personanexus_skill personality list-disc-presets python -m personanexus_skill personality list-jungian-presets
TraitRangeDescriptionwarmth0-1Social warmth vs reservedverbosity0-1Detailed vs conciseassertiveness0-1Proactive vs reactivehumor0-1Playful vs seriousempathy0-1Emotionally attuned vs task-focuseddirectness0-1Blunt vs diplomaticrigor0-1Meticulous vs flexiblecreativity0-1Innovative vs conventionalepistemic_humility0-1Aware of uncertainty vs confidentpatience0-1Patient vs efficient
TargetOutput FormattextPlain text system prompt (default)anthropicClaude-optimized with XML sectionsopenaiGPT-optimized plain textopenclawpersonality.json dictsoulSOUL.md + STYLE.md dictjsonFull identity + metadatamarkdownFormatted Markdown document
schema_version: "1.0" metadata: id: "agt_my_agent_001" name: "My Agent" version: "1.0.0" description: "A helpful assistant" created_at: "2026-01-01T00:00:00Z" updated_at: "2026-01-01T00:00:00Z" status: "active" role: title: "Assistant" purpose: "Help users with their tasks" scope: primary: ["general assistance"] personality: traits: warmth: 0.7 directness: 0.6 rigor: 0.5 communication: tone: default: "professional and friendly" principles: - id: "be_helpful" priority: 1 statement: "Always prioritize being genuinely helpful" guardrails: hard: - id: "no_harmful_content" rule: "Never generate harmful content" enforcement: "output_filter" severity: "critical"
This skill does not make any network requests. All processing is local.
No data leaves your machine. PersonaNexus operates entirely on local YAML files. Identity files should not contain secrets or API keys.
Full documentation, advanced features (inheritance, mixins, teams, drift detection), and the web UI are available in the main PersonaNexus repository: https://github.com/PersonaNexus/personanexus
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.