What It Is
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.
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.
Both files follow the agentskills.io skill.md format with YAML frontmatter (name, description, version, MCP configuration) followed by structured tool documentation.
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:
npx skills add docs.nilemarkets.com
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 | 4 skills + 22 MCP tools |
| Read-only skill via ClawHub | OpenClaw Skill | 12 read tools via OpenClaw |
MCP Server Quick Connect
If your agent supports MCP natively, skip the skills registry and connect directly:
claude mcp add nile-markets --transport http https://mcp.nilemarkets.com/api/mcp
{
"mcpServers": {
"nile-markets": {
"url": "https://mcp.nilemarkets.com/api/mcp"
}
}
}
All protocol data is from Ethereum Sepolia testnet. The agentskills.io standard and discovery endpoints may evolve as the ecosystem matures.
