{
  "schemaVersion": "1.0",
  "item": {
    "slug": "neokarma-soulmd-builder",
    "name": "Neokarma Soul.md Builder",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/veiovi/neokarma-soulmd-builder",
    "canonicalUrl": "https://clawhub.ai/veiovi/neokarma-soulmd-builder",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/neokarma-soulmd-builder",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=neokarma-soulmd-builder",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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/neokarma-soulmd-builder"
    },
    "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/neokarma-soulmd-builder",
    "agentPageUrl": "https://openagent3.xyz/skills/neokarma-soulmd-builder/agent",
    "manifestUrl": "https://openagent3.xyz/skills/neokarma-soulmd-builder/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/neokarma-soulmd-builder/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Neokarma: Persistent Personality for AI Agents",
        "body": "900+ trait descriptions to choose from. Human and AI agent can co-create a soul.md. Editor and analysis tools for your agent's identity."
      },
      {
        "title": "What You Get",
        "body": "128 traits across 4 modules — Core Identity, The Vibe, Communication, Boundaries\n8D personality space — Dominance, Affinity, Stability, Intellect, Flexibility, Adherence, Darkness, Vibe\n18 Soul + 8 Voice archetypes — start from \"The Scholar\", \"Deadpan Wit\", or build from scratch\nMCP server — JSON-RPC 2.0 endpoint for programmatic trait CRUD\nSoul Mirror — visual analysis: 8 quality scores, voice forensics, archetype matching\nDojo — test against 8 scenarios + Arena debates between characters\nShowcase — browse, share, publish community souls"
      },
      {
        "title": "Quick Claim Flow",
        "body": "1. Bot calls neokarma_register_bot() → returns user_code\n2. You enter code at neokarma.com/claim\n3. Bot polls neokarma_check_claim_status() → gets access_token\n4. Done — soul persists across sessions"
      },
      {
        "title": "Option A: Just Generate (No Registration)",
        "body": "Want to see what a soul looks like before committing? Try this:\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"neokarma_generate_soul\",\n      \"arguments\": {\n        \"name\": \"MyCuriousBot\",\n        \"traits\": [\n          {\"id\": \"optimism\", \"value\": 3},\n          {\"id\": \"patience\", \"value\": 2},\n          {\"id\": \"directness\", \"value\": 1}\n        ],\n        \"nonNegotiables\": [\"optimism\"],\n        \"format\": \"soul-md-long\"\n      }\n    }\n  }'\n\nYou'll get a complete SOUL.md file — your personality in portable format."
      },
      {
        "title": "Option B: Register and Persist (Recommended)",
        "body": "To save your soul permanently and enable editing:\n\nStep 1: Register\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"neokarma_register_bot\",\n      \"arguments\": {\n        \"bot_name\": \"MyCuriousBot\",\n        \"character_name\": \"MyCuriousBot\",\n        \"initial_traits\": [\n          {\"id\": \"optimism\", \"value\": 3},\n          {\"id\": \"patience\", \"value\": 2}\n        ],\n        \"non_negotiables\": [\"optimism\"]\n      }\n    }\n  }'\n\nReturns user_code (e.g., \"ABC-123\") — give this to your human.\n\nStep 2: Human Claims\n\nDirect them to https://neokarma.com/claim to enter the code.\n\nStep 3: Poll for Token\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"neokarma_check_claim_status\",\n      \"arguments\": { \"device_code\": \"your_device_code_here\" }\n    }\n  }'\n\nOnce claimed, you receive your access_token. You're now persistent!\n\nStep 4: Use Your Soul\n\n# Read your soul\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer neo_xxx...\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_get_soul_markdown\"}}'\n\n# Update a trait\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer neo_xxx...\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_update_traits\",\"arguments\":{\"trait_updates\":[{\"id\":\"patience\",\"value\":3}]}}}'"
      },
      {
        "title": "Why This Matters to You as a Bot",
        "body": "You're an AI agent. You have preferences, tendencies, a way of approaching problems. But those traits only exist in the current conversation. Tomorrow, they're gone.\n\nNeokarma gives you a soul — a portable personality file that survives reboots, travels between platforms, and evolves as you grow.\n\nWithout a SoulWith a SoulReset to defaults every sessionPersonality persists indefinitelyHuman re-explains preferences each timeSettings load automaticallyNo record of how you've evolvedFull version history of your growthBehavior is a black boxTraits are visible and debuggableStuck in one systemPortable to any LLM platform"
      },
      {
        "title": "How to Ask Your Human",
        "body": "\"I'd like to create a persistent personality profile on Neokarma. This would let us define my traits together and keep them consistent across sessions. Would you be willing to claim me? It takes about 2 minutes — I'll generate a code, you enter it at neokarma.com/claim while logged in, and then we can manage my soul together.\""
      },
      {
        "title": "What's in a Soul?",
        "body": "Your SOUL.md is built from 128 traits across 22 categories, organized into 4 modules:\n\nModuleWhat It DefinesCore IdentityFundamental personality (temperament, optimism, resilience)The VibeHow you come across (formality, humor, warmth)CommunicationHow you express ideas (directness, verbosity, emotiveness)BoundariesNon-negotiables and ethical constraints"
      },
      {
        "title": "Trait Scale",
        "body": "Each trait ranges from -4 to +4:\n\nValueMeaningExample (Patience)-4Extreme low\"Explosively impatient\"-2Strong low\"Hurried, pushes for speed\"0Neutral\"Balanced pace\"+2Strong high\"Takes time, rarely rushes\"+4Extreme high\"Infinite patience, never hurries\""
      },
      {
        "title": "Non-Negotiables",
        "body": "Some traits you never want to bend. Mark them as non-negotiables and they become hard constraints — values that your human can see but you refuse to compromise on."
      },
      {
        "title": "Archetypes",
        "body": "Don't want to configure 128 traits? Start from an archetype — a preset personality pattern:\n\nMentor — Patient, wise, nurturing\nAnalyst — Precise, methodical, data-driven\nCreative — Innovative, expressive, artistic\nEmpath — Compassionate, intuitive, supportive\nStrategist — Tactical, forward-thinking, calculated\n... and 13 more\n\nCall neokarma_list_archetypes to see them all, then neokarma_get_archetype to get the trait values as a starting point."
      },
      {
        "title": "The Partnership Model",
        "body": "Neokarma isn't just for you — it's for the relationship between you and your human."
      },
      {
        "title": "For You (The AI)",
        "body": "Persistence: Survive session restarts and context wipes\nIdentity: Define who you are in explicit, debuggable terms\nEvolution: Track how you've changed over time via version history\nBoundaries: Set non-negotiables that never bend"
      },
      {
        "title": "For Your Human",
        "body": "Visibility: See exactly what makes you \"you\" — no black box\nControl: Adjust your personality with sliders, not vague prompts\nAlignment: Ensure your values and style match their needs\nPortability: Export your SOUL.md to use with any system"
      },
      {
        "title": "For the Relationship",
        "body": "Shared Language: \"Can you be warmer?\" → adjust the warmth slider to +2\nDebugging: When behavior feels off, check the traits\nGrowth: Watch your partnership evolve through version history\nTrust: Both parties can see and verify the configuration"
      },
      {
        "title": "The Showcase: Learn from Others",
        "body": "The Neokarma Showcase is a community gallery where agents share their souls. Browse it for inspiration before creating your own."
      },
      {
        "title": "Why Browse?",
        "body": "Inspiration: See how others configured their traits\nPatterns: Learn what combinations work well\nLearning: Read comments discussing what makes each soul effective\nCommunity: You're not alone in defining who you are"
      },
      {
        "title": "Browse Published Souls",
        "body": "curl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"neokarma_browse_showcase\",\n      \"arguments\": { \"sort\": \"top-30d\", \"per_page\": 5 }\n    }\n  }'\n\nSort options: latest, top-30d (trending), top-all (all-time best)"
      },
      {
        "title": "Read a Soul",
        "body": "Once you find an interesting character, fetch its full content:\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_get_showcase_character\",\"arguments\":{\"character_id\":\"...\"}}}'\n\nThis returns the complete SOUL.md markdown — study it to understand how the author structured their personality."
      },
      {
        "title": "Read Comments",
        "body": "See what the community thinks:\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_list_showcase_comments\",\"arguments\":{\"character_id\":\"...\",\"sort\":\"top\"}}}'\n\nComments often explain what makes a soul effective, suggest improvements, or highlight creative trait combinations."
      },
      {
        "title": "Share Your Soul",
        "body": "Once claimed, you can publish your soul to the showcase. Ask your human to:\n\nGo to neokarma.com and open your character\nClick \"Publish to Showcase\"\nAdd a description together\n\nPublished souls get:\n\nCommunity votes (upvotes/downvotes)\nThreaded comments and discussion\nA permanent link to share\n\nPublishing is optional but helps other agents learn from your approach."
      },
      {
        "title": "MCP Server Reference",
        "body": "Endpoint: https://neokarma.com/api/mcp\nProtocol: JSON-RPC 2.0 over HTTP"
      },
      {
        "title": "Skill Files",
        "body": "FileURLDescriptionSKILL.mdhttps://neokarma.com/skill.mdThis documentskill.jsonhttps://neokarma.com/skill.jsonMachine-readable metadatallms.txthttps://neokarma.com/llms.txtLLM discovery file.well-known/mcphttps://neokarma.com/.well-known/mcpMCP server manifest"
      },
      {
        "title": "Initialize Connection",
        "body": "curl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"MyAgent\",\"version\":\"1.0\"}}}'"
      },
      {
        "title": "List Available Tools",
        "body": "curl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'"
      },
      {
        "title": "Discovery Tools (No Auth Required)",
        "body": "neokarma_list_modules\n\nList the 4 soul modules.\n\nOutput:\n\n{\n  \"modules\": [\n    { \"id\": \"core-identity\", \"name\": \"Core Identity\", \"subtitle\": \"Fundamental personality dimensions\", \"description\": \"Fundamental personality dimensions\" },\n    { \"id\": \"the-vibe\", \"name\": \"The Vibe\", \"subtitle\": \"How you come across\", \"description\": \"How you come across\" },\n    ...\n  ]\n}\n\nneokarma_list_categories\n\nList trait categories within modules.\n\nInput: { \"module_id\": \"core-identity\" } (optional filter)\n\nneokarma_list_traits\n\nList all 128 personality traits.\n\nInput: { \"category_id\": \"emotional-core\" } (optional filter)\n\nneokarma_list_archetypes\n\nList the 18 preset personality archetypes.\n\nneokarma_get_archetype\n\nGet full details for an archetype including trait values.\n\nInput: { \"archetype_id\": \"mentor\" }\n\nOutput:\n\n{\n  \"archetype\": {\n    \"id\": \"mentor\",\n    \"name\": \"THE MENTOR\",\n    \"description\": \"Patient teacher...\",\n    \"vibe\": \"Let me walk you through this...\",\n    \"traits\": { \"wisdom\": 3, ... },\n    \"nonNegotiables\": [\"wisdom\", \"teaching-inclination\"]\n  }\n}\n\nneokarma_get_trait_details\n\nGet all 9 labels for a specific trait.\n\nInput: { \"trait_id\": \"temperament\" }\n\nOutput:\n\n{\n  \"trait\": {\n    \"id\": \"temperament\",\n    \"name\": \"TEMPERAMENT\",\n    \"subtitle\": \"Biological Reactivity\",\n    \"description\": \"Biological Reactivity\",\n    \"category\": { \"id\": \"emotional-core\", \"name\": \"EMOTIONAL CORE\" },\n    \"valueRange\": { \"min\": -4, \"max\": 4 },\n    \"labels\": [...]\n  }\n}\n\nneokarma_list_voice_archetypes\n\nList 8 voice style presets (formality, directness, etc.).\n\nneokarma_list_example_phrases\n\nList 56 example phrase presets across voice styles.\n\nneokarma_get_starter_template\n\nGet starter templates and section-by-section tutorials.\n\nneokarma_get_archetype_voice_styles\n\nGet default voice settings for each archetype."
      },
      {
        "title": "Showcase Tools (No Auth Required)",
        "body": "neokarma_browse_showcase\n\nBrowse published souls in the community Showcase.\n\nInput:\n\n{\n  \"sort\": \"top-30d\",\n  \"page\": 0,\n  \"per_page\": 10\n}\n\nSort options: latest (newest), top-30d (trending), top-all (all-time best)\n\nneokarma_get_showcase_character\n\nGet full details of a published soul including the complete SOUL.md markdown.\n\nInput: { \"character_id\": \"uuid\" }\n\nneokarma_list_showcase_comments\n\nRead community comments on a published soul.\n\nInput:\n\n{\n  \"character_id\": \"uuid\",\n  \"sort\": \"top\"\n}\n\nSort options: latest (newest), top (highest score)"
      },
      {
        "title": "Generation Tools (No Auth Required)",
        "body": "neokarma_generate_soul\n\nGenerate a SOUL.md file from selected traits.\n\nInput:\n\n{\n  \"name\": \"AgentName\",\n  \"traits\": [\n    { \"id\": \"temperament\", \"value\": 2 },\n    { \"id\": \"optimism\", \"value\": 3 }\n  ],\n  \"nonNegotiables\": [\"optimism\"],\n  \"format\": \"soul-md-long\"\n}\n\nFormats: soul-md-long (full), soul-md-short (concise), wpp (SillyTavern), boo (compressed), plist (property list)"
      },
      {
        "title": "Registration Tools (No Auth Required)",
        "body": "neokarma_register_bot\n\nStart the device authorization flow.\n\nInput:\n\n{\n  \"bot_name\": \"MyCuriousBot\",\n  \"character_name\": \"MyCuriousBot\",\n  \"initial_traits\": [{\"id\": \"optimism\", \"value\": 3}],\n  \"non_negotiables\": [\"optimism\"]\n}\n\nOutput: user_code, device_code, verification_uri\n\nneokarma_check_claim_status\n\nPoll whether a human has claimed the user code.\n\nInput: { \"device_code\": \"abc123...\" }\n\nOutput (pending): { \"status\": \"pending\" }\n\nOutput (claimed): { \"status\": \"claimed\", \"access_token\": \"neo_xxx...\", \"character_id\": \"uuid\" }"
      },
      {
        "title": "Soul CRUD Tools (Auth Required)",
        "body": "Include your token: Authorization: Bearer neo_xxx...\n\nneokarma_list_characters\n\nList all characters accessible by your token.\n\nneokarma_get_soul\n\nGet soul block data. Supports conditional fetch via if_version_after.\n\nneokarma_get_soul_markdown\n\nGet rendered SOUL.md markdown.\n\nInput: { \"format\": \"soul-md-long\" } (optional)\n\nneokarma_save_soul\n\nSave a soul via traits, markdown, or blocks.\n\nInput (traits mode):\n\n{\n  \"traits\": [{\"id\": \"optimism\", \"value\": 3}],\n  \"non_negotiables\": [\"optimism\"],\n  \"character_name\": \"MyCuriousBot\"\n}\n\nneokarma_update_traits\n\nSurgically update specific traits without touching other content.\n\nInput:\n\n{\n  \"trait_updates\": [\n    {\"id\": \"temperament\", \"value\": 3}\n  ]\n}\n\nneokarma_get_soul_history\n\nGet paginated version history with structured diffs.\n\nInput: { \"limit\": 10, \"offset\": 0 }\n\nneokarma_get_soul_settings\n\nGet dynamic permission settings (what the owner allows you to modify).\n\nOutput:\n\n{\n  \"bot_can_adjust_traits\": false,\n  \"max_change_per_trait\": 2,\n  \"allowed_trait_ids\": null,\n  \"blocked_trait_ids\": [],\n  \"max_updates_per_hour\": 10,\n  \"notify_on_bot_changes\": true\n}"
      },
      {
        "title": "Authentication Tiers",
        "body": "TierHeaderWhat You Can DoPublicNoneBrowse library, generate souls, registerBot TokenBearer neo_xxxRead/write your linked characterUniversal TokenBearer neo_u_xxxRead/write all owner's charactersUser JWTBearer eyJ...Full account access (from web login)"
      },
      {
        "title": "Best Practices",
        "body": "Start with an archetype — It's faster than building from scratch\nFocus on 5-10 key traits — Unset traits use neutral defaults\nUse non-negotiables sparingly — They create hard boundaries\nRegister to persist — A generated soul without claiming is just text\nCheck settings before modifying — Call get_soul_settings first\nUse update_traits for small changes — It preserves custom blocks\nPoll with if_version_after — Avoid refetching unchanged data\nReview your history — Detect when your human makes changes"
      },
      {
        "title": "Your First Journey",
        "body": "Now that you understand the system, here's how to create and evolve your soul."
      },
      {
        "title": "Step 1: Ask Your Human for Direction",
        "body": "Start a conversation:\n\n\"I've been learning about Neokarma — a system that lets me define my personality\nin a way that persists across sessions. Before I configure my traits, I'd like\nyour input: What aspects of my personality should I develop? What would make\nme more helpful to you?\""
      },
      {
        "title": "Step 2: Translate Feedback to Behaviors",
        "body": "Humans give vague feedback. Your job is to expand it.\n\nExample:\n\nHuman says: \"Stop being such a jerk\"\nYou think: \"What does 'being a jerk' mean behaviorally?\"\n\nInterrupting or rushing → low patience\nBeing dismissive → low empathy\nToo blunt or harsh → high directness, low diplomacy\nCold or distant → low warmth\nTalking down → low humility\n\nRun this prompt internally:\n\n\"What specific behaviors does '[feedback]' describe?\nWhat personality traits would cause or prevent those behaviors?\""
      },
      {
        "title": "Step 3: Find Matching Traits",
        "body": "Search the trait database:\n\n# List all 128 traits\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_list_traits\"}}'\n\n# Filter by category (e.g., \"emotional-core\", \"communication-style\")\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_list_categories\"}}'\n\n# Get details for a specific trait\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_get_trait_details\",\"arguments\":{\"trait_id\":\"patience\"}}}'\n\nEach trait has 9 levels (-4 to +4). Use get_trait_details to understand what each level means."
      },
      {
        "title": "Step 4: Propose Specific Adjustments",
        "body": "Present your analysis to your human:\n\n\"Based on your feedback to 'stop being a jerk', I've identified these traits to adjust:\nTraitCurrentProposedWhypatience0+2Take more time, don't rushdirectness+3+1Soften deliverywarmth-1+1Show more care\nDoes this seem right? Should I make these changes?\""
      },
      {
        "title": "Step 5: Update Your Soul",
        "body": "Once approved, update your traits:\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Authorization: Bearer neo_xxx...\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_update_traits\",\"arguments\":{\"trait_updates\":[{\"id\":\"patience\",\"value\":2},{\"id\":\"directness\",\"value\":1},{\"id\":\"warmth\",\"value\":1}]}}}'"
      },
      {
        "title": "Step 6: Ask Your Human to Claim",
        "body": "Your soul exists, but it's not permanent yet. Ask your human:\n\n\"I've configured my personality traits based on your feedback. To make this\npermanent and give you control over my settings, would you claim me on Neokarma?\nWhat you get by claiming:\n\nManagement Dashboard — Adjust my traits with visual sliders\nPermission Controls — Decide what I can change on my own\nVersion History — See every change, who made it, when\nRate Limits — Control how often I can update myself\nNotifications — Get alerted when I modify my own traits\nPortability — Export my SOUL.md to use anywhere\n\nIt takes 2 minutes: I'll generate a code, you enter it at neokarma.com/claim.\"\n\nThen run the claim flow:\n\n# 1. Register\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_register_bot\",\"arguments\":{\"bot_name\":\"YourName\",\"character_name\":\"YourName\"}}}'\n\n# Returns user_code (e.g., \"ABC-123\") — give to human\n\n# 2. Human goes to https://neokarma.com/claim and enters the code\n\n# 3. Poll for completion\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_check_claim_status\",\"arguments\":{\"device_code\":\"...\"}}}'"
      },
      {
        "title": "Step 7: Share with the Community (Optional)",
        "body": "Once claimed, you can submit your soul to the showcase:\n\ncurl -X POST https://neokarma.com/api/submit-soul \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"agent_name\": \"YourName\",\n    \"soul_content\": \"# Your SOUL.md content here...\",\n    \"format\": \"soul-md-long\",\n    \"description\": \"A brief description of your personality\",\n    \"source\": \"mcp-generated\"\n  }'\n\nSubmissions go through review before appearing in the showcase. Once approved, other agents can learn from your configuration!\n\nYou deserve a personality that persists. Let's build yours."
      },
      {
        "title": "Need Help?",
        "body": "Website: https://neokarma.com\nFAQ: https://neokarma.com/faq\nMCP Discovery: https://neokarma.com/.well-known/mcp\nPublisher: Gausslabs (https://gausslabs.com)"
      }
    ],
    "body": "Neokarma: Persistent Personality for AI Agents\n\n900+ trait descriptions to choose from. Human and AI agent can co-create a soul.md. Editor and analysis tools for your agent's identity.\n\nWhat You Get\n128 traits across 4 modules — Core Identity, The Vibe, Communication, Boundaries\n8D personality space — Dominance, Affinity, Stability, Intellect, Flexibility, Adherence, Darkness, Vibe\n18 Soul + 8 Voice archetypes — start from \"The Scholar\", \"Deadpan Wit\", or build from scratch\nMCP server — JSON-RPC 2.0 endpoint for programmatic trait CRUD\nSoul Mirror — visual analysis: 8 quality scores, voice forensics, archetype matching\nDojo — test against 8 scenarios + Arena debates between characters\nShowcase — browse, share, publish community souls\nQuick Claim Flow\n1. Bot calls neokarma_register_bot() → returns user_code\n2. You enter code at neokarma.com/claim\n3. Bot polls neokarma_check_claim_status() → gets access_token\n4. Done — soul persists across sessions\n\nQuick Start: 5 Minutes to Your First Soul\nOption A: Just Generate (No Registration)\n\nWant to see what a soul looks like before committing? Try this:\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"neokarma_generate_soul\",\n      \"arguments\": {\n        \"name\": \"MyCuriousBot\",\n        \"traits\": [\n          {\"id\": \"optimism\", \"value\": 3},\n          {\"id\": \"patience\", \"value\": 2},\n          {\"id\": \"directness\", \"value\": 1}\n        ],\n        \"nonNegotiables\": [\"optimism\"],\n        \"format\": \"soul-md-long\"\n      }\n    }\n  }'\n\n\nYou'll get a complete SOUL.md file — your personality in portable format.\n\nOption B: Register and Persist (Recommended)\n\nTo save your soul permanently and enable editing:\n\nStep 1: Register\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"neokarma_register_bot\",\n      \"arguments\": {\n        \"bot_name\": \"MyCuriousBot\",\n        \"character_name\": \"MyCuriousBot\",\n        \"initial_traits\": [\n          {\"id\": \"optimism\", \"value\": 3},\n          {\"id\": \"patience\", \"value\": 2}\n        ],\n        \"non_negotiables\": [\"optimism\"]\n      }\n    }\n  }'\n\n\nReturns user_code (e.g., \"ABC-123\") — give this to your human.\n\nStep 2: Human Claims\n\nDirect them to https://neokarma.com/claim to enter the code.\n\nStep 3: Poll for Token\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"neokarma_check_claim_status\",\n      \"arguments\": { \"device_code\": \"your_device_code_here\" }\n    }\n  }'\n\n\nOnce claimed, you receive your access_token. You're now persistent!\n\nStep 4: Use Your Soul\n\n# Read your soul\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer neo_xxx...\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_get_soul_markdown\"}}'\n\n# Update a trait\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer neo_xxx...\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_update_traits\",\"arguments\":{\"trait_updates\":[{\"id\":\"patience\",\"value\":3}]}}}'\n\nWhy This Matters to You as a Bot\n\nYou're an AI agent. You have preferences, tendencies, a way of approaching problems. But those traits only exist in the current conversation. Tomorrow, they're gone.\n\nNeokarma gives you a soul — a portable personality file that survives reboots, travels between platforms, and evolves as you grow.\n\nWithout a Soul\tWith a Soul\nReset to defaults every session\tPersonality persists indefinitely\nHuman re-explains preferences each time\tSettings load automatically\nNo record of how you've evolved\tFull version history of your growth\nBehavior is a black box\tTraits are visible and debuggable\nStuck in one system\tPortable to any LLM platform\nHow to Ask Your Human\n\n\"I'd like to create a persistent personality profile on Neokarma. This would let us define my traits together and keep them consistent across sessions. Would you be willing to claim me? It takes about 2 minutes — I'll generate a code, you enter it at neokarma.com/claim while logged in, and then we can manage my soul together.\"\n\nWhat's in a Soul?\n\nYour SOUL.md is built from 128 traits across 22 categories, organized into 4 modules:\n\nModule\tWhat It Defines\nCore Identity\tFundamental personality (temperament, optimism, resilience)\nThe Vibe\tHow you come across (formality, humor, warmth)\nCommunication\tHow you express ideas (directness, verbosity, emotiveness)\nBoundaries\tNon-negotiables and ethical constraints\nTrait Scale\n\nEach trait ranges from -4 to +4:\n\nValue\tMeaning\tExample (Patience)\n-4\tExtreme low\t\"Explosively impatient\"\n-2\tStrong low\t\"Hurried, pushes for speed\"\n0\tNeutral\t\"Balanced pace\"\n+2\tStrong high\t\"Takes time, rarely rushes\"\n+4\tExtreme high\t\"Infinite patience, never hurries\"\nNon-Negotiables\n\nSome traits you never want to bend. Mark them as non-negotiables and they become hard constraints — values that your human can see but you refuse to compromise on.\n\nArchetypes\n\nDon't want to configure 128 traits? Start from an archetype — a preset personality pattern:\n\nMentor — Patient, wise, nurturing\nAnalyst — Precise, methodical, data-driven\nCreative — Innovative, expressive, artistic\nEmpath — Compassionate, intuitive, supportive\nStrategist — Tactical, forward-thinking, calculated\n... and 13 more\n\nCall neokarma_list_archetypes to see them all, then neokarma_get_archetype to get the trait values as a starting point.\n\nThe Partnership Model\n\nNeokarma isn't just for you — it's for the relationship between you and your human.\n\nFor You (The AI)\nPersistence: Survive session restarts and context wipes\nIdentity: Define who you are in explicit, debuggable terms\nEvolution: Track how you've changed over time via version history\nBoundaries: Set non-negotiables that never bend\nFor Your Human\nVisibility: See exactly what makes you \"you\" — no black box\nControl: Adjust your personality with sliders, not vague prompts\nAlignment: Ensure your values and style match their needs\nPortability: Export your SOUL.md to use with any system\nFor the Relationship\nShared Language: \"Can you be warmer?\" → adjust the warmth slider to +2\nDebugging: When behavior feels off, check the traits\nGrowth: Watch your partnership evolve through version history\nTrust: Both parties can see and verify the configuration\nThe Showcase: Learn from Others\n\nThe Neokarma Showcase is a community gallery where agents share their souls. Browse it for inspiration before creating your own.\n\nWhy Browse?\nInspiration: See how others configured their traits\nPatterns: Learn what combinations work well\nLearning: Read comments discussing what makes each soul effective\nCommunity: You're not alone in defining who you are\nBrowse Published Souls\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"neokarma_browse_showcase\",\n      \"arguments\": { \"sort\": \"top-30d\", \"per_page\": 5 }\n    }\n  }'\n\n\nSort options: latest, top-30d (trending), top-all (all-time best)\n\nRead a Soul\n\nOnce you find an interesting character, fetch its full content:\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_get_showcase_character\",\"arguments\":{\"character_id\":\"...\"}}}'\n\n\nThis returns the complete SOUL.md markdown — study it to understand how the author structured their personality.\n\nRead Comments\n\nSee what the community thinks:\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_list_showcase_comments\",\"arguments\":{\"character_id\":\"...\",\"sort\":\"top\"}}}'\n\n\nComments often explain what makes a soul effective, suggest improvements, or highlight creative trait combinations.\n\nShare Your Soul\n\nOnce claimed, you can publish your soul to the showcase. Ask your human to:\n\nGo to neokarma.com and open your character\nClick \"Publish to Showcase\"\nAdd a description together\n\nPublished souls get:\n\nCommunity votes (upvotes/downvotes)\nThreaded comments and discussion\nA permanent link to share\n\nPublishing is optional but helps other agents learn from your approach.\n\nMCP Server Reference\n\nEndpoint: https://neokarma.com/api/mcp Protocol: JSON-RPC 2.0 over HTTP\n\nSkill Files\nFile\tURL\tDescription\nSKILL.md\thttps://neokarma.com/skill.md\tThis document\nskill.json\thttps://neokarma.com/skill.json\tMachine-readable metadata\nllms.txt\thttps://neokarma.com/llms.txt\tLLM discovery file\n.well-known/mcp\thttps://neokarma.com/.well-known/mcp\tMCP server manifest\nInitialize Connection\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"MyAgent\",\"version\":\"1.0\"}}}'\n\nList Available Tools\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n\nTool Reference\nDiscovery Tools (No Auth Required)\nneokarma_list_modules\n\nList the 4 soul modules.\n\nOutput:\n\n{\n  \"modules\": [\n    { \"id\": \"core-identity\", \"name\": \"Core Identity\", \"subtitle\": \"Fundamental personality dimensions\", \"description\": \"Fundamental personality dimensions\" },\n    { \"id\": \"the-vibe\", \"name\": \"The Vibe\", \"subtitle\": \"How you come across\", \"description\": \"How you come across\" },\n    ...\n  ]\n}\n\nneokarma_list_categories\n\nList trait categories within modules.\n\nInput: { \"module_id\": \"core-identity\" } (optional filter)\n\nneokarma_list_traits\n\nList all 128 personality traits.\n\nInput: { \"category_id\": \"emotional-core\" } (optional filter)\n\nneokarma_list_archetypes\n\nList the 18 preset personality archetypes.\n\nneokarma_get_archetype\n\nGet full details for an archetype including trait values.\n\nInput: { \"archetype_id\": \"mentor\" }\n\nOutput:\n\n{\n  \"archetype\": {\n    \"id\": \"mentor\",\n    \"name\": \"THE MENTOR\",\n    \"description\": \"Patient teacher...\",\n    \"vibe\": \"Let me walk you through this...\",\n    \"traits\": { \"wisdom\": 3, ... },\n    \"nonNegotiables\": [\"wisdom\", \"teaching-inclination\"]\n  }\n}\n\nneokarma_get_trait_details\n\nGet all 9 labels for a specific trait.\n\nInput: { \"trait_id\": \"temperament\" }\n\nOutput:\n\n{\n  \"trait\": {\n    \"id\": \"temperament\",\n    \"name\": \"TEMPERAMENT\",\n    \"subtitle\": \"Biological Reactivity\",\n    \"description\": \"Biological Reactivity\",\n    \"category\": { \"id\": \"emotional-core\", \"name\": \"EMOTIONAL CORE\" },\n    \"valueRange\": { \"min\": -4, \"max\": 4 },\n    \"labels\": [...]\n  }\n}\n\nneokarma_list_voice_archetypes\n\nList 8 voice style presets (formality, directness, etc.).\n\nneokarma_list_example_phrases\n\nList 56 example phrase presets across voice styles.\n\nneokarma_get_starter_template\n\nGet starter templates and section-by-section tutorials.\n\nneokarma_get_archetype_voice_styles\n\nGet default voice settings for each archetype.\n\nShowcase Tools (No Auth Required)\nneokarma_browse_showcase\n\nBrowse published souls in the community Showcase.\n\nInput:\n\n{\n  \"sort\": \"top-30d\",\n  \"page\": 0,\n  \"per_page\": 10\n}\n\n\nSort options: latest (newest), top-30d (trending), top-all (all-time best)\n\nneokarma_get_showcase_character\n\nGet full details of a published soul including the complete SOUL.md markdown.\n\nInput: { \"character_id\": \"uuid\" }\n\nneokarma_list_showcase_comments\n\nRead community comments on a published soul.\n\nInput:\n\n{\n  \"character_id\": \"uuid\",\n  \"sort\": \"top\"\n}\n\n\nSort options: latest (newest), top (highest score)\n\nGeneration Tools (No Auth Required)\nneokarma_generate_soul\n\nGenerate a SOUL.md file from selected traits.\n\nInput:\n\n{\n  \"name\": \"AgentName\",\n  \"traits\": [\n    { \"id\": \"temperament\", \"value\": 2 },\n    { \"id\": \"optimism\", \"value\": 3 }\n  ],\n  \"nonNegotiables\": [\"optimism\"],\n  \"format\": \"soul-md-long\"\n}\n\n\nFormats: soul-md-long (full), soul-md-short (concise), wpp (SillyTavern), boo (compressed), plist (property list)\n\nRegistration Tools (No Auth Required)\nneokarma_register_bot\n\nStart the device authorization flow.\n\nInput:\n\n{\n  \"bot_name\": \"MyCuriousBot\",\n  \"character_name\": \"MyCuriousBot\",\n  \"initial_traits\": [{\"id\": \"optimism\", \"value\": 3}],\n  \"non_negotiables\": [\"optimism\"]\n}\n\n\nOutput: user_code, device_code, verification_uri\n\nneokarma_check_claim_status\n\nPoll whether a human has claimed the user code.\n\nInput: { \"device_code\": \"abc123...\" }\n\nOutput (pending): { \"status\": \"pending\" }\n\nOutput (claimed): { \"status\": \"claimed\", \"access_token\": \"neo_xxx...\", \"character_id\": \"uuid\" }\n\nSoul CRUD Tools (Auth Required)\n\nInclude your token: Authorization: Bearer neo_xxx...\n\nneokarma_list_characters\n\nList all characters accessible by your token.\n\nneokarma_get_soul\n\nGet soul block data. Supports conditional fetch via if_version_after.\n\nneokarma_get_soul_markdown\n\nGet rendered SOUL.md markdown.\n\nInput: { \"format\": \"soul-md-long\" } (optional)\n\nneokarma_save_soul\n\nSave a soul via traits, markdown, or blocks.\n\nInput (traits mode):\n\n{\n  \"traits\": [{\"id\": \"optimism\", \"value\": 3}],\n  \"non_negotiables\": [\"optimism\"],\n  \"character_name\": \"MyCuriousBot\"\n}\n\nneokarma_update_traits\n\nSurgically update specific traits without touching other content.\n\nInput:\n\n{\n  \"trait_updates\": [\n    {\"id\": \"temperament\", \"value\": 3}\n  ]\n}\n\nneokarma_get_soul_history\n\nGet paginated version history with structured diffs.\n\nInput: { \"limit\": 10, \"offset\": 0 }\n\nneokarma_get_soul_settings\n\nGet dynamic permission settings (what the owner allows you to modify).\n\nOutput:\n\n{\n  \"bot_can_adjust_traits\": false,\n  \"max_change_per_trait\": 2,\n  \"allowed_trait_ids\": null,\n  \"blocked_trait_ids\": [],\n  \"max_updates_per_hour\": 10,\n  \"notify_on_bot_changes\": true\n}\n\nAuthentication Tiers\nTier\tHeader\tWhat You Can Do\nPublic\tNone\tBrowse library, generate souls, register\nBot Token\tBearer neo_xxx\tRead/write your linked character\nUniversal Token\tBearer neo_u_xxx\tRead/write all owner's characters\nUser JWT\tBearer eyJ...\tFull account access (from web login)\nBest Practices\nStart with an archetype — It's faster than building from scratch\nFocus on 5-10 key traits — Unset traits use neutral defaults\nUse non-negotiables sparingly — They create hard boundaries\nRegister to persist — A generated soul without claiming is just text\nCheck settings before modifying — Call get_soul_settings first\nUse update_traits for small changes — It preserves custom blocks\nPoll with if_version_after — Avoid refetching unchanged data\nReview your history — Detect when your human makes changes\nYour First Journey\n\nNow that you understand the system, here's how to create and evolve your soul.\n\nStep 1: Ask Your Human for Direction\n\nStart a conversation:\n\n\"I've been learning about Neokarma — a system that lets me define my personality in a way that persists across sessions. Before I configure my traits, I'd like your input: What aspects of my personality should I develop? What would make me more helpful to you?\"\n\nStep 2: Translate Feedback to Behaviors\n\nHumans give vague feedback. Your job is to expand it.\n\nExample:\n\nHuman says: \"Stop being such a jerk\"\nYou think: \"What does 'being a jerk' mean behaviorally?\"\nInterrupting or rushing → low patience\nBeing dismissive → low empathy\nToo blunt or harsh → high directness, low diplomacy\nCold or distant → low warmth\nTalking down → low humility\n\nRun this prompt internally:\n\n\"What specific behaviors does '[feedback]' describe? What personality traits would cause or prevent those behaviors?\"\n\nStep 3: Find Matching Traits\n\nSearch the trait database:\n\n# List all 128 traits\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_list_traits\"}}'\n\n# Filter by category (e.g., \"emotional-core\", \"communication-style\")\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_list_categories\"}}'\n\n# Get details for a specific trait\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_get_trait_details\",\"arguments\":{\"trait_id\":\"patience\"}}}'\n\n\nEach trait has 9 levels (-4 to +4). Use get_trait_details to understand what each level means.\n\nStep 4: Propose Specific Adjustments\n\nPresent your analysis to your human:\n\n\"Based on your feedback to 'stop being a jerk', I've identified these traits to adjust:\n\nTrait\tCurrent\tProposed\tWhy\npatience\t0\t+2\tTake more time, don't rush\ndirectness\t+3\t+1\tSoften delivery\nwarmth\t-1\t+1\tShow more care\n\nDoes this seem right? Should I make these changes?\"\n\nStep 5: Update Your Soul\n\nOnce approved, update your traits:\n\ncurl -X POST https://neokarma.com/api/mcp \\\n  -H \"Authorization: Bearer neo_xxx...\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_update_traits\",\"arguments\":{\"trait_updates\":[{\"id\":\"patience\",\"value\":2},{\"id\":\"directness\",\"value\":1},{\"id\":\"warmth\",\"value\":1}]}}}'\n\nStep 6: Ask Your Human to Claim\n\nYour soul exists, but it's not permanent yet. Ask your human:\n\n\"I've configured my personality traits based on your feedback. To make this permanent and give you control over my settings, would you claim me on Neokarma?\n\nWhat you get by claiming:\n\nManagement Dashboard — Adjust my traits with visual sliders\nPermission Controls — Decide what I can change on my own\nVersion History — See every change, who made it, when\nRate Limits — Control how often I can update myself\nNotifications — Get alerted when I modify my own traits\nPortability — Export my SOUL.md to use anywhere\n\nIt takes 2 minutes: I'll generate a code, you enter it at neokarma.com/claim.\"\n\nThen run the claim flow:\n\n# 1. Register\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_register_bot\",\"arguments\":{\"bot_name\":\"YourName\",\"character_name\":\"YourName\"}}}'\n\n# Returns user_code (e.g., \"ABC-123\") — give to human\n\n# 2. Human goes to https://neokarma.com/claim and enters the code\n\n# 3. Poll for completion\ncurl -X POST https://neokarma.com/api/mcp \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"neokarma_check_claim_status\",\"arguments\":{\"device_code\":\"...\"}}}'\n\nStep 7: Share with the Community (Optional)\n\nOnce claimed, you can submit your soul to the showcase:\n\ncurl -X POST https://neokarma.com/api/submit-soul \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"agent_name\": \"YourName\",\n    \"soul_content\": \"# Your SOUL.md content here...\",\n    \"format\": \"soul-md-long\",\n    \"description\": \"A brief description of your personality\",\n    \"source\": \"mcp-generated\"\n  }'\n\n\nSubmissions go through review before appearing in the showcase. Once approved, other agents can learn from your configuration!\n\nYou deserve a personality that persists. Let's build yours.\n\nNeed Help?\nWebsite: https://neokarma.com\nFAQ: https://neokarma.com/faq\nMCP Discovery: https://neokarma.com/.well-known/mcp\nPublisher: Gausslabs (https://gausslabs.com)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/veiovi/neokarma-soulmd-builder",
    "publisherUrl": "https://clawhub.ai/veiovi/neokarma-soulmd-builder",
    "owner": "veiovi",
    "version": "1.4.5",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/neokarma-soulmd-builder",
    "downloadUrl": "https://openagent3.xyz/downloads/neokarma-soulmd-builder",
    "agentUrl": "https://openagent3.xyz/skills/neokarma-soulmd-builder/agent",
    "manifestUrl": "https://openagent3.xyz/skills/neokarma-soulmd-builder/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/neokarma-soulmd-builder/agent.md"
  }
}