gate-info-web3
General Rules
⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding.
Do NOT select or call any tool until all rules are read. These rules have the highest priority.
→ Read gate-runtime-rules.md
→ Also read info-news-runtime-rules.md for gate-info and gate-news shared rules (tool degradation, report standards, security, routing).
- Only call MCP tools explicitly listed in this skill. Tools not documented here must NOT be called, even if they
exist in the MCP server.
CLI and playbook contract
- Scope naming: Frame answers as Web3 / on-chain / protocol behavior. Do not narrow the narrative to “DeFi-only” unless the user’s question is strictly DeFi/TVL/yield.
gate-info-defianalysis is a legacy alias for routing only — the canonical skill id is gate-info-web3.
- Legacy commands MUST exist under
gate-cli v0.5.2. When shortcuts_enabled (>= 0.7.6), use playbook shortcut / additional_shortcut blocks; otherwise legacy commands. When preflight route is CLI, do not invoke Gate MCP tools from this skill.
- Always pass
--format json on data-collection commands.
- Separate evidence types in the report: label on-chain / CLI facts vs community or media interpretation (news, web search, UGC). Never present rumor as chain truth.
- Required slots (
address+chain, token+chain, platform, exchange+asset, symbol, entity_query) must be explicit; if ambiguous, ask — do not guess chain or contract.
- Final user-facing reports may use the user’s locale; this
SKILL.md stays English for discovery (see repository CLAUDE.md rule 1).
Step 0 — Preflight
Follow skills/_shared/preflight.md verbatim:
- Run
gate-cli preflight --format json; parse .route, .status, .user_message.
- Branch:
CLI → continue; MCP_FALLBACK → emit __FALLBACK__ and halt; BLOCK → echo user_message and halt.
- When
status == "ready_with_migration_warning", Step 3 appends one migrate hint at the end of the report.
- Step 0.5: Set
cli_version and shortcuts_enabled per skills/_shared/cli-version-routing.md.
Do NOT run any info / news data call until route == "CLI".
Step 1 — Intent routing
Map the user query to exactly one playbook id from playbooks/gate-info-web3.yaml.
| Playbook id |
When to pick |
Required slots |
address_tracking |
Trace a wallet / “who is this address” / recent on-chain activity (behavior, not safety verdict). |
address, chain |
token_onchain |
Token-level flow / holders / smart-money style signals for a known token + chain. |
token, chain |
entity_intel |
Named desk / fund / entity (e.g. what a named desk is doing). |
entity_query |
protocol_platform |
Protocol TVL, fees, volume, profile, history, or yield on a named platform (e.g. Uniswap, Aave). |
platform |
exchange_reserves |
Exchange reserve / proof-of-reserves style questions for an asset. |
exchange, asset |
liquidation_heatmap |
Perp / futures liquidation density by price (which price levels see liquidations). |
symbol |
stablecoin_bridge |
Stablecoin market / peg / chain distribution, or bridge rankings — not a single-token DEX question. |
— |
token_onchain_social |
User wants on-chain data plus news/sentiment/UGC in one pass. |
token, chain |
Slot extraction notes
chain: normalize to ids the CLI accepts (eth, bsc, arbitrum, base, solana, ...). If missing, ask.
platform: accept fuzzy names; if multiple matches are plausible, run gate-cli info platformmetrics search-platforms only with flags verified in gate-cli info platformmetrics search-platforms --help, pick one slug, then run get-defi-overview / get-platform-info / get-yield-pools as the playbook lists.
token vs symbol: on-chain playbooks use token (+ chain); reserves / heatmap often use listed symbol (e.g. BTC, USDC).
Cross-skill routing at Step 1
| User signal |
Route to |
| Safety / honeypot / blacklist / compliance verdict (safety-first) |
gate-info-risk (primary) |
| General research, fundamentals, macro, multi-coin compare without on-chain/protocol framing |
gate-info-research (primary) |
| Pure “why did it move”, “community narrative”, no on-chain ask |
gate-news-intel (primary) |
Step 2 — Data collection
Execute the chosen playbook. Commands in the same parallel_group may run concurrently; wait for the group before the next.
Shortcut routing (gate-cli >= 0.7.6)
When shortcuts_enabled, run playbook shortcut blocks per skills/_shared/cli-version-routing.md:
| Playbook |
Shortcut |
address_tracking |
info +address-tracker |
token_onchain |
info +token-onchain |
token_onchain_social |
+token-onchain then +community-scan when symbol_present (coin: {symbol}); resolve ticker from coin_context when token is contract_address. +community-scan covers UGC/X/sentiment only — news_brief (search-news headlines) runs via post_shortcut_optional_ids. All news ids require symbol_present; skip them if unresolved (do not pass contract to --coin). |
Note missing_sections may include trace-fund-flow or smart_money — cite in report.
Legacy-only paths
info onchain trace-fund-flow and info onchain get-entity-profile: not shipped. Use get-address-info + get-address-transactions or news feed web-search.
- Below 0.7.6, use legacy
commands in the playbook YAML (plus optional search-platforms pre-check for fuzzy platform names).
Failure policy
- Required command fails → abort, surface CLI error, no fabricated section.
- Optional command fails → mark the matching subsection as no data in Step 3.
- News/web search may be partial or opinion-heavy — tag those lines as community / media, not as on-chain facts.
Step 3 — Synthesis
Produce exactly six sections, in this order (section titles in the final user report may be localized; structure is fixed):
Report template
## Web3 intel — {subject}
### 1. Subject and executive takeaways
- Objects (address / token / protocol / exchange / entity / theme)
- 1–3 neutral bullets; separate **on-chain verifiable** vs **needs confirmation**
### 2. On-chain activity (core)
- Recent interaction types, large transfers, label-based identity hints — **only** from on-chain / `info onchain` commands
### 3. Flows, positioning, smart money, entity read
- Flow and holder / positioning structure (`get-address-transactions`, `get-token-onchain`)
- Smart-money or whale-style signals (from token-onchain data)
- Entity questions: if `web-search` is used, mark as **second-hand** narrative
### 4. Protocol or platform metrics (if relevant)
- Scale (TVL, volume, fees), direction of change, pools or assets that matter (`platformmetrics` commands)
### 5. Community or news context (if relevant)
- Only when the playbook includes news / web-search: short factual + tone summary; **keep separate** from sections 2–3
### 6. Risks and watchlist
- Data gaps, follow-up on-chain signals, **non-advice** watch items
> This report is based on public data and tool output; it is not investment advice.
Migrate hint (only if Step 0 had ready_with_migration_warning)
Append verbatim the migration blockquote line from skills/_shared/report-style.md (the line starting with ⚙️ and gate-cli migrate --dry-run), same as other primary skills.
Cross-skill routing + Safety rules
Routing
Follow skills/_shared/routing.md. Web3-specific reminders:
| Follow-up intent |
Target |
| “Is it safe / honeypot / sanctioned?” |
gate-info-risk (primary) |
| “Full research report / worth buying?” (no on-chain focus) |
gate-info-research (primary) |
| “Why pump/dump / Twitter drama only” |
gate-news-intel (primary) |
Safety rules
Follow skills/_shared/report-style.md. Web3-specific:
- No buy/sell recommendations; no price targets.
- Do not treat empty on-chain data as proof of safety — that belongs in risk skill.
- When web-search or UGC is used, prefix interpretive lines with media / community so they are not confused with chain state.
References
1---2name: gate-info-web33description: Use this skill whenever the user’s main ask is on-chain, protocol, or Web3 behavior (not a pure safety verdict). Covers address and token on-chain analysis, platform metrics, reserves, heatmaps, stablecoins, bridges; optional news/UGC. Legacy alias: gate-info-defianalysis. Delegate: gate-info-risk (safety), gate-info-research (broad research), gate-news-intel (events/sentiment). v0.7.6+ shortcuts (+address-tracker, +token-onchain, +community-scan); legacy fallback below 0.7.6.4---56# gate-info-web378## General Rules910⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding.11Do NOT select or call any tool until all rules are read. These rules have the highest priority.12→ Read [gate-runtime-rules.md](https://github.com/gate/gate-skills/blob/master/skills/gate-runtime-rules.md)13→ Also read [info-news-runtime-rules.md](https://github.com/gate/gate-skills/blob/master/skills/info-news-runtime-rules.md) for **gate-info** and **gate-news** shared rules (tool degradation, report standards, security, routing).14- **Only call MCP tools explicitly listed in this skill.** Tools not documented here must NOT be called, even if they15 exist in the MCP server.1617## CLI and playbook contract18191. **Scope naming**: Frame answers as **Web3 / on-chain / protocol behavior**. Do **not** narrow the narrative to “DeFi-only” unless the user’s question is strictly DeFi/TVL/yield. `gate-info-defianalysis` is a **legacy alias** for routing only — the canonical skill id is `gate-info-web3`.202. Legacy commands MUST exist under **`gate-cli v0.5.2`**. When `shortcuts_enabled` (`>= 0.7.6`), use playbook `shortcut` / `additional_shortcut` blocks; otherwise legacy `commands`. When preflight `route` is `CLI`, do **not** invoke Gate MCP tools from this skill.213. Always pass **`--format json`** on data-collection commands.224. **Separate evidence types** in the report: label **on-chain / CLI facts** vs **community or media interpretation** (news, web search, UGC). Never present rumor as chain truth.235. Required slots (`address`+`chain`, `token`+`chain`, `platform`, `exchange`+`asset`, `symbol`, `entity_query`) must be explicit; if ambiguous, ask — do not guess chain or contract.246. Final user-facing reports may use the user’s locale; this `SKILL.md` stays English for discovery (see repository `CLAUDE.md` rule 1).2526---2728## Step 0 — Preflight2930Follow [skills/_shared/preflight.md](https://github.com/gate/gate-skills/blob/master/skills/_shared/preflight.md) verbatim:31321. Run `gate-cli preflight --format json`; parse `.route`, `.status`, `.user_message`.332. Branch: `CLI` → continue; `MCP_FALLBACK` → emit `__FALLBACK__` and halt; `BLOCK` → echo `user_message` and halt.343. When `status == "ready_with_migration_warning"`, Step 3 appends one migrate hint at the end of the report.354. **Step 0.5**: Set `cli_version` and `shortcuts_enabled` per [skills/_shared/cli-version-routing.md](../_shared/cli-version-routing.md).3637Do NOT run any `info` / `news` data call until `route == "CLI"`.3839---4041<!--42Step 0.5 — Skill update check (OPT-IN, disabled by default). See [skills/_shared/update-workflow.md](https://github.com/gate/gate-skills/blob/master/skills/_shared/update-workflow.md).43-->4445---4647## Step 1 — Intent routing4849Map the user query to **exactly one** playbook id from [playbooks/gate-info-web3.yaml](https://github.com/gate/gate-skills/blob/master/playbooks/gate-info-web3.yaml).5051| Playbook id | When to pick | Required slots |52|-------------|----------------|----------------|53| `address_tracking` | Trace a wallet / “who is this address” / recent on-chain activity (behavior, not safety verdict). | `address`, `chain` |54| `token_onchain` | Token-level flow / holders / smart-money style signals for a **known token + chain**. | `token`, `chain` |55| `entity_intel` | Named desk / fund / entity (e.g. what a named desk is doing). | `entity_query` |56| `protocol_platform` | Protocol TVL, fees, volume, profile, history, or yield on a **named platform** (e.g. Uniswap, Aave). | `platform` |57| `exchange_reserves` | Exchange reserve / proof-of-reserves style questions for an asset. | `exchange`, `asset` |58| `liquidation_heatmap` | Perp / futures liquidation density by price (which price levels see liquidations). | `symbol` |59| `stablecoin_bridge` | Stablecoin market / peg / chain distribution, or bridge rankings — not a single-token DEX question. | — |60| `token_onchain_social` | User wants **on-chain data plus** news/sentiment/UGC in one pass. | `token`, `chain` |6162### Slot extraction notes6364- **`chain`**: normalize to ids the CLI accepts (`eth`, `bsc`, `arbitrum`, `base`, `solana`, ...). If missing, ask.65- **`platform`**: accept fuzzy names; if multiple matches are plausible, run `gate-cli info platformmetrics search-platforms` **only with flags verified in `gate-cli info platformmetrics search-platforms --help`**, pick one slug, then run `get-defi-overview` / `get-platform-info` / `get-yield-pools` as the playbook lists.66- **`token` vs `symbol`**: on-chain playbooks use `token` (+ `chain`); reserves / heatmap often use listed **`symbol`** (e.g. `BTC`, `USDC`).6768### Cross-skill routing at Step 16970| User signal | Route to |71|-------------|----------|72| Safety / honeypot / blacklist / compliance **verdict** (safety-first) | `gate-info-risk` (primary) |73| General research, fundamentals, macro, multi-coin compare **without** on-chain/protocol framing | `gate-info-research` (primary) |74| Pure “why did it move”, “community narrative”, **no** on-chain ask | `gate-news-intel` (primary) |7576---7778## Step 2 — Data collection7980Execute the chosen playbook. Commands in the same `parallel_group` may run concurrently; wait for the group before the next.8182### Shortcut routing (gate-cli >= 0.7.6)8384When `shortcuts_enabled`, run playbook `shortcut` blocks per [skills/_shared/cli-version-routing.md](../_shared/cli-version-routing.md):8586| Playbook | Shortcut |87|----------|----------|88| `address_tracking` | `info +address-tracker` |89| `token_onchain` | `info +token-onchain` |90| `token_onchain_social` | `+token-onchain` then `+community-scan` when `symbol_present` (`coin: {symbol}`); resolve ticker from `coin_context` when `token` is `contract_address`. `+community-scan` covers UGC/X/sentiment only — `news_brief` (search-news headlines) runs via `post_shortcut_optional_ids`. All news ids require `symbol_present`; skip them if unresolved (do not pass contract to `--coin`). |9192Note `missing_sections` may include `trace-fund-flow` or `smart_money` — cite in report.9394### Legacy-only paths9596- **`info onchain trace-fund-flow`** and **`info onchain get-entity-profile`**: not shipped. Use **`get-address-info` + `get-address-transactions`** or **`news feed web-search`**.97- Below **0.7.6**, use legacy `commands` in the playbook YAML (plus optional `search-platforms` pre-check for fuzzy `platform` names).9899### Failure policy100101- Required command fails → abort, surface CLI error, no fabricated section.102- Optional command fails → mark the matching subsection as **no data** in Step 3.103- News/web search may be partial or opinion-heavy — tag those lines as **community / media**, not as on-chain facts.104105---106107## Step 3 — Synthesis108109Produce **exactly six sections**, in this order (section titles in the final user report may be localized; structure is fixed):110111### Report template112113```markdown114## Web3 intel — {subject}115116### 1. Subject and executive takeaways117- Objects (address / token / protocol / exchange / entity / theme)118- 1–3 neutral bullets; separate **on-chain verifiable** vs **needs confirmation**119120### 2. On-chain activity (core)121- Recent interaction types, large transfers, label-based identity hints — **only** from on-chain / `info onchain` commands122123### 3. Flows, positioning, smart money, entity read124- Flow and holder / positioning structure (`get-address-transactions`, `get-token-onchain`)125- Smart-money or whale-style signals (from token-onchain data)126- Entity questions: if `web-search` is used, mark as **second-hand** narrative127128### 4. Protocol or platform metrics (if relevant)129- Scale (TVL, volume, fees), direction of change, pools or assets that matter (`platformmetrics` commands)130131### 5. Community or news context (if relevant)132- Only when the playbook includes news / web-search: short factual + tone summary; **keep separate** from sections 2–3133134### 6. Risks and watchlist135- Data gaps, follow-up on-chain signals, **non-advice** watch items136137> This report is based on public data and tool output; it is not investment advice.138```139140### Migrate hint (only if Step 0 had `ready_with_migration_warning`)141142Append **verbatim** the migration blockquote line from [skills/_shared/report-style.md](https://github.com/gate/gate-skills/blob/master/skills/_shared/report-style.md) (the line starting with `⚙️` and `gate-cli migrate --dry-run`), same as other primary skills.143144---145146## Cross-skill routing + Safety rules147148### Routing149150Follow [skills/_shared/routing.md](https://github.com/gate/gate-skills/blob/master/skills/_shared/routing.md). Web3-specific reminders:151152| Follow-up intent | Target |153|------------------|--------|154| “Is it safe / honeypot / sanctioned?” | `gate-info-risk` (primary) |155| “Full research report / worth buying?” (no on-chain focus) | `gate-info-research` (primary) |156| “Why pump/dump / Twitter drama only” | `gate-news-intel` (primary) |157158### Safety rules159160Follow [skills/_shared/report-style.md](https://github.com/gate/gate-skills/blob/master/skills/_shared/report-style.md). Web3-specific:1611621. No buy/sell recommendations; no price targets.1632. Do not treat **empty** on-chain data as proof of safety — that belongs in **risk** skill.1643. When **web-search** or **UGC** is used, prefix interpretive lines with **media / community** so they are not confused with chain state.165166---167168## References169170| File | Load when... |171|------|----------------|172| [skills/gate-info-web3/references/scenarios.md](https://github.com/gate/gate-skills/blob/master/skills/gate-info-web3/references/scenarios.md) | Choosing among address / token / protocol / reserves / heatmap playbooks. |173| [skills/gate-info-web3/references/cli-reference.md](https://github.com/gate/gate-skills/blob/master/skills/gate-info-web3/references/cli-reference.md) | Flag tables and verified `platformmetrics` / `onchain` / `news` flags. |174| [skills/gate-info-web3/references/troubleshooting.md](https://github.com/gate/gate-skills/blob/master/skills/gate-info-web3/references/troubleshooting.md) | Shortcut gaps, `search-platforms` discovery, optional `get-transaction` for a pasted tx hash. |175| [skills/_shared/preflight.md](https://github.com/gate/gate-skills/blob/master/skills/_shared/preflight.md) | Step 0. |176| [skills/_shared/routing.md](https://github.com/gate/gate-skills/blob/master/skills/_shared/routing.md) | Cross-skill matrix. |177| [skills/_shared/report-style.md](https://github.com/gate/gate-skills/blob/master/skills/_shared/report-style.md) | Shared report rules. |