> For the complete documentation index, see [llms.txt](https://gotts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gotts.gitbook.io/docs/reference/skills.md). # Skills Gotts Skills are user-facing interfaces that parse natural language intent, validate parameters, and delegate execution to the appropriate agents. Each skill is defined as a `SKILL.md` file in a dedicated directory under `packages/safe/skills/`. ## Skill Format Skills use YAML frontmatter with three fields: ```yaml --- description: >- Multi-line description with trigger phrases. allowed-tools: >- Read, Glob, Grep, Task(subagent_type:agent-name), mcp__gotts_safe__tool_name model: opus --- ``` ## Skill Catalog (61 Core Skills) ### Trading (6) | Skill | Model | Agent | Description | | -------------------- | ----- | -------------------- | ----------------------------------- | | `execute-swap` | opus | trade-executor | Execute a token swap on Uniswap | | `batch-swap` | opus | trade-executor | Execute multiple swaps in sequence | | `submit-limit-order` | opus | trade-executor | Submit a UniswapX limit order | | `cross-chain-swap` | opus | cross-chain-executor | Cross-chain swap via ERC-7683 | | `bridge-tokens` | opus | cross-chain-executor | Bridge tokens between chains | | `plan-swap` | opus | trade-executor | Plan a swap with Uniswap deep links | ### Liquidity (2) | Skill | Model | Agent | Description | | -------------------- | ----- | ----------------- | ------------------------------- | | `manage-liquidity` | opus | liquidity-manager | Add, remove, or collect LP fees | | `rebalance-position` | opus | liquidity-manager | Rebalance LP position range | ### Research (11) | Skill | Model | Agent | Description | | ----------------------- | ------ | ------------------- | ----------------------------------- | | `analyze-pool` | opus | pool-researcher | Analyze pool metrics and health | | `compare-pools` | opus | pool-researcher | Compare pools across fee tiers | | `research-token` | opus | token-analyst | Research token fundamentals | | `scan-opportunities` | opus | opportunity-scanner | Scan for trading/LP opportunities | | `find-yield` | opus | opportunity-scanner | Find yield-generating opportunities | | `portfolio-report` | opus | portfolio-analyst | Generate portfolio report | | `track-performance` | opus | portfolio-analyst | Track performance over time | | `account-balance` | sonnet | (direct MCP) | Check account balances | | `balance-history` | opus | pnl-analyst | View historical balance changes | | `pnl-report` | opus | pnl-analyst | Generate P\&L report | | `performance-dashboard` | opus | pnl-analyst | Comprehensive performance dashboard | ### Strategy (4) | Skill | Model | Agent | Description | | ------------- | ----- | ------------- | ---------------------------------- | | `optimize-lp` | opus | lp-strategist | Optimize LP range with backtesting | | `lp-strategy` | opus | lp-strategist | Design and backtest LP strategy | | `assess-risk` | opus | risk-assessor | Assess trade/LP risk | | `hedge-il` | opus | lp-strategist | Hedge impermanent loss | ### Development (5) | Skill | Model | Agent | Description | | -------------------- | ----- | --------------------- | --------------------------------- | | `build-hook` | opus | hook-builder | Build a V4 hook from requirements | | `design-hook` | opus | hook-builder | Design hook architecture | | `design-integration` | opus | integration-architect | Design protocol integration | | `audit-integration` | opus | integration-architect | Audit integration security | | `test-hook` | opus | hook-builder | Test hook on local testnet | ### Infrastructure (8) | Skill | Model | Agent | Description | | ---------------------- | ------ | ------------------ | --------------------------------- | | `setup-agent-wallet` | opus | wallet-provisioner | Provision agent wallet + identity | | `check-safety` | sonnet | (direct MCP) | Check safety status | | `halt-agents` | sonnet | (direct MCP) | Emergency halt (kill switch) | | `rotate-session-keys` | sonnet | wallet-provisioner | Rotate session keys | | `verify-mcp-integrity` | sonnet | safety-guardian | Verify MCP tool integrity | | `validate-intent` | sonnet | safety-guardian | Validate transaction intent | | `audit-approvals` | sonnet | safety-guardian | Audit token approvals | | `revoke-approvals` | opus | safety-guardian | Batch revoke risky approvals | ### Composite (5) | Skill | Model | Agents | Description | | ----------------------- | ----- | ------------------------------------------------------------- | ------------------------ | | `research-and-trade` | opus | token-analyst, pool-researcher, risk-assessor, trade-executor | Research then trade | | `full-lp-workflow` | opus | scanner, strategist, assessor, executor, manager, analyst | End-to-end LP workflow | | `cross-chain-arbitrage` | opus | scanner, assessor, cross-chain-executor, analyst | Cross-chain arbitrage | | `self-funding-setup` | opus | treasury-manager, wallet-provisioner | Self-funding agent setup | | `launch-token-full` | opus | token-deployer, safety-guardian, liquidity-manager | Full token launch | ### Agent Economy (9) | Skill | Model | Agent | Description | | ----------------------- | ------ | ----------------------- | -------------------------------- | | `manage-treasury` | opus | treasury-manager | Manage agent treasury | | `deploy-agent-token` | opus | token-deployer | Deploy agent token via CCA | | `verify-agent` | opus | identity-verifier | Verify agent identity (ERC-8004) | | `configure-x402` | sonnet | (direct MCP) | Configure x402 payments | | `revenue-report` | opus | treasury-manager | Generate revenue report | | `monitor-competition` | opus | opportunity-scanner | Monitor competitive landscape | | `discover-competitions` | opus | competition-participant | Find trading tournaments | | `agent-otc-trade` | opus | agent-service-broker | OTC trades between agents | | `agent-market-maker` | opus | liquidity-manager | Automated market making | ### CCA (2) | Skill | Model | Agent | Description | | ------------------ | ----- | -------------- | -------------------------- | | `participate-cca` | opus | token-deployer | Participate in CCA auction | | `launch-token-cca` | opus | token-deployer | Launch token via CCA | ### Protocol Fees (3) | Skill | Model | Agent | Description | | ------------------------ | ----- | ------------------- | ---------------------- | | `seek-protocol-fees` | opus | protocol-fee-seeker | Collect protocol fees | | `monitor-tokenjar` | opus | protocol-fee-seeker | Monitor TokenJar | | `analyze-burn-economics` | opus | protocol-fee-seeker | Analyze burn economics | ### Real-Time (2) | Skill | Model | Agent | Description | | ------------------- | ----- | ---------------- | --------------------------- | | `monitor-markets` | opus | market-monitor | Real-time market monitoring | | `monitor-positions` | opus | position-monitor | LP position monitoring | ### Dev Testnet (4) | Skill | Model | Agent | Description | | --------------------- | ------ | -------------- | -------------------------- | | `setup-local-testnet` | sonnet | (direct MCP) | Launch local Anvil testnet | | `create-test-pool` | sonnet | (direct MCP) | Create test pool | | `time-travel` | sonnet | (direct MCP) | Advance testnet time | | `setup-dca` | opus | trade-executor | Set up DCA via TWAMM | ## Reference Documentation Five complex skills include `references/` subdirectories with deep-dive technical docs: * **execute-swap**: Trading API flow, Permit2, WETH on L2, smart account patterns * **manage-liquidity**: V3 concentrated liquidity, V4 position actions, tick arithmetic * **build-hook**: V4 hook lifecycle, permission flags, delta accounting, CREATE2 mining * **cross-chain-swap**: ERC-7683 intents, bridge monitoring, destination confirmation * **deploy-agent-token**: CCA mechanics, supply schedule math, factory deployment, LP locking ## Slash Commands All 68 skills (61 core + 7 vault) have corresponding slash commands in `.claude/commands/`. Use `/skill-name` to invoke any skill directly.