x-persona-management

name	x-persona-management
description	Manage X persona lifecycle, feed configuration, content generation, and draft workflows via x-persona-mcp tools. Covers persona creation, feed setup with watched accounts/subjects/schedules, content generation via Agent SDK, and the approve→publish pipeline.

X Persona & Feed Management Skill

Manage the full persona-to-publication pipeline: create personas, configure feeds, generate content, review drafts, and publish via GeeLark.

When to Use This Skill

• Creating or editing X personas (character definitions, voice, topics)
• Configuring feed monitoring (watched accounts, subjects, trending)
• Setting up content generation schedules
• Reviewing, approving, or rejecting generated drafts
• Publishing approved content to X via GeeLark
• Configuring agent settings (model, max turns)

Tool Discovery (Run First)

search_tools({ query: "xp_" })              // All 34 x-persona tools
search_tools({ query: "geelark_post" })      // Publishing tools
search_tools({ query: "vault_" })            // Account vault tools

Core Concepts

Persona

An ElizaOS-compatible character definition with name, bio, topics, style, and optional agent settings. Personas generate content independently -- they do NOT require a linked Twitter account.

Feed Config

One-to-one with a persona. Controls monitoring intervals, daily generation limits, and Telegram notifications. Has child entities: watched accounts, subjects, schedules.

Draft Lifecycle

generated → approved → published
                    ↘ rejected

Persona Management

Create a Persona

xp_create_persona({
  character: {
    name: "CryptoAnalyst",
    bio: "On-chain analyst tracking DeFi protocols and market structure. Data-driven, contrarian, concise.",
    username: "cryptoanalyst",
    topics: ["defi", "on-chain analytics", "market structure"],
    adjectives: ["analytical", "concise", "contrarian", "data-driven"],
    postExamples: [
      "TVL doesn't lie. Three protocols just crossed $1B with zero token incentives. That's real demand.",
      "Everyone's watching price. Nobody's watching the funding rate divergence. This happened twice before — both times preceded 30%+ moves."
    ],
    style: {
      all: ["Use data and metrics to support claims", "Be concise — tweets under 200 chars preferred"],
      post: ["No hashtags", "No emojis", "Thread for complex analysis"],
      reply: ["Be conversational", "Reference the original tweet's key point"],
      quote_tweet: ["Add original insight, don't just agree"],
      article: ["Use headers and data tables", "Cite sources"],
      long_form: ["Build a narrative arc", "End with actionable takeaway"]
    },
    settings: {
      model: "claude-sonnet-4-6",    // or claude-opus-4-6, claude-haiku-4-5-20251001
      maxTurns: 10,                   // Agent research turns (1-50)
      mcpServers: {                   // Per-persona MCP servers (optional)
        "signal8": {
          type: "stdio",
          command: "node",
          args: ["/path/to/sec-saas/packages/mcp-server/dist/stdio.js"],
          env: { "SIGNAL8_API_KEY": "sk_live_xxx" }
        }
      }
    }
  },
  account_ids: []  // Optional: link vault account IDs for publishing
})
// Returns: { id: "uuid", name: "CryptoAnalyst", ... }

Update a Persona (Partial)

xp_update_persona({
  persona_id: "uuid",
  character: {
    topics: ["defi", "on-chain analytics", "market structure", "MEV"],
    settings: { model: "claude-opus-4-6", maxTurns: 15 }
  }
})

Link Accounts to a Persona

xp_update_persona({
  persona_id: "uuid",
  account_ids: ["vault-account-uuid-1", "vault-account-uuid-2"]
})

List / Get / Delete

xp_list_personas({ include_stats: true })
xp_get_persona({ persona_id: "uuid" })       // Full character JSON + stats
xp_delete_persona({ persona_id: "uuid" })     // CASCADE: deletes all drafts

Feed Configuration

Create a Feed Config

xp_create_feed_config({
  persona_id: "uuid",
  monitor_interval_minutes: 30,       // Check watched accounts every 30m
  trending_interval_minutes: 60,      // Check trending topics every 60m
  max_daily_generations: 20,          // Cap daily content generation
  enabled: true,
  telegram_chat_id: "-1001234567890", // Optional: Telegram notifications
  telegram_enabled: false
})
// Returns: { id: "feed-config-uuid", ... }

Update Feed Config

xp_update_feed_config({
  config_id: "feed-config-uuid",
  max_daily_generations: 10,
  telegram_enabled: true
})

Get / List / Delete

xp_get_feed_config({ persona_id: "uuid" })           // By persona
xp_get_feed_config({ config_id: "feed-config-uuid" }) // By config ID
xp_list_feed_configs({ enabled_only: true })           // All enabled
xp_delete_feed_config({ config_id: "uuid" })           // CASCADE: all children

Watched Accounts

Monitor X accounts for tweets and replies that could trigger content generation.

// Add
xp_add_watched_account({
  feed_config_id: "uuid",
  x_username: "elonmusk",          // Without @
  monitor_tweets: true,
  monitor_replies: false            // Skip replies, just tweets
})

// List all for a feed
xp_list_watched_accounts({ feed_config_id: "uuid" })

// Update monitoring flags
xp_update_watched_account({
  account_id: "watched-account-uuid",
  monitor_replies: true
})

// Remove
xp_remove_watched_account({ account_id: "watched-account-uuid" })

Subjects

Define topic areas with keywords for trending topic filtering.

// Add
xp_add_feed_subject({
  feed_config_id: "uuid",
  subject: "DeFi",
  keywords: ["defi", "tvl", "yield", "liquidity", "protocol"],
  enabled: true
})

// List
xp_list_feed_subjects({ feed_config_id: "uuid" })

// Remove
xp_remove_feed_subject({ subject_id: "uuid" })

Schedules

Cron-based automated content generation triggers.

// Add a schedule
xp_add_feed_schedule({
  feed_config_id: "uuid",
  cron_expression: "0 9 * * *",          // Daily at 9am
  content_type: "tweet",                   // tweet|reply|quote_tweet|article|long_form
  prompt_template: "Write a tweet about the latest developments in {subject}",
  enabled: true
})

// Common cron patterns:
// "0 9 * * *"       → Daily at 9am
// "0 9,17 * * *"    → Twice daily at 9am and 5pm
// "0 */4 * * *"     → Every 4 hours
// "0 9 * * 1-5"     → Weekdays at 9am

// Update
xp_update_feed_schedule({
  schedule_id: "uuid",
  cron_expression: "0 8,12,18 * * *",     // Three times daily
  enabled: true
})

// List
xp_list_feed_schedules({ feed_config_id: "uuid" })

// Remove
xp_remove_feed_schedule({ schedule_id: "uuid" })

Content Generation

Generate a Tweet

xp_generate_tweet({
  persona_id: "uuid",
  topic: "DeFi yield farming trends",                    // Optional
  context: "Aave just launched v4 with unified liquidity", // Optional
  recent_tweets: ["Previous tweet 1", "Previous tweet 2"]  // For voice consistency
})
// Generates 5 candidates, self-scores, saves top one as draft
// Cost: ~$0.004 per generation
// Returns: { draft_id: "uuid", content: "...", score: 8.5 }

Generate a Reply

xp_generate_reply({
  persona_id: "uuid",
  target_tweet_id: "1234567890",
  target_tweet_text: "The original tweet text to reply to",
  target_tweet_author: "vitalikbuterin",
  tone: "add_value"  // agree|disagree|question|add_value|humorous
})

Create a Draft Directly (No AI)

xp_create_draft({
  persona_id: "uuid",
  type: "tweet",
  content: "Manually written tweet content",
  topic: "DeFi",
  reasoning: "Timely response to breaking news"
})

Draft Management

Review Drafts

// List all generated drafts for a persona
xp_list_drafts({ persona_id: "uuid", status: "generated" })

// Get full draft details
xp_get_draft({ draft_id: "uuid" })

Approve / Reject

// Approve for publishing
xp_approve_draft({ draft_id: "uuid" })

// Reject with feedback (stored for improving future generation)
xp_reject_draft({
  draft_id: "uuid",
  reason: "Too promotional, needs more data points"
})

Publish (After Approval)

Publishing requires a linked account with GeeLark:

// Step 1: Get account details
const persona = xp_get_persona({ persona_id: "uuid" })
// persona.account_ids → ["vault-account-uuid"]

// Step 2: Get vault account for phone_id
const account = vault_get_account({ account_id: "vault-account-uuid" })

// Step 3: Post via GeeLark
const { job_id } = geelark_post_tweet({
  account_id: account.id,
  phone_id: account.phone_id,
  text: draft.content,
  auto_stop: true
})
// Poll geelark_check_job_status({ job_id }) every 10s

// Step 4: Mark published
xp_mark_published({
  draft_id: "uuid",
  tweet_id: "returned_tweet_id",
  account_id: account.id
})

Cleanup

// Expire drafts older than 72 hours
xp_expire_old_drafts({ max_age_hours: 72 })

Feed Items

Feed items track everything that flows through the feed: monitored tweets, trending items, generated content, schedule triggers.

// List items with pagination
xp_list_feed_items({
  feed_config_id: "uuid",
  item_type: "generated_content",  // Optional filter
  limit: 20,
  offset: 0
})

// Count items (for stats dashboards)
xp_count_feed_items({
  feed_config_id: "uuid",
  item_type: "generated_content",
  since: "2026-03-18T00:00:00Z"   // Today's count
})

// Create an item (used by monitoring services)
xp_create_feed_item({
  feed_config_id: "uuid",
  item_type: "monitored_tweet",
  source_tweet_id: "1234567890",
  source_username: "elonmusk",
  source_text: "Tweet text here"
})

Complete Setup Flow

Full pipeline from scratch:

// 1. Create persona
const persona = xp_create_persona({
  character: { name: "MyPersona", bio: "...", topics: ["ai", "tech"] }
})

// 2. Create feed config
const config = xp_create_feed_config({
  persona_id: persona.id,
  monitor_interval_minutes: 30,
  max_daily_generations: 10
})

// 3. Add watched accounts
xp_add_watched_account({ feed_config_id: config.id, x_username: "openai" })
xp_add_watched_account({ feed_config_id: config.id, x_username: "anthropaborgs" })

// 4. Add subjects
xp_add_feed_subject({
  feed_config_id: config.id,
  subject: "AI",
  keywords: ["llm", "gpt", "claude", "transformer", "agi"]
})

// 5. Add schedule
xp_add_feed_schedule({
  feed_config_id: config.id,
  cron_expression: "0 9,17 * * *",
  content_type: "tweet",
  prompt_template: "Write a tweet about recent AI developments"
})

// 6. Optionally link an account for publishing
xp_update_persona({ persona_id: persona.id, account_ids: ["vault-uuid"] })

Agent Settings Reference

Persona character.settings controls the content generation agent:

Setting	Default	Description
model	claude-sonnet-4-6	Claude model for generation
maxTurns	10	Max agent research/thinking turns

Available models:

• claude-sonnet-4-6 — Best balance of speed, quality, cost (recommended)
• claude-opus-4-6 — Highest quality, slower, more expensive
• claude-haiku-4-5-20251001 — Fastest, cheapest, lower quality

Dashboard UI

All operations above are also available via the dashboard:

• X Ops → Personas: Create/edit personas, agent settings
• Feeds: Timeline view, settings (config, accounts, subjects, schedules), approve/reject/publish