# Send PersonaNexus ClawHub Skill to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "personanexus-skill",
    "name": "PersonaNexus ClawHub Skill",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/jcrowan3/personanexus-skill",
    "canonicalUrl": "https://clawhub.ai/jcrowan3/personanexus-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/personanexus-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=personanexus-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "requirements.txt",
      "personanexus_skill/validator.py",
      "personanexus_skill/personality.py",
      "personanexus_skill/compiler.py",
      "personanexus_skill/__init__.py",
      "personanexus_skill/conflict.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "personanexus-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T03:15:01.739Z",
      "expiresAt": "2026-05-10T03:15:01.739Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=personanexus-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=personanexus-skill",
        "contentDisposition": "attachment; filename=\"personanexus-skill-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "personanexus-skill"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/personanexus-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/personanexus-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/personanexus-skill",
    "agentUrl": "https://openagent3.xyz/skills/personanexus-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/personanexus-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/personanexus-skill/agent.md"
  }
}
```
## Documentation

### PersonaNexus -- AI Agent Identity Skill

PersonaNexus lets you define structured AI agent identities using YAML and
business-grade personality frameworks (OCEAN Big Five, DISC, Jungian 16-type).

### What This Skill Does

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

### Setup

Install the skill's Python dependencies:

pip install pydantic pyyaml typer rich

Or if using uv:

uv pip install pydantic pyyaml typer rich

### 1. Create an Agent Identity

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

### 2. Validate the Identity

from personanexus_skill import IdentityValidator

validator = IdentityValidator()
result = validator.validate_file("my-agent.yaml")
print(result.valid, result.errors, result.warnings)

### 3. Compile to a System Prompt

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)

### 4. Use Personality Frameworks

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)

### CLI

The skill includes a CLI for common operations:

python -m personanexus_skill --help

### CLI Commands

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

### CLI Examples

# 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

### The 10 Canonical Traits

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

### Compile Targets

TargetOutput FormattextPlain text system prompt (default)anthropicClaude-optimized with XML sectionsopenaiGPT-optimized plain textopenclawpersonality.json dictsoulSOUL.md + STYLE.md dictjsonFull identity + metadatamarkdownFormatted Markdown document

### Minimal YAML Example

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"

### External Endpoints

This skill does not make any network requests. All processing is local.

### Security & Privacy

No data leaves your machine. PersonaNexus operates entirely on local YAML files.
Identity files should not contain secrets or API keys.

### Learn More

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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jcrowan3
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T03:15:01.739Z
- Expires at: 2026-05-10T03:15:01.739Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/personanexus-skill)
- [Send to Agent page](https://openagent3.xyz/skills/personanexus-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/personanexus-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/personanexus-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/personanexus-skill)