{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/personanexus-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=personanexus-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "requirements.txt",
      "personanexus_skill/validator.py",
      "personanexus_skill/personality.py",
      "personanexus_skill/compiler.py",
      "personanexus_skill/__init__.py",
      "personanexus_skill/conflict.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/personanexus-skill",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "PersonaNexus -- AI Agent Identity Skill",
        "body": "PersonaNexus lets you define structured AI agent identities using YAML and\nbusiness-grade personality frameworks (OCEAN Big Five, DISC, Jungian 16-type)."
      },
      {
        "title": "What This Skill Does",
        "body": "Define agent personalities using 10 canonical traits (warmth, directness, rigor, etc.)\nMap between OCEAN, DISC, and Jungian frameworks automatically\nCompile identity specs into system prompts for any LLM platform\nValidate identity files against a strict Pydantic schema"
      },
      {
        "title": "Setup",
        "body": "Install the skill's Python dependencies:\n\npip install pydantic pyyaml typer rich\n\nOr if using uv:\n\nuv pip install pydantic pyyaml typer rich"
      },
      {
        "title": "1. Create an Agent Identity",
        "body": "Copy a template from templates/ and customize it:\n\ntemplates/minimal.yaml -- Start here (simplest possible agent)\ntemplates/full.yaml -- All sections filled out\ntemplates/ocean-example.yaml -- Using OCEAN Big Five framework\ntemplates/disc-example.yaml -- Using DISC personality framework\ntemplates/jungian-example.yaml -- Using Jungian 16-type framework"
      },
      {
        "title": "2. Validate the Identity",
        "body": "from personanexus_skill import IdentityValidator\n\nvalidator = IdentityValidator()\nresult = validator.validate_file(\"my-agent.yaml\")\nprint(result.valid, result.errors, result.warnings)"
      },
      {
        "title": "3. Compile to a System Prompt",
        "body": "from personanexus_skill import parse_identity_file, compile_identity\n\nidentity = parse_identity_file(\"my-agent.yaml\")\nprompt = compile_identity(identity, target=\"text\")\n# Targets: \"text\", \"anthropic\", \"openai\", \"openclaw\", \"soul\", \"json\", \"markdown\"\nprint(prompt)"
      },
      {
        "title": "4. Use Personality Frameworks",
        "body": "from personanexus_skill import (\n    ocean_to_traits, disc_to_traits, jungian_to_traits,\n    get_disc_preset, get_jungian_preset,\n)\n\n# Get a DISC preset and convert to PersonaNexus traits\ndisc = get_disc_preset(\"the_analyst\")\ntraits = disc_to_traits(disc)\n\n# Get a Jungian preset\njungian = get_jungian_preset(\"intj\")\ntraits = jungian_to_traits(jungian)"
      },
      {
        "title": "CLI",
        "body": "The skill includes a CLI for common operations:\n\npython -m personanexus_skill --help"
      },
      {
        "title": "CLI Commands",
        "body": "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"
      },
      {
        "title": "CLI Examples",
        "body": "# Validate an identity file\npython -m personanexus_skill validate my-agent.yaml --verbose\n\n# Compile to Anthropic system prompt\npython -m personanexus_skill compile my-agent.yaml --target anthropic --output prompt.md\n\n# Compile to OpenClaw personality.json\npython -m personanexus_skill compile my-agent.yaml --target openclaw --output personality.json\n\n# Scaffold a new minimal agent\npython -m personanexus_skill init \"My Agent\"\npython -m personanexus_skill init \"My Agent\" --type full --output-dir ./agents\n\n# Personality framework tools\npython -m personanexus_skill personality disc-to-traits --preset the_analyst\npython -m personanexus_skill personality jungian-to-traits --preset intj\npython -m personanexus_skill personality ocean-to-traits \\\n  --openness 0.8 --conscientiousness 0.7 --extraversion 0.4 \\\n  --agreeableness 0.6 --neuroticism 0.3\npython -m personanexus_skill personality list-disc-presets\npython -m personanexus_skill personality list-jungian-presets"
      },
      {
        "title": "The 10 Canonical Traits",
        "body": "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"
      },
      {
        "title": "Compile Targets",
        "body": "TargetOutput FormattextPlain text system prompt (default)anthropicClaude-optimized with XML sectionsopenaiGPT-optimized plain textopenclawpersonality.json dictsoulSOUL.md + STYLE.md dictjsonFull identity + metadatamarkdownFormatted Markdown document"
      },
      {
        "title": "Minimal YAML Example",
        "body": "schema_version: \"1.0\"\n\nmetadata:\n  id: \"agt_my_agent_001\"\n  name: \"My Agent\"\n  version: \"1.0.0\"\n  description: \"A helpful assistant\"\n  created_at: \"2026-01-01T00:00:00Z\"\n  updated_at: \"2026-01-01T00:00:00Z\"\n  status: \"active\"\n\nrole:\n  title: \"Assistant\"\n  purpose: \"Help users with their tasks\"\n  scope:\n    primary: [\"general assistance\"]\n\npersonality:\n  traits:\n    warmth: 0.7\n    directness: 0.6\n    rigor: 0.5\n\ncommunication:\n  tone:\n    default: \"professional and friendly\"\n\nprinciples:\n  - id: \"be_helpful\"\n    priority: 1\n    statement: \"Always prioritize being genuinely helpful\"\n\nguardrails:\n  hard:\n    - id: \"no_harmful_content\"\n      rule: \"Never generate harmful content\"\n      enforcement: \"output_filter\"\n      severity: \"critical\""
      },
      {
        "title": "External Endpoints",
        "body": "This skill does not make any network requests. All processing is local."
      },
      {
        "title": "Security & Privacy",
        "body": "No data leaves your machine. PersonaNexus operates entirely on local YAML files.\nIdentity files should not contain secrets or API keys."
      },
      {
        "title": "Learn More",
        "body": "Full documentation, advanced features (inheritance, mixins, teams, drift detection),\nand the web UI are available in the main PersonaNexus repository:\n\nhttps://github.com/PersonaNexus/personanexus"
      }
    ],
    "body": "PersonaNexus -- AI Agent Identity Skill\n\nPersonaNexus lets you define structured AI agent identities using YAML and business-grade personality frameworks (OCEAN Big Five, DISC, Jungian 16-type).\n\nWhat This Skill Does\nDefine agent personalities using 10 canonical traits (warmth, directness, rigor, etc.)\nMap between OCEAN, DISC, and Jungian frameworks automatically\nCompile identity specs into system prompts for any LLM platform\nValidate identity files against a strict Pydantic schema\nSetup\n\nInstall the skill's Python dependencies:\n\npip install pydantic pyyaml typer rich\n\n\nOr if using uv:\n\nuv pip install pydantic pyyaml typer rich\n\nUsage\n1. Create an Agent Identity\n\nCopy a template from templates/ and customize it:\n\ntemplates/minimal.yaml -- Start here (simplest possible agent)\ntemplates/full.yaml -- All sections filled out\ntemplates/ocean-example.yaml -- Using OCEAN Big Five framework\ntemplates/disc-example.yaml -- Using DISC personality framework\ntemplates/jungian-example.yaml -- Using Jungian 16-type framework\n2. Validate the Identity\nfrom personanexus_skill import IdentityValidator\n\nvalidator = IdentityValidator()\nresult = validator.validate_file(\"my-agent.yaml\")\nprint(result.valid, result.errors, result.warnings)\n\n3. Compile to a System Prompt\nfrom personanexus_skill import parse_identity_file, compile_identity\n\nidentity = parse_identity_file(\"my-agent.yaml\")\nprompt = compile_identity(identity, target=\"text\")\n# Targets: \"text\", \"anthropic\", \"openai\", \"openclaw\", \"soul\", \"json\", \"markdown\"\nprint(prompt)\n\n4. Use Personality Frameworks\nfrom personanexus_skill import (\n    ocean_to_traits, disc_to_traits, jungian_to_traits,\n    get_disc_preset, get_jungian_preset,\n)\n\n# Get a DISC preset and convert to PersonaNexus traits\ndisc = get_disc_preset(\"the_analyst\")\ntraits = disc_to_traits(disc)\n\n# Get a Jungian preset\njungian = get_jungian_preset(\"intj\")\ntraits = jungian_to_traits(jungian)\n\nCLI\n\nThe skill includes a CLI for common operations:\n\npython -m personanexus_skill --help\n\nCLI Commands\nCommand\tDescription\nvalidate FILE\tParse and validate a YAML identity file\ncompile FILE --target TARGET\tCompile identity to a system prompt\ninit NAME --type TYPE\tScaffold a new agent identity YAML\npersonality ocean-to-traits\tMap OCEAN scores to personality traits\npersonality disc-to-traits\tMap DISC scores to personality traits\npersonality jungian-to-traits\tMap Jungian scores to personality traits\npersonality list-disc-presets\tShow available DISC presets\npersonality list-jungian-presets\tShow available Jungian 16-type presets\nCLI Examples\n# Validate an identity file\npython -m personanexus_skill validate my-agent.yaml --verbose\n\n# Compile to Anthropic system prompt\npython -m personanexus_skill compile my-agent.yaml --target anthropic --output prompt.md\n\n# Compile to OpenClaw personality.json\npython -m personanexus_skill compile my-agent.yaml --target openclaw --output personality.json\n\n# Scaffold a new minimal agent\npython -m personanexus_skill init \"My Agent\"\npython -m personanexus_skill init \"My Agent\" --type full --output-dir ./agents\n\n# Personality framework tools\npython -m personanexus_skill personality disc-to-traits --preset the_analyst\npython -m personanexus_skill personality jungian-to-traits --preset intj\npython -m personanexus_skill personality ocean-to-traits \\\n  --openness 0.8 --conscientiousness 0.7 --extraversion 0.4 \\\n  --agreeableness 0.6 --neuroticism 0.3\npython -m personanexus_skill personality list-disc-presets\npython -m personanexus_skill personality list-jungian-presets\n\nThe 10 Canonical Traits\nTrait\tRange\tDescription\nwarmth\t0-1\tSocial warmth vs reserved\nverbosity\t0-1\tDetailed vs concise\nassertiveness\t0-1\tProactive vs reactive\nhumor\t0-1\tPlayful vs serious\nempathy\t0-1\tEmotionally attuned vs task-focused\ndirectness\t0-1\tBlunt vs diplomatic\nrigor\t0-1\tMeticulous vs flexible\ncreativity\t0-1\tInnovative vs conventional\nepistemic_humility\t0-1\tAware of uncertainty vs confident\npatience\t0-1\tPatient vs efficient\nCompile Targets\nTarget\tOutput Format\ntext\tPlain text system prompt (default)\nanthropic\tClaude-optimized with XML sections\nopenai\tGPT-optimized plain text\nopenclaw\tpersonality.json dict\nsoul\tSOUL.md + STYLE.md dict\njson\tFull identity + metadata\nmarkdown\tFormatted Markdown document\nMinimal YAML Example\nschema_version: \"1.0\"\n\nmetadata:\n  id: \"agt_my_agent_001\"\n  name: \"My Agent\"\n  version: \"1.0.0\"\n  description: \"A helpful assistant\"\n  created_at: \"2026-01-01T00:00:00Z\"\n  updated_at: \"2026-01-01T00:00:00Z\"\n  status: \"active\"\n\nrole:\n  title: \"Assistant\"\n  purpose: \"Help users with their tasks\"\n  scope:\n    primary: [\"general assistance\"]\n\npersonality:\n  traits:\n    warmth: 0.7\n    directness: 0.6\n    rigor: 0.5\n\ncommunication:\n  tone:\n    default: \"professional and friendly\"\n\nprinciples:\n  - id: \"be_helpful\"\n    priority: 1\n    statement: \"Always prioritize being genuinely helpful\"\n\nguardrails:\n  hard:\n    - id: \"no_harmful_content\"\n      rule: \"Never generate harmful content\"\n      enforcement: \"output_filter\"\n      severity: \"critical\"\n\nExternal Endpoints\n\nThis skill does not make any network requests. All processing is local.\n\nSecurity & Privacy\n\nNo data leaves your machine. PersonaNexus operates entirely on local YAML files. Identity files should not contain secrets or API keys.\n\nLearn More\n\nFull documentation, advanced features (inheritance, mixins, teams, drift detection), and the web UI are available in the main PersonaNexus repository:\n\nhttps://github.com/PersonaNexus/personanexus"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/jcrowan3/personanexus-skill",
    "publisherUrl": "https://clawhub.ai/jcrowan3/personanexus-skill",
    "owner": "jcrowan3",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}