# ai.gala.com — Full AI Guide

A comprehensive reference for AI coding assistants and developers building decentralized applications on GalaChain.

## What this site is

[ai.gala.com](https://ai.gala.com/) is the AI-first developer hub for GalaChain. It provides three categories of resources designed to give AI coding assistants (Claude Code, Cursor, Windsurf, etc.) the context they need to build correct, production-grade GalaChain dApps:

1. **AGENTS.md files** — Drop-in instruction files that AI coding assistants read automatically
2. **Skills** — Slash-command capabilities for common workflows
3. **OmniTool plugin** — A Model Context Protocol (MCP) server with 247+ tools and 41 teaching topics

## Why this matters

GalaChain has a specific SDK, decorator system, and authorization model that AI assistants don't know by default. Without context, AI-generated code typically misses GalaChain conventions and produces code that won't compile or won't work on-chain. The resources here close that gap by giving the AI structured, opinionated guidance for each domain.

## AGENTS.md files

AGENTS.md is a community convention: a markdown file at the root of a project that AI coding assistants read on every session to gain project-specific context. The files on this site are domain-specific instruction sets — drop the relevant one into your project and your AI gains expertise in that area.

### Available now

- **[Token Operations](https://ai.gala.com/agents/TOKEN_AGENTS.md)** — Minting, burning, transferring, allowances, fee gates. Covers gateway endpoints, signing contexts (browser MetaMask vs server-side), and composite key formats.

### DeFi (hosted by the DEX backend)

The DEX team hosts their own AI-readable resources:

- **[Full DEX guide](https://dex-backend-prod1.defi.gala.com/ai.md)** — Balances, quotes, swaps, liquidity, token formats
- **[Compact reference](https://dex-backend-prod1.defi.gala.com/llms.txt)** — For context-limited use
- **[Agent index](https://dex-backend-prod1.defi.gala.com/AGENTS.md)** — Full DeFi agent index

### Coming soon

- NFT Marketplace
- Client Integration
- Wallet Connections & Signing

## Skills

Skills are slash-command capabilities that extend AI coding assistants with GalaChain-specific workflows. They become available after installing the OmniTool plugin (below).

- `/omni-tool:learning-galachain` — Comprehensive learning system with 41 topics and 254+ SDK methods. Use this to teach yourself or your AI about GalaChain development.
- `/omni-tool:ask` — Ask natural-language questions about any GalaChain topic and get detailed, contextual answers with code examples.
- `/omni-tool:topics` — List all 41 teaching topics organized by category (core contracts, tokens, NFTs, deployment, etc.)
- `/omni-tool:setup` — Guided setup wizard to configure the OmniTool plugin for your environment.

## OmniTool MCP server

The OmniTool is a Model Context Protocol (MCP) server plugin that turns your AI coding assistant into a GalaChain expert.

### What MCP is

Model Context Protocol is an open standard that lets AI assistants connect to external tools and structured data sources. Instead of stuffing GalaChain knowledge into the context window, the OmniTool exposes it as on-demand tools the AI can call.

### Features

- **247+ specialized tools** — Complete coverage of the GalaChain SDK
- **41 teaching topics** — Structured learning content from core concepts to advanced patterns
- **Interactive learning** — Natural-language questions with contextual answers
- **Autonomous agent mode** — Let the AI build complete GalaChain applications end-to-end
- **Skills system** — Slash-command workflows for scaffolding and testing
- **Works with Claude Code, Cursor, Windsurf** — Any MCP-compatible client

### Installation

Add to your AI client's MCP configuration. For Claude Code, edit `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "galachain-builder": {
      "command": "npx",
      "args": ["-y", "@gala-chain/omni-tool"]
    }
  }
}
```

Then restart your AI client. Verify with `/omni-tool:setup`.

### Topic coverage

The 41 topics cover:

- Core contract development and decorators
- Token operations (fungible and non-fungible)
- Authorization and access control
- State management and world state
- Fee gates and burn mechanics
- Cross-channel communication
- Testing and CI/CD patterns
- Client SDK integration
- Deployment and operations

### Usage tips

The OmniTool works best when used autonomously. Instead of calling individual tools yourself, describe what you want to build and let the agent use the right tools automatically. Example prompt:

> Build me a GalaChain contract that manages a token with minting, burning, and transfer capabilities.

## Site map

- Home: https://ai.gala.com/
- Agents catalog: https://ai.gala.com/agents
- Skills catalog: https://ai.gala.com/skills
- OmniTool docs: https://ai.gala.com/omni-tool

## AI-readable endpoints

- Compact summary: https://ai.gala.com/llms.txt
- Master agent index: https://ai.gala.com/AGENTS.md
- This file (full guide): https://ai.gala.com/ai.md

## External references

- GalaChain main docs: https://galachain.com
- Gala main site: https://gala.com