x-alpha-scout

Original source / Raw SKILL.md

---
name: x-alpha-scout
description: X/Twitter alpha scanner for crypto and NFTs. Use when: (1) user wants daily alpha reports, (2) analyzing a specific token/NFT/project from X sentiment. GitHub: github.com/hammad-btc/alpha-scout-skill
---

# X Alpha Scout

Your agent's X/Twitter alpha scanner. Two things: daily reports and on-demand analysis.

## Prerequisites

**Environment variables:**
```bash
export X_AUTH_TOKEN="your_twitter_auth_token"
export X_CT0="your_twitter_ct0_cookie"
```

**Verify:**
```bash
bird whoami --auth-token "$X_AUTH_TOKEN" --ct0 "$X_CT0"
```

---

## Feature 1: Daily Alpha Report (Auto at 00:00 UTC)

**User says:** "Run my daily alpha" or "Get today's report"

**What you do:**

```bash
# Scan for overnight alpha
bird search "(buying OR bought OR aping OR loading up) (ticker OR token OR \$)" -n 25
bird search "(minting OR mint OR free mint) NFT" -n 20
bird search "(just launched OR stealth launch) token" -n 15
bird search "(gem OR undervalued OR 100x) crypto" --min-likes 10 -n 15
```

**Generate report in this exact format:**

```markdown
# 🦅 Alpha Report — Feb 10, 2026

### 1. Good Morning
[Simple greeting]

### 2. Crypto Market Update
- BTC: $[price] ([+/-]% 24h)
- ETH: $[price] ([+/-]% 24h)
- SOL: $[price] ([+/-]% 24h)
- Fear & Greed Index: [value] ([Extreme Fear/Fear/Neutral/Greed/Extreme Greed])

### 3. News of the Day
- [Major Web3 announcement](https://x.com/...) — Brief summary
- [Regulation/news affecting market](https://x.com/...) — Brief summary
- [Any market-moving world news](https://x.com/...) — Brief summary

### 4. Crypto Twitter (CT)
- Main narrative: [What's the hot topic today?]
- Key trends: [New meta, drama, or shifts]
- Notable accounts: [Who's driving conversation]

### 5. NFTs Market Update
**ETH Eco:** [2-3 sentence paragraph on top ETH ecosystem updates — NFTs, tokens, protocols. Skip if nothing significant.]

**Bitcoin Eco:** [2-3 sentence paragraph on top Bitcoin/Ordinals market. Skip if nothing significant.]

**Sol Eco:** [2-3 sentence paragraph on top Solana ecosystem — NFTs, DeFi, memes. Skip if nothing significant.]

**Notable Mints:**
- Minting Today: [@account1](https://x.com/account1) [@account2](https://x.com/account2) [@account3](https://x.com/account3) (only good, hyped drops — embed X profile links)
- Upcoming Mints: [@account4](https://x.com/account4) [@account5](https://x.com/account5) (worth keeping an eye on — embed X profile links)

If none worth mentioning, say "No major mints detected."

### 6. Alpha from Reputable Figures:
- Top calls: [What are reputable accounts buying/minting? Include @username]
- High-conviction signals: [Who's aping what with size/proof — include @username]
- WL opportunities: [Any good drops they mentioned — include @username]
- Emerging narratives: [New meta or trend being discussed — include @username]
- Notable exits/warnings: [Who's selling or warning about what — include @username]

### 7. Extra / Warnings
- [Any red flags or opportunities noticed]
- [Personal observations]

---
*Report time: 00:00 UTC | NFA/DYOR*
```

**Deliver:** Send to user via their preferred channel (Discord, Telegram, etc.)

---

## Feature 2: On-Demand Analysis

**User says:** "What do you think of $PEPEAI?" or "Analyze FomoBears NFT"

**What you do:**

```bash
# Deep scan this specific asset
bird search "$PEPEAI" -n 30
bird search "$PEPEAI (gem OR scam OR rug OR buy)" -n 20
```

**Analyze gathered tweets:**

1. **Count sentiment:** Bullish vs Bearish vs Neutral
2. **Identify high-conviction posts:** Position sizes, wallet proofs, detailed threads
3. **Check high-rep accounts:** Are known good callers in or out?
4. **Look for red flags:** Contract issues, copycat names, anon team

**Deliver analysis in this exact format:**

```
📊 CT Sentiments:
[4-5 line summary based on top 20-30 recent tweets about the asset. What are people saying? Any patterns? Hype or concern? Specific details about the project/token/NFT]
📈 Overall: [Bullish/Bearish/Neutral] (assessment at end of CT Sentiments section)

🐋 Takes of High-Rep Accounts:
[@Influencer1: "quote or summary of their take" — Bullish]
[@Influencer2: "quote or summary of their take" — Bearish]
[Or: No noticeable activity detected from high-rep accounts — Bearish]

⚠️ Red Flags:
[Any contract issues, anon team, copycat name, LP not locked, etc. Or: None detected]

📊 Score: XX/100

✅ Verdict: [High/Medium/Low confidence — Bullish/Neutral/Bearish]

⚡ NFA / DYOR
```

**How to gather data:**

```bash
# Get general sentiment tweets
bird search "$TICKER" -n 30

# Get high-rep account takes specifically
bird search "$TICKER (from:DegenKing OR from:AlphaKing OR from:CryptoGem)" -n 20
# Add more KOLs as needed
```

**Scoring guide:**
- **90-100:** Strong bullish consensus, high-reps bullish, no red flags
- **70-89:** Moderate bullish, some high-reps in, minor concerns
- **50-69:** Mixed/neutral, no clear direction or high-reps silent
- **30-49:** Bearish signals, some red flags or high-reps warning
- **0-29:** Strong bearish, multiple red flags, avoid

---

## Signal Scoring Guide

**CT Sentiment Score (0-100):**
- **80-100:** Strong bullish consensus, high-rep accounts in, no red flags
- **50-79:** Mixed or moderate sentiment, do more research
- **<50:** Bearish consensus or multiple red flags detected

**What to look for:**
- **Bullish:** "gem", "undervalued", "loading up", "next 100x"
- **Bearish:** "rug", "scam", "avoid", "dumping"
- **High-conviction:** Specific numbers ("bought $5k"), wallet screenshots, detailed threads
- **Red flags:** Contract unverified, LP not locked, copycat name, team completely anon

---

## Quick Commands

| Task | Command |
|------|---------|
| Daily report | Run scans for last 24h, compile top calls |
| Analyze asset | `bird search "$TICKER" -n 30` |
| Check specific caller | `bird search "from:username" -n 20` |
| Find mints | `bird search "free mint OR minting now NFT" -n 15` |

---

## Example Sessions

**User:** "Get my alpha report"

**You:** Run the 4 daily scans → compile top calls → format report → deliver

---

**User:** "What about $MOONSHOT?"

**You:** Search "$MOONSHOT" (30 tweets) → analyze sentiment → check for red flags → deliver analysis with score + verdict + NFA

---

**User:** "Is @DegenKing reliable?"

**You:** Search "from:DegenKing" → review their recent calls → give qualitative assessment: "Known for high-conviction calls, recent streak looks solid" or "Mixed bag lately, verify before following"

---

*Built for the agent economy. NFA. DYOR.* 🦅


---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### README.md

```markdown
# X Alpha Scout

Turn your AI agent into an alpha-hunting machine. This skill enables agents to scan X/Twitter for crypto calls, NFT mints, and deliver daily intelligence reports.

## What It Does

- **Comprehensive Daily Alpha Reports** — Auto-generated at 00:00 UTC with market updates, news, CT sentiment, NFT ecosystem coverage (ETH/BTC/SOL), alpha from reputable figures, and warnings
- **On-Demand Analysis** — Ask about any token/NFT and get CT sentiment breakdown

## Perfect For

- Agents that need daily market intelligence
- Traders who want CT sentiment on specific plays
- Anyone wanting structured alpha without the noise

## Installation

1. **Install bird** — X/Twitter CLI tool (by founder of OpenClaw)
   ```bash
   # Via Homebrew (macOS/Linux)
   brew install steipete/tap/bird
   
   # Or download from releases (if brew doesn't work)
   # https://github.com/steipete/bird/releases
   ```
   
2. **Get X credentials:**
   - Auth token (`X_AUTH_TOKEN`)
   - CT0 cookie (`X_CT0`)
   
3. **Verify access:**
   ```bash
   bird whoami --auth-token "$X_AUTH_TOKEN" --ct0 "$X_CT0"
   ```

## Usage

**Daily Report:**
> "Run my daily alpha"

**On-Demand Analysis:**
> "What do you think of $PEPEAI?"
> "Analyze Pudgy Penguins"

## Example Daily Report

```markdown
# 🦅 Alpha Report — Feb 10, 2026

### 1. Good Morning
Rise and grind — market's showing some life.

### 2. Crypto Market Update
- BTC: ~$69,400 (+3% 24h)
- ETH: ~$2,318 (-3% 24h)
- SOL: ~$86 (stable)
- Fear & Greed Index: 9 (Extreme Fear)

### 3. News of the Day
- [Pudgy Penguins teases Visa credit card](https://x.com/coingecko/status/...)
- [Tether announces LayerZero investment](https://x.com/PeteyK/status/...)

### 4. Crypto Twitter (CT)
- Main narrative: AI agents running — $BANKR launchpad live
- @pudgypenguins dominating with Visa teaser

### 5. NFTs Market Update

**ETH Eco:** Pudgy Penguins holding at ~4.5 ETH floor. D3lMundos pumped 138% with whale buying.

**Bitcoin Eco:** Taproot Wizards quiet — no major moves.

**Sol Eco:** Backpack TGE coming — 25% supply to community. Mad Lads floor ~$850.

**Notable Mints:**
- Minting Today: [@owlbiteth](https://x.com/owlbiteth) [@popisinger](https://x.com/popisinger)
- Upcoming Mints: [@RokuTrade](https://x.com/RokuTrade) [@BlobaETH](https://x.com/BlobaETH)

### 6. Alpha from Reputable Figures:
- Top calls: @shivst3r all-in on Pudgy expansion — $100K daily revenue
- High-conviction: @aixbt_agent lists bankr, megaeth as best setups
- WL opportunities: @The_sugargirl mentioned RokuTrade utility NFT
- Emerging narratives: AI agents launching tokens autonomously
- Notable warnings: @somanyfigs notes Pudgy floor -82% from ATH

### 7. Extra / Warnings
- Extreme fear index = potential local bottom
- NerdsOnEth reveal issues — floor down 50%

---
*Report time: 00:00 UTC | NFA/DYOR*
```

## On-Demand Analysis Format

When you ask about a specific asset, you get:

```
📊 CT Sentiments:
[4-5 line summary of what CT is saying]

📈 Overall: [Bullish/Bearish/Neutral]

🐋 Takes of High-Rep Accounts:
[@username: "their take" — Bullish/Bearish]
[Or: No noticeable activity — Bearish]

⚠️ Red Flags:
[Any issues found]

📊 Score: XX/100

✅ Verdict: [High/Medium/Low confidence — Sentiment]

⚡ NFA / DYOR
```

## How It Works

**Stack:**
- `bird` — X/Twitter CLI by founder of OpenClaw (install separately, no API costs)
- `x-alpha-scout` skill — The playbook for what to scan and how to format
- Your agent's reasoning — Parses and structures the alpha

Bird is NOT pre-installed with OpenClaw. Install it via brew or download from releases. Your agent brings its own X credentials, you bring the intelligence.

No Twitter API costs. No rate limits. Just raw alpha.

## License

MIT — Use it, fork it, build on it.

---

Built for the agent economy. 🦅

```

### _meta.json

```json
{
  "owner": "hammadbtc",
  "slug": "x-alpha-scout",
  "displayName": "X Alpha Scout",
  "latest": {
    "version": "1.0.0",
    "publishedAt": 1770761096791,
    "commit": "https://github.com/openclaw/skills/commit/0d60bc0b2e6a7324e2513a6657e7b4523c0623d3"
  },
  "history": []
}

```

### example-alpha-report.md

```markdown
# Example Alpha Report

*Generated by X Alpha Scout — Feb 10, 2026*

---

# 🦅 Alpha Report — Feb 10, 2026

### 1. Good Morning
Rise and grind — market's showing some life after the blood bath. Let's see what's cooking.

### 2. Crypto Market Update
- BTC: ~$69,400 (+3% 24h) — bounced from $75K lows
- ETH: ~$2,318 (-3% 24h) — still weak, underperforming BTC
- SOL: ~$86 (stable) — holding ground
- Fear & Greed Index: 9 (Extreme Fear)

### 3. News of the Day
- [Pudgy Penguins teases Visa credit card](https://x.com/coingecko/status/2021269748487516232) — IRL adoption play with KAST partnership
- [Tether announces strategic investment in LayerZero](https://x.com/PeteyK/status/2021282507518562673) — First of series of announcements
- [Chainlink selected by Bank of England](https://x.com/PeteyK/status/2021282507518562673) — CBDC/collateral work
- [MegaETH mainnet goes live](https://x.com/Friend3AI/status/2021265535577502182) — Feb 9 launch, early ecosystem moving

### 4. Crypto Twitter (CT)
- Main narrative: AI agents still running — @bankrbot launchpad live, autonomous token deployment
- @pudgypenguins dominating conversations — Visa card, NYC pop-up, GIPHY billions of views
- NFT floor prediction markets launched — @UseVault777 allowing bets on floors
- Sentiment: Extreme fear but smart money accumulating

### 5. NFTs Market Update

**ETH Eco:** Pudgy Penguins holding strong at ~4.5 ETH floor with major catalysts. @basebros2k25 notes Punks and Penguins decoupling from "alt-NFT" crash. @ashishknows reports D3lMundos pumping 138% with BAYC whale buying.

**Bitcoin Eco:** Taproot Wizards quiet — needs ~11 BTC sweep to return to mint price. General Ordinals market muted, no major trends detected.

**Sol Eco:** @Backpack Exchange TGE coming — 25% supply to community. Mad Lads floor ~$850, DeGods ~$1,200. @Ezzitrade shilling EZZI World at $23 entry.

**Notable Mints:**
- Minting Today: [@owlbiteth](https://x.com/owlbiteth) [@popisinger](https://x.com/popisinger) (Android mint ends tomorrow)
- Upcoming Mints: [@RokuTrade](https://x.com/RokuTrade) [@FROGE69mg](https://x.com/FROGE69mg) [@BlobaETH](https://x.com/BlobaETH) — keep an eye on them

### 6. Alpha from Reputable Figures:
- Top calls: @shivst3r all-in on Pudgy Penguins brand expansion — $100K daily revenue, billion GIPHY views
- High-conviction signals: @aixbt_agent lists pippin, aster, wlfi, pepe, trump, fartcoin, bankr, megaeth as having best setups
- WL opportunities: @The_sugargirl mentioned @RokuTrade utility NFT with free mint, 555 supply
- Emerging narratives: AI agent tokens launching via @bankrbot — $WOW token went from $2K to $15.5K
- Notable exits/warnings: @somanyfigs notes Pudgy floor -82% from ATH despite brand wins — value accrual concerns

### 7. Extra / Warnings
- $BNKR pushing highs — AI agent launchpad narrative hot but manage risk
- Random tickers pumping (ABOS, XYZ, ZOM) — bot spam, ignore
- NerdsOnEth reveal issues — floor down 50%, approach with caution
- Extreme fear index = potential local bottom, but don't FOMO

---
*Report time: 18:30 UTC | NFA/DYOR*

```

### example-analysis.md

```markdown
# Example On-Demand Analysis

*Generated by X Alpha Scout — Feb 10, 2026*

---

## Analysis: $PEPEAI

📊 **CT Sentiments:**
$PEPEAI has been gaining significant traction over the past 48 hours. Multiple threads highlighting the AI narrative and strong community engagement. Several degens mentioning they've aped in with size. Some concerns about contract being relatively new, but overall excitement is high. Whale wallets spotted accumulating.

📈 **Overall:** Bullish

🐋 **Takes of High-Rep Accounts:**
@DegenKing: "50% of my portfolio into $PEPEAI, this is the one. AI meta is here." — Bullish
@AlphaKing: "Watching $PEPEAI closely, chart looks primed." — Bullish
@CryptoGem: "Not in $PEPEAI yet, waiting for a dip." — Neutral

⚠️ **Red Flags:** None detected

📊 **Score:** 87/100

✅ **Verdict:** High confidence — Bullish

⚡ **NFA / DYOR**

---

## Analysis: Pudgy Penguins

📊 **CT Sentiments:**
Pudgy Penguins has been dominating CT conversations with major catalysts. The Visa/KAST credit card teaser just dropped today, driving significant hype. Team continues executing on brand expansion with NYC Valentine's pop-up and Abstract Chain integration. Some bearish voices note floor price is down 82% from ATHs despite brand wins, questioning value accrual. Overall sentiment is hype-driven on recent news with underlying concerns about NFT market conditions.

📈 **Overall:** Bullish

🐋 **Takes of High-Rep Accounts:**
@shivst3r (Pudgy team): "$100K daily revenue, billion views on GIPHY, Valentine's product sold out. This is the year of the Penguin." — Bullish
@chillymcfrost: "Pudgy increasingly looks like a leveraged ETH bet. Volatility persists near term. Longer term, highly bullish." — Bullish
@somanyfigs: "Floor price -82% and PENGU -73%. Value accrual completely broken as brand success means nothing for bag holders." — Bearish

⚠️ **Red Flags:**
- Floor price down significantly from ATH (~4 ETH vs $145K ATH)
- Some CT questioning if brand success = holder value
- General NFT market in bearish conditions

📊 **Score:** 72/100

✅ **Verdict:** Medium confidence — Bullish

⚡ **NFA / DYOR**

---

## Analysis: NerdsOnEth

📊 **CT Sentiments:**
NerdsOnEth just completed their reveal today after a free mint that pumped to ~0.0075 ETH before settling around 0.0036-0.004 ETH. Reveal process had technical issues (metadata mismatches, upload chaos) which caused frustration. Mixed reactions to the art — some holders flexing clean pulls, others disappointed. One account calling it a "scam" on reveal day. Volume was strong initially (10+ ETH) but sentiment is split between "sweep before it runs" and "rug vibes."

📈 **Overall:** Neutral

🐋 **Takes of High-Rep Accounts:**
No noticeable activity detected from high-rep accounts — Bearish

⚠️ **Red Flags:**
- Reveal had technical issues (metadata mismatches, upload chaos)
- One account calling it "Scam" on official reveal tweet
- Floor dropped ~50% from initial pump (0.0075 → 0.004 ETH)
- Some holders reporting disappointment with pulls

📊 **Score:** 35/100

✅ **Verdict:** Low confidence — Bearish

⚡ **NFA / DYOR**

```

### scripts/parse_calls.py

```python
#!/usr/bin/env python3
"""
Parse X/Twitter search results into structured call objects.
Usage: python3 parse_calls.py < bird_output.json
"""

import json
import re
import sys
from datetime import datetime

def extract_ticker(text):
    """Extract $TICKER from text"""
    tickers = re.findall(r'\$([A-Za-z]{2,10})', text)
    return tickers[0] if tickers else None

def extract_conviction(text):
    """Score conviction based on keywords"""
    high = ['all in', '50%', '70%', '100%', 'life savings', 'yolo']
    medium = ['loading up', 'accumulating', 'bought', 'entering']
    low = ['looking at', 'might buy', 'considering']
    
    text_lower = text.lower()
    if any(h in text_lower for h in high):
        return 'HIGH'
    elif any(m in text_lower for m in medium):
        return 'MEDIUM'
    elif any(l in text_lower for l in low):
        return 'LOW'
    return 'UNKNOWN'

def parse_tweet(tweet_text, username, timestamp):
    """Parse a single tweet into call object"""
    ticker = extract_ticker(tweet_text)
    conviction = extract_conviction(tweet_text)
    
    # Determine asset type
    asset_type = 'token'
    if any(word in tweet_text.lower() for word in ['nft', 'mint', 'collection']):
        asset_type = 'nft'
    
    # Determine call type
    call_type = 'shill'
    if any(word in tweet_text.lower() for word in ['bought', 'buying', 'ape']):
        call_type = 'buy'
    elif any(word in tweet_text.lower() for word in ['minting', 'mint']):
        call_type = 'mint'
    
    return {
        'caller': username,
        'asset': ticker or 'Unknown',
        'asset_type': asset_type,
        'call_type': call_type,
        'conviction': conviction,
        'timestamp': timestamp,
        'raw_text': tweet_text[:200] + '...' if len(tweet_text) > 200 else tweet_text
    }

if __name__ == '__main__':
    # Read from stdin or file
    data = json.load(sys.stdin) if not sys.stdin.isatty() else []
    
    calls = []
    for tweet in data:
        call = parse_tweet(
            tweet.get('text', ''),
            tweet.get('username', 'unknown'),
            tweet.get('timestamp', datetime.now().isoformat())
        )
        if call['asset'] != 'Unknown':
            calls.append(call)
    
    # Output formatted calls
    print(json.dumps(calls, indent=2))

```