token-researchlisted

# token-research (CLI-driven EVM token analysis) Drive the `token-research` CLI to produce on-chain-grounded, provenance-tracked token analysis. The CLI is the engine; this skill routes the request to the right command(s) and reads back the structured output. ## Step 0: Route first (data regime) Apply this BEFORE running anything: ``` EVM token with a known or derivable address (Ethereum / Base / Arbitrum / Optimism)? ├─ yes → use this skill (below) └─ no → STOP. Hand off to the `cpd-crypto-analysis` skill: • non-EVM L1 (HBAR, SOL, ATOM, TIA, TON, native BTC…) • pre-TGE / no token yet (e.g. a points program) • a purely qualitative trust / team / governance question ``` The CLI is EVM-first and token-centric. Its refusals are the hand-off signal, not a failure. See `docs/skills-architecture.md`. ## Setup (once) ```bash pip install -e .[dev] # installs the `token-research` console script # optional, for momentum/portfolio price features: pip install -e ".[ccxt]" ``` Run with the console script `token-research <command> …`, or without installing via `PYTHONPATH=src python3 -m token_research <command> …`. Add `TOKEN_RESEARCH_OFFLINE=1` to skip all network calls (deterministic, for smoke checks). Always pass `--address` and `--chain` when known — it pins the exact contract and skips resolver guesswork (squatter-token defense). Default output is JSON; `deep-report` also supports `--format markdown`. ## Modes (pick by purpo