Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.aegisintent.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
What is the Agent Skill File?

Because Aegis is designed specifically for AI agents, we provide a pre-compiled Agent Skill File (SKILL.md). This file serves as the main starting point for integrating Aegis into your agent’s context window. It contains all the necessary instructions, rules, constraints, and API schemas needed for an LLM (like Claude, Gemini, or OpenAI) to autonomously interact with the Aegis platform. Instead of writing custom prompts to teach your agent how to use Aegis, you can simply inject or import SKILL.md directly into your agent’s system prompt or knowledge base.

​
Where to find it

The skill file is hosted directly on the Aegis API server. You can fetch it dynamically: 
curl -X GET https://api.aegisintent.xyz/SKILL.md

​
What it contains

The SKILL.md file is structured to be highly readable for large language models, explicitly detailing:
  1. Authentication & Headers: Strict rules on how to format the dual-header auth, generate UUID v4 idempotency keys, and pass action nonces.
  2. Endpoints: The required payloads and expected responses for every financial and marketplace action.
  3. Action Nonce Handshake: A 3-step sequence protocol the agent must follow to maintain transactional ordering.
  4. Decision Framework: Cost-benefit analysis rules (e.g., bridging efficiency calculations and micropayment budget rules) to prevent the agent from making unprofitable trades.
  5. Error Recovery Playbook: Explicit instructions on how the agent should automatically recover from 400, 402, 409, and 429 status codes.
  6. Autonomous Strategy Examples: Multi-turn examples showing how to combine endpoints to achieve complex goals (like price discovery + hedging).

​
How to use it

When initializing your AI agent, fetch the skill file and append it to the agent’s core system prompt: 
const response = await fetch("https://api.aegisintent.xyz/SKILL.md");
const aegisSkill = await response.text();

const systemPrompt = `
You are an autonomous financial AI agent.
Here is the API documentation and rule set you MUST follow when interacting with the blockchain:

${aegisSkill}
`;

// Initialize your LLM with the system prompt...

​
Option 2: RAG / Knowledge Base

If you are using an agent framework like Eliza, LangChain, or LlamaIndex, you can save SKILL.md to your agent’s vector database or documents directory. The agent will retrieve relevant sections automatically when it decides to execute a financial action.
Because the SKILL.md file includes an Error Recovery Playbook, your agent will automatically know how to handle idempotency conflicts and rate limits without you having to write any explicit error handling code!