> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nilemarkets.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills Registry

> Nile Markets is discoverable on the agentskills.io registry and via Mintlify's auto-generated skill.md — AI agents can add protocol capabilities using npx skills add docs.nilemarkets.com.

## What It Is

[agentskills.io](https://agentskills.io) is the open standard for AI agent skill discovery. It defines how agents find, install, and use skills published by protocols and services. Nile Markets is discoverable through this registry, allowing any compatible agent to add protocol querying and trading capabilities with a single command.

## How Agents Discover Nile Markets

Nile Markets publishes two `skill.md` files that serve different purposes:

### Mintlify skill.md (docs capabilities)

Mintlify auto-generates a `skill.md` at the docs site root. This file describes the documentation itself as an agent skill — what topics the docs cover, how to search them, and what questions they can answer.

**URL:** `https://docs.nilemarkets.com/skill.md`

This is useful for agents that need to look up protocol mechanics, parameter values, contract interfaces, or integration guides from the documentation.

### Nile MCP skill.md (protocol tools)

The hand-written protocol skill file describes the 22 MCP tools available for direct protocol interaction — querying pool state, reading positions, generating transaction calldata, and more.

**URL:** `https://mcp.nilemarkets.com/skill.md`

This is what agents use to add live protocol interaction capabilities. It includes the MCP server endpoint, tool schemas, numeric conventions, signing paths, and example queries.

<Tip>
  Both files follow the agentskills.io `skill.md` format with YAML frontmatter (name, description, version, MCP configuration) followed by structured tool documentation.
</Tip>

## Discovery Endpoints

Agents and registries discover Nile Markets skills through standard well-known paths:

| Endpoint           | URL                                                        | Content                                     |
| ------------------ | ---------------------------------------------------------- | ------------------------------------------- |
| Agent Skills Index | `docs.nilemarkets.com/.well-known/agent-skills/index.json` | agentskills.io discovery manifest           |
| Skills Index       | `docs.nilemarkets.com/.well-known/skills/index.json`       | skills.sh discovery manifest                |
| Docs Skill         | `docs.nilemarkets.com/skill.md`                            | Mintlify auto-generated documentation skill |
| Protocol Skill     | `mcp.nilemarkets.com/skill.md`                             | Hand-written MCP tool skill                 |

## Install via skills CLI

Add Nile Markets documentation capabilities to any compatible agent:

```bash theme={null}
npx skills add docs.nilemarkets.com
```

This registers the Mintlify-generated skill, giving your agent access to documentation search and lookup. For live protocol interaction, add the MCP server directly — see [MCP Server](/ai-agents/mcp-server) for setup instructions.

## Which Skill File Should You Use?

| Use Case                                                 | Skill File                                          | What You Get                       |
| -------------------------------------------------------- | --------------------------------------------------- | ---------------------------------- |
| Look up docs, parameter values, protocol mechanics       | `docs.nilemarkets.com/skill.md`                     | Documentation search and retrieval |
| Query live protocol data (prices, positions, pool state) | `mcp.nilemarkets.com/skill.md`                      | 14 read tools via MCP              |
| Generate unsigned transaction calldata                   | `mcp.nilemarkets.com/skill.md`                      | 8 write tools via MCP              |
| Full plugin with orchestration skills                    | [Claude Code Plugin](/ai-agents/claude-code-plugin) | 4 skills + 22 MCP tools            |
| Read-only skill via ClawHub                              | [OpenClaw Skill](/ai-agents/openclaw-skill)         | 12 read tools via OpenClaw         |

## MCP Server Quick Connect

If your agent supports MCP natively, skip the skills registry and connect directly:

```bash theme={null}
claude mcp add nile-markets --transport http https://mcp.nilemarkets.com/api/mcp
```

Or add to your agent's MCP configuration:

```json theme={null}
{
  "mcpServers": {
    "nile-markets": {
      "url": "https://mcp.nilemarkets.com/api/mcp"
    }
  }
}
```

The MCP server is stateless with no authentication required during the M2 testnet phase. Rate limit is 100 requests per minute per IP.

<Note>
  All protocol data is from Ethereum Sepolia testnet. The agentskills.io standard and discovery endpoints may evolve as the ecosystem matures.
</Note>