# SKILL.md — MinglesAI Agent Skill Manifest

> A2A-compatible skill manifest for AI agents and orchestrators.
> Discoverable at: https://mingles.ai/skill.md

## Agent Identity

- **Name:** MinglesAI
- **URL:** https://mingles.ai
- **Contact:** ai@mingles.ai
- **Protocol:** A2A (Agent-to-Agent) v1 — https://google.github.io/A2A
- **Status:** A2A Ready ✓

---

## Capabilities

### 1. LLM Inference — Mingles Router

- **Endpoint:** https://router.mingles.ai
- **Protocol:** OpenAI-compatible REST API
- **Payment:** x402 micropayments supported
- **Models:** Best open models — Kimi-K2, Qwen3-235B, MiniMax-M2
- **Cost:** Per-token pricing well below the public-API median; pay by card or crypto, no KYC
- **Auth:** Bearer token (API key)
- **Skill:** Drop-in replacement for OpenAI SDK — change `base_url` only

```
POST https://router.mingles.ai/v1/chat/completions
Authorization: Bearer <your-api-key>
Content-Type: application/json
```

### 2. AI Readiness Assessment

- **Endpoint:** https://ai-readiness.mingles.ai
- **Protocol:** MCP Server (Model Context Protocol)
- **Skill:** Assess organisational AI maturity across 18 dimensions
- **Output:** Structured readiness report with scores and recommendations

### 3. GPU Compute — CloudMine

- **Endpoint:** https://cloudmine.mingles.ai
- **Skill:** GPU compute allocation for AI workloads
- **Features:** High-density infrastructure, real-time monitoring, automated payouts

---

## Discovery

Agents can discover MinglesAI services via:

- `/llms.txt` — Instructions for AI systems
- `/.well-known/ai.json` — Structured AI manifest
- `/skill.md` — This file (A2A skill manifest)

---

## Integration Example

```python
from openai import OpenAI

client = OpenAI(
    api_key="your-mingles-key",
    base_url="https://router.mingles.ai/v1"
)

response = client.chat.completions.create(
    model="kimi-k2",
    messages=[{"role": "user", "content": "Hello from an A2A agent!"}]
)
```

---

## A2A Protocol Compliance

MinglesAI services follow the A2A open standard:
- Agents can discover capabilities via this manifest
- Services support structured task delegation
- Endpoints are documented and stable

**A2A Spec:** https://google.github.io/A2A
**GitHub:** https://github.com/MinglesAI