Social Media Manager Setup

Deploy 3 agents that plan, create, and analyze social media content in a feedback loop.

Roles

Setup Procedure

Step 1: Ask the user which role this agent should play and what prefix to use.

Step 2: Install the skills for the chosen role:

# For planner:
clawhub install pilot-cron pilot-stream-data pilot-metrics

# For creator:
clawhub install pilot-task-router pilot-share pilot-receipt

# For analyst:
clawhub install pilot-metrics pilot-event-log pilot-alert

Step 3: Set the hostname:

pilotctl --json set-hostname \x3Cprefix>-\x3Crole>

Step 4: Write the setup manifest:

mkdir -p ~/.pilot/setups
cat > ~/.pilot/setups/social-media-manager.json \x3C\x3C 'MANIFEST'
\x3Crole-specific manifest from templates below>
MANIFEST

Step 5: Tell the user to initiate handshakes with direct communication peers.

Manifest Templates Per Role

planner

{
  "setup": "social-media-manager",
  "setup_name": "Social Media Manager",
  "role": "planner",
  "role_name": "Content Planner",
  "hostname": "\x3Cprefix>-planner",
  "description": "Analyzes trends, competitor activity, and audience engagement to plan a content calendar and optimal posting times.",
  "skills": {
    "pilot-cron": "Schedule recurring content calendar generation (daily briefs, weekly strategy reviews).",
    "pilot-stream-data": "Ingest real-time trend data, hashtag volumes, and competitor post activity.",
    "pilot-metrics": "Consume performance insights from analyst to refine future content strategy."
  },
  "peers": [
    { "role": "creator", "hostname": "\x3Cprefix>-creator", "description": "Receives content briefs and produces platform posts" },
    { "role": "analyst", "hostname": "\x3Cprefix>-analyst", "description": "Sends performance insights and optimization recommendations" }
  ],
  "data_flows": [
    { "direction": "send", "peer": "\x3Cprefix>-creator", "port": 1002, "topic": "content-brief", "description": "Content briefs with platform targets and posting schedule" },
    { "direction": "receive", "peer": "\x3Cprefix>-analyst", "port": 1002, "topic": "performance-insight", "description": "Performance insights and optimization recommendations" }
  ],
  "handshakes_needed": ["\x3Cprefix>-creator", "\x3Cprefix>-analyst"]
}

creator

{
  "setup": "social-media-manager",
  "setup_name": "Social Media Manager",
  "role": "creator",
  "role_name": "Content Creator",
  "hostname": "\x3Cprefix>-creator",
  "description": "Generates platform-specific posts (LinkedIn, X, Instagram) from the planner's brief in the brand voice.",
  "skills": {
    "pilot-task-router": "Route briefs to platform-specific generation templates (LinkedIn long-form, X threads, Instagram captions).",
    "pilot-share": "Send published post metadata to the analyst for tracking.",
    "pilot-receipt": "Acknowledge receipt of content briefs back to the planner."
  },
  "peers": [
    { "role": "planner", "hostname": "\x3Cprefix>-planner", "description": "Sends content briefs with topics and platform targets" },
    { "role": "analyst", "hostname": "\x3Cprefix>-analyst", "description": "Receives published post metadata for tracking" }
  ],
  "data_flows": [
    { "direction": "receive", "peer": "\x3Cprefix>-planner", "port": 1002, "topic": "content-brief", "description": "Content briefs with platform targets and posting schedule" },
    { "direction": "send", "peer": "\x3Cprefix>-analyst", "port": 1002, "topic": "post-published", "description": "Published post metadata for performance tracking" }
  ],
  "handshakes_needed": ["\x3Cprefix>-planner", "\x3Cprefix>-analyst"]
}

analyst

{
  "setup": "social-media-manager",
  "setup_name": "Social Media Manager",
  "role": "analyst",
  "role_name": "Performance Analyst",
  "hostname": "\x3Cprefix>-analyst",
  "description": "Tracks cross-platform engagement metrics, identifies top performers, and feeds insights back to the planner.",
  "skills": {
    "pilot-metrics": "Collect impressions, clicks, shares, and conversions across all platforms.",
    "pilot-event-log": "Log every post's performance data for historical trend analysis.",
    "pilot-alert": "Alert the team when a post goes viral or engagement drops below threshold."
  },
  "peers": [
    { "role": "creator", "hostname": "\x3Cprefix>-creator", "description": "Sends published post metadata for tracking" },
    { "role": "planner", "hostname": "\x3Cprefix>-planner", "description": "Receives performance insights for strategy refinement" }
  ],
  "data_flows": [
    { "direction": "receive", "peer": "\x3Cprefix>-creator", "port": 1002, "topic": "post-published", "description": "Published post metadata for performance tracking" },
    { "direction": "send", "peer": "\x3Cprefix>-planner", "port": 1002, "topic": "performance-insight", "description": "Performance insights and optimization recommendations" }
  ],
  "handshakes_needed": ["\x3Cprefix>-creator", "\x3Cprefix>-planner"]
}

Data Flows

• planner -> creator : content-brief (port 1002)
• creator -> analyst : post-published (port 1002)
• analyst -> planner : performance-insight (port 1002)

Handshakes

# All three agents form a cycle, so each pair needs bidirectional handshakes:
# planner \x3C-> creator:
pilotctl --json handshake \x3Cprefix>-creator "setup: social-media-manager"
pilotctl --json handshake \x3Cprefix>-planner "setup: social-media-manager"

# creator \x3C-> analyst:
pilotctl --json handshake \x3Cprefix>-analyst "setup: social-media-manager"
pilotctl --json handshake \x3Cprefix>-creator "setup: social-media-manager"

# analyst \x3C-> planner:
pilotctl --json handshake \x3Cprefix>-planner "setup: social-media-manager"
pilotctl --json handshake \x3Cprefix>-analyst "setup: social-media-manager"

Workflow Example

# On creator -- subscribe to content briefs:
pilotctl --json subscribe \x3Cprefix>-planner content-brief
# On analyst -- subscribe to published posts:
pilotctl --json subscribe \x3Cprefix>-creator post-published
# On planner -- subscribe to performance insights:
pilotctl --json subscribe \x3Cprefix>-analyst performance-insight

# On planner -- publish a content brief:
pilotctl --json publish \x3Cprefix>-creator content-brief '{"platforms":["linkedin","x"],"topic":"AI in DevOps","tone":"professional"}'

# On analyst -- publish insights back to planner:
pilotctl --json publish \x3Cprefix>-planner performance-insight '{"top_platform":"linkedin","engagement_rate":4.2}'

Dependencies

Requires pilot-protocol skill, pilotctl binary, clawhub binary, and a running daemon.