Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

🧩Agent Skills

Modular SKILL.md packages that teach AI agents to trade, manage portfolios, and build UIs on GDEX — installable into Claude Code, Cursor, Codex, Windsurf, and 40+ other agents

The reference implementation is the open-source GemachDAO/gdex-skill package (@gdexsdk/gdex-skill). It ships 33 skills, a 117-tool MCP server, a fully-typed TypeScript SDK that talks to the GDEX / Gbot trading backend, and a bring-your-own-key harness for running the data skills with Claude.

What Are Agent Skills?

A skill is a directory containing a SKILL.md file — a structured markdown document that tells an AI agent what a capability does, when to use it, and exactly which SDK calls or API endpoints to invoke. Skills are not compiled plugins or binaries; they are human-readable, version-controllable instructions that any agent can load and follow.

This design makes skills:

  • Auditable — anyone can read exactly what an agent is instructed to do

  • Composable — combine multiple skills to build multi-step workflows

  • Shareable — published on GitHub and installed with a single command

  • Agent-native — written for autonomous agents, not human UIs

  • Lean — GDEX uses a multi-skill architecture, so an agent loads only the skills it needs and keeps its context window focused

Four Ways to Use GDEX Skills

Method
Best for
Entry point

Skills CLI (skills.sh)

Agents that read SKILL.md files directly (Claude Code, Cursor, Codex, Windsurf, +40 more)

npx skills add GemachDAO/gdex-skill

MCP Server

Any Model Context Protocol client — exposes 117 callable trading + docs tools

npx @gdexsdk/mcp-server

TypeScript SDK

Building your own agent, bot, or app in code

npm install github:GemachDAO/gdex-skill

Harness

Running the risk & market data skills with Claude on your own Anthropic key

python harness/gemach_harness.py

1. Install as Agent Skills

Install directly into any supported agent using the skills CLI:

Each skill's description tells the agent when to load it, so the agent pulls in only what the task needs. No API key setup is required; shared keys are built in for read access and managed-custody trading.

2. Run the MCP Server

The GDEX MCP server exposes 117 tools (109 execution + 8 documentation) so any MCP-compatible agent can trade autonomously:

3. Use the SDK in Code

Full Skill Catalog (33 skills)

Skills are grouped exactly as they are in the package's skills.sh.json manifest.

Getting Started

Skill
Description

gdex-onboarding

Start here — GDEX overview, architecture, supported chains, available skills, and quickstart

gdex-authentication

Managed-custody auth — shared API key login, session keypairs, AES-256-CBC computedData, secp256k1 signing

gdex-wallet-setup

Generate EVM control wallets offline, create session keypairs, fetch wallet info (no auth)

Trading

Skill
Description

gdex-spot-trading

Buy/sell tokens on Solana, Sui, and EVM chains with automatic DEX routing, slippage control, and percentage sells

gdex-perp-trading

HyperLiquid perpetual futures — open/close positions, set leverage, market/limit orders with TP/SL

gdex-perp-funding

Deposit and withdraw USDC to/from HyperLiquid for perpetual trading

gdex-limit-orders

Create, update/delete, and list limit orders via managed-custody encrypted payloads

Data & Discovery

Skill
Description

gdex-portfolio

Cross-chain portfolio overview, chain-specific balances, and paginated trade history

gdex-token-discovery

Token details, trending tokens, OHLCV candles, and top traders

gdex-livestream-discovery

Solana livestream-token discovery — live streams, per-token live status, and big-buy alert feeds

gdex-xstocks

Tokenised equities (xStocks) on Solana — listing and details

gdex-content-coins

Zora content coins and creator coins on Base

Copy Trading & Bridge

Skill
Description

gdex-copy-trading

Discover top wallets and create/manage Solana copy trades (Solana only for writes)

gdex-perp-copy-trading

Copy HyperLiquid perp traders — top traders, configs, fill history, opposite-direction copying

gdex-bridge

Cross-chain bridging of native tokens between EVM chains, Solana, and Sui via ChangeNow

Transfers & Social

Skill
Description

gdex-transfers

Native and ERC-20/SPL token transfers via managed custody to any recipient

gdex-watchlist-social

Watchlist, comments, and sentiment voting — social features around individual tokens

gdex-token-import

Import user-defined custom tokens so they appear in details, balances, and portfolio

HyperLiquid Extras

Skill
Description

gdex-hl-outcomes

HyperLiquid HIP-3 outcome / event (prediction) markets — list, order, and manage outcome positions

gdex-hl-referral

HyperLiquid referral info and reward claims

Promotion & Partners

Skill
Description

gdex-trending-promotion

Paid trending-slot promotion — book featured slots and check booking status

gdex-retailer-onboarding

Retailer partner integrations that white-label the GDEX trading stack

Risk & Market Data

Deterministic NDJSON feeds from standard-library Python scripts: no API key, no model. See Risk & Market Data Skills.

Skill
Description

gdex-hl-market-risk

HyperLiquid core-perp risk: funding, open interest, oracle premium, leverage caps, delisting for ~234 markets

gdex-hl-anomaly

Scored, time-stamped HyperLiquid anomaly events (oracle divergence, funding extremity, liquidity shock) against per-market learned baselines

gdex-token-risk

Token screen on 12 chains: price, liquidity, volume, honeypot, taxes, LP lock, holder concentration — missing security data never means safe

gvault

GVault (GMACL, Enzyme on Ethereum): NAV, share price, holdings, cumulative and annualised return

Frontend (React / Next.js)

Skill
Description

gdex-ui-install-setup

React/Next.js project setup — SDK init, context providers, env vars, TypeScript config

gdex-ui-trading-components

Order entry forms, position tables, copy-trade panels, orderbook and PnL views

gdex-ui-portfolio-dashboard

Portfolio dashboards — balances, trade history, chain selectors, live polling

gdex-ui-wallet-connection

Connect buttons, account displays, chain switching, API-key vs wallet auth UI

gdex-ui-theming

CSS theming — dark/light modes, trading colors, breakpoints, official Gemach brand tokens

gdex-ui-page-layouts

Full page compositions — trading, portfolio, copy-trading, and bridge pages

Developer Tools

Skill
Description

gdex-sdk-debugging

Troubleshoot SDK errors — error codes, encryption debugging, chain quirks, HL gotchas, copy-trade pitfalls

Supported Chains

GDEX skills operate across 12 spot networks plus HyperLiquid perps through a single interface:

Chain
ChainId
Native Token

Ethereum

1

ETH

Optimism

10

ETH

BNB Smart Chain

56

BNB

Sonic

146

S

Fraxtal

252

frxETH

Nibiru

6900

NIBI

Base

8453

ETH

Arbitrum One

42161

ETH

Berachain

80094

BERA

Solana

622112261

SOL

Sui

1313131213

SUI

Robinhood Chain

4663

ETH

HyperLiquid

perps only

USDC

Authentication Model

All trading runs through server-side managed wallets — your control wallet only ever signs the initial sign-in message, never the on-chain trades.

  • Shared API keys (recommended for agents) are pre-configured in the package, so agents can read data and submit managed trades without any wallet handover.

  • Read-only endpoints (getTrendingTokens, getTokenDetails, getOHLCV, getTopTraders) need no authentication at all.

  • Managed custody uses a secp256k1 session keypair plus AES-256-CBC encrypted computedData payloads for write operations.

See GDEX Trading Skills for the full sign-in flow.

Explore This Section


Agent Skills are open source under the MIT license. The full skill set lives in the GemachDAO/gdex-skill repository under skills/.

Last updated