skillhub

SkillHub — Smart Resale Agent

A collection of 8 Claude Code skills + an MCP Server implementing a Multi-Platform Smart Resale Agent: an AI-powered conversational workflow for C2C second-hand resale that reduces the barriers to listing and selling pre-owned goods.

v2: Now runs as a standard MCP server (JSON-RPC over stdio) that any MCP-compatible client can call — Claude Desktop, Cursor, VS Code, or custom web frontends.

Architecture

skillhub/
├── broker_core/                  # Shared engine (pip install -e .)
│   ├── session_manager.py        # Browser login → cookie persistence
│   ├── platform_client.py        # Authenticated platform API clients
│   ├── state_manager.py          # Listing lifecycle state (~/.broker/listings.json)
│   ├── scheduler.py              # launchd (macOS) / cron (Linux) registration
│   ├── audit_logger.py           # Append-only Transparency Log (~/.broker/audit.jsonl)
│   └── mcp_server.py             # ★ MCP Server — 7 tools via JSON-RPC
├── guardrails/                   # ★ Prompt framework (v2)
│   ├── Omni-Agent-Guardrails.yaml
│   └── README.md
├── skills/                       # 8 Claude Code skills
│   ├── personal-broker/          # Hub: orchestrates the 7-step pipeline
│   ├── broker-recognize/         # Step 1: Photo → product info
│   ├── broker-auth/              # Step 3: Bind platform accounts
│   ├── broker-price/             # Step 2: Authenticated price research
│   ├── broker-card/              # Step 4: Listing cards → auto-publish
│   ├── broker-schedule/          # Step 5: Repricing interval & cron/launchd
│   ├── broker-fuse/              # Step 6: Price Shield (floor price)
│   └── broker-delist/            # Step 7: Auto-detect sale → delist all
├── tests/                        # 41 tests
└── docs/                         # Setup guides for MCP clients

The 7-Step Pipeline

📷 broker-recognize  →  Photo → structured product info
🔐 broker-auth       →  Open browser → log in once → session persisted
🔍 broker-price      →  Search platforms with session → transparency report
🛡️ broker-fuse       →  ⚠️ GLOBAL INTERCEPTOR — set unbreachable floor price BEFORE publishing
📋 broker-card       →  Generate cards → validate floor → user confirms → auto-publish
⏰ broker-schedule   →  Register launchd/cron for daily repricing checks (floor-gated)
✅ broker-delist     →  Scheduler detects sale → auto-delist all platforms (no confirmation)

Each skill can also be invoked standalone (e.g., /broker-price for pricing only).

Prerequisites

ANTHROPIC_API_KEY (required)

broker-recognize uses the Anthropic API (Claude Vision) to analyze product photos. Set your API key:

export ANTHROPIC_API_KEY="sk-ant-..."

Without this key, photo recognition will fail.

Python 3.9+

Playwright (for platform auth)

Quick Start

Pick one path. Path A is recommended for most users.

Path A: Claude Desktop (recommended, 5 minutes)

Step 1: Install

git clone https://github.com/madguyevans-creator/skillhub.git
cd skillhub && pip install -e .
pip install playwright && playwright install chromium

Step 2: Get API key (one-time) Go to console.anthropic.com → API Keys → create key. Save it once:

echo 'sk-ant-your-key' > ~/.broker/api_key

Step 3: Configure Claude Desktop Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "skillhub": {
      "command": "python3",
      "args": ["/path/to/skillhub/broker_core/mcp_server.py"],
      "env": { "BROKER_MOCK_MODE": "true" }
    }
  }
}

Step 4: Restart Claude Desktop. Done.

Open Claude Desktop, say "帮我卖掉这双鞋" + upload photo. Claude automatically calls 7 MCP tools in the correct order.

Path B: Claude Code CLI

git clone https://github.com/madguyevans-creator/skillhub.git
cd skillhub && pip install -e .
cp -r skills/* ~/.claude/skills/

Use inside Claude Code:

• /personal-broker — full pipeline
• /broker-recognize — analyze product photo
• /broker-price — price research
• /broker-fuse — set floor price

Path C: Demo without any accounts (mock mode)

By default BROKER_MOCK_MODE=true. Everything works with realistic simulated data — no API key, no platform accounts needed. Photo recognition returns a demo Nike sneaker.

git clone https://github.com/madguyevans-creator/skillhub.git
cd skillhub && pip install -e .
# Done — you're in mock mode. Use Path A or B above.

Going real: turn off mock mode

export BROKER_MOCK_MODE=false
# Then bind platform accounts:
python3 skills/broker-auth/scripts/auth.py --all
# This opens a browser. Log into each platform once. Cookies persist.

Sandbox / Mock Mode

By default, BROKER_MOCK_MODE=true — all platform API calls (search, publish, delist) return realistic simulated data. No real HTTP requests are made. This allows: