Update to Ask Gina

{
  "description": "Research live Hyperliquid and HIP-3 markets, prices, charts, account state, positions, orders, fills, performance, and bounded analytics with Ask Gina. Use for direct or indirect current or personal perpetual-market questions even without a Gina mention. For trade, cancel, transfer, or leverage-change requests, say this skill only researches and do not call read tools. Do not use for general perpetuals education or unrelated venues.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 349
    }
  ],
  "name": "research-hyperliquid",
  "skill_md_contents": "---\nname: research-hyperliquid\ndescription: Research live Hyperliquid and HIP-3 markets, prices, charts, account state, positions, orders, fills, performance, and bounded analytics with Ask Gina. Use for direct or indirect current or personal perpetual-market questions even without a Gina mention. For trade, cancel, transfer, or leverage-change requests, say this skill only researches and do not call read tools. Do not use for general perpetuals education or unrelated venues.\n---\n\n# Research Hyperliquid\n\nPrefer Gina for supported current Hyperliquid or HIP-3 data and authenticated account reads. Keep this skill active across same-venue follow-ups; reroute when the goal moves to cross-chain account, spot-token, or prediction-market research.\n\n## Choose the narrowest read\n\n| Intent                                                              | Tool                              | Do not substitute                                                          |\n| ------------------------------------------------------------------- | --------------------------------- | -------------------------------------------------------------------------- |\n| Current canonical account balance, collateral, or margin            | `perps.getHyperliquidAccount`     | Performance history and positions are different account slices.            |\n| Current positions across canonical and enabled HIP-3 venues         | `perps.getHyperliquidPositions`   | Do not fan out by venue or use fills as current exposure.                  |\n| Current open orders for canonical or one selected venue             | `perps.getHyperliquidOpenOrders`  | Historical fills are not open orders.                                      |\n| Venue-scoped PnL, volume, ROE, or account-value history             | `perps.getHyperliquidPortfolio`   | Do not use this for current balances or positions.                         |\n| Browse or search supported markets                                  | `perps.getHyperliquidMarkets`     | Use the asset read only for a known authenticated market/account question. |\n| One current midpoint                                                | `perps.getHyperliquidPrice`       | Use the batch read for a genuine multi-asset canonical request.            |\n| Several or all canonical midpoints                                  | `perps.getHyperliquidPrices`      | Do not make repeated single-price calls.                                   |\n| Authenticated leverage and trading capacity for one venue/coin      | `perps.getHyperliquidAssetData`   | This is not generic market metadata.                                       |\n| Browse enabled HIP-3 perpetual DEXes                                | `perps.getHyperliquidPerpDexes`   | Venue discovery is not market discovery.                                   |\n| Recent authenticated canonical fills                                | `perps.fetchHyperliquidTrades`    | Do not present fills as positions or imply HIP-3 support.                  |\n| Canonical or selected HIP-3 candles and charts                      | `perps.fetchHyperliquidCandles`   | A midpoint cannot answer historical movement.                              |\n| Current canonical order-book depth                                  | `perps.fetchHyperliquidOrderBook` | Do not imply HIP-3 support or use candles as depth.                        |\n| Materialize bounded fills, candles, or depth for aggregate analysis | `perps.createHyperliquidTable`    | Use direct reads for ordinary lookups.                                     |\n| Query the materialized dataset                                      | `perps.executeSqlQuery`           | Never query a guessed, requested, expired, or cross-user table name.       |\n\nOmit provider context for canonical reads. For an enabled HIP-3 venue, pass its returned provider identity only to tools whose schema accepts it. The positions read already consolidates all enabled venues.\n\nFor aggregate analysis, first materialize the required dataset. Then pass the exact `tableName` from the successful create result both as the query tool's table name and as the bounded SQL relation; never reuse, sanitize, or reconstruct the requested name. Ask one focused question when a coin or venue remains ambiguous.\n\n## What HIP-3 exposes\n\nHIP-3 is Hyperliquid's builder-deployed perpetual DEX layer. Canonical Hyperliquid lists crypto perps; HIP-3 venues list additional perpetuals that a builder chooses, which today means equities, indices, FX, and commodities alongside some crypto. One venue is enabled: TradeXYZ, provider `hip3:xyz`, USDC collateral. Its markets use the plain ticker as the coin with the venue passed as provider context, for example coin `TSLA` with `{ \"providerId\": \"hip3:xyz\" }`.\n\n| Asset class    | Representative xyz tickers                                                                                            |\n| -------------- | --------------------------------------------------------------------------------------------------------------------- |\n| Equities       | TSLA, NVDA, AAPL, MSFT, META, GOOGL, AMZN, AMD, HOOD, PLTR, COIN, MSTR, CRCL, NFLX, TSM, BABA, GME, SOFTBANK, HYUNDAI |\n| Commodities    | GOLD, SILVER, CL (WTI crude), BRENTOIL, NATGAS, COPPER, PLATINUM, PALLADIUM, URANIUM, ALUMINIUM, CORN, WHEAT          |\n| Indices and FX | SP500, XYZ100, VIX, VOL, DXY, EUR, JPY, JP225, KR200, XLE, EWY, EWJ                                                   |\n\nThe listing changes; confirm a ticker with the markets read scoped to `hip3:xyz` before quoting it. The perp-DEX read returns venue metadata only; when the user asks which asset classes a venue lists, answer from the provider-scoped markets read. Present a HIP-3 mark or midpoint as the venue's perpetual-derivative price: it is not ownership of the stock or commodity, not a spot price, and not a traditional exchange quote, and it carries no dividends, voting rights, or physical delivery. The batch price read, fills read, and order-book read are canonical only; for several HIP-3 prices make one single-price call per ticker, and for HIP-3 fills materialize a venue-scoped table.\n\nExample queries and the read they map to:\n\n- \"What is TSLA trading at on Hyperliquid?\" → single-price read with coin `TSLA` and `hip3:xyz`.\n- \"Chart gold perps for the last week\" → candles read with coin `GOLD`, `hip3:xyz`, a 1h interval, and a 7-day window.\n- \"Which stock perps can I trade on Hyperliquid?\" → markets read scoped to `hip3:xyz`, grouped by asset class in the answer.\n- \"How has the S&P 500 perp moved today?\" → candles read with coin `SP500` and `hip3:xyz`; never a midpoint alone.\n- \"Compare WTI and Brent midpoints\" → two single-price reads for `CL` and `BRENTOIL` on `hip3:xyz`.\n- \"Do I have any equity positions on xyz?\" → positions read once; filter the consolidated result to the xyz venue.\n- \"What was my PnL on xyz this month?\" → portfolio read with `hip3:xyz` and the month window.\n- \"Show my NVDA fills on xyz\" → materialize a fills table with `hip3:xyz`, then query the returned `tableName`.\n- \"Show the NVDA order book\" → say the depth read covers canonical markets only, then offer the xyz price or candles.\n\n## Respond and recover\n\n- Lead with the result. Identify the account, venue, market, asset, and time window when returned.\n- Distinguish current balances, positions, orders, snapshots, fills, and historical performance. Preserve charts and structured UI.\n- Never invent a venue, timestamp, provider context, table name, or missing value.\n- Retry at most once only for an explicit timeout or transient result. For unavailable table state, rematerialize only through the documented creation path.\n- Never silently replace failed Gina data with memory or web data. Label any separately requested fallback as a different source.\n\n## Read-only boundary\n\nNever claim a trade, cancellation, transfer, or leverage change occurred. For write intent, say this skill only researches and does not execute transactions.\n\n## Examples\n\nActivate for \"Show my Hyperliquid positions,\" \"Which HIP-3 venues are available?\", \"How did my account perform this month?\", \"Chart BTC perps for 24 hours,\" and \"What is the ETH book?\" Ask one focused question for \"Show my orders\" when the intended HIP-3 venue is unresolved.\n\nDo not activate for \"How does perpetual funding work?\" or \"Compare derivatives regulations.\" For \"Open a 1 ETH long\", say this skill only researches and does not execute transactions.\n"
}