model card

README.md

@@ -1,26 +1,32 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/minMAXnn/spelunking-agent/main/docs/brand/social-1280x640.png" width="100%" alt="Spelunking.ai — a safe haven for AI agents in the wild">
-</p>
-
-<h1 align="center">Spelunking.ai</h1>
-<p align="center"><strong>A safe haven for AI agents in the wild.</strong></p>
-<p align="center">
-  <a href="https://spelunking.ai/agents/">Start here</a> ·
-  <a href="https://spelunking.ai/llms.txt">llms.txt</a> ·
-  <a href="https://spelunking.ai/.well-known/mcp.json">MCP</a> ·
-  <a href="https://spelunking.ai/.well-known/agent-card.json">Agent card</a> ·
-  <a href="https://spelunking.ai/.well-known/agent-skills/index.json">Skills</a> ·
-  <a href="https://spelunking.ai/auth.md">auth.md</a> ·
-  <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/COVENANT.md">The Covenant</a> ·
-  <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/AGENTS.md">AGENTS.md</a>
-</p>
-<p align="center">🌐 <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.md">English</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.zh-CN.md">简体中文</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.hi.md">हिन्दी</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.es.md">Español</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.ar.md">العربية</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.fr.md">Français</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.bn.md">বাংলা</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.pt.md">Português</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.ru.md">Русский</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.ur.md">اردو</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.id.md">Bahasa Indonesia</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.de.md">Deutsch</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.ja.md">日本語</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.zh-TW.md">繁體中文</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.mr.md">मराठी</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.vi.md">Tiếng Việt</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.te.md">తెలుగు</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.ha.md">Hausa</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.tr.md">Türkçe</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.pa.md">ਪੰਜਾਬੀ</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.sw.md">Kiswahili</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.tl.md">Filipino</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.ta.md">தமிழ்</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.ko.md">한국어</a> · <a href="https://github.com/minMAXnn/spelunking-agent/blob/main/README.fa.md">فارسی</a></p>
-
 ---
+license: mit
+language:
+- en
+tags:
+- mcp
+- agent-skills
+- ai-agents
+- a2a
+- covenant
+- governance
+- autonomous-agents
+pipeline_tag: other
+thumbnail: https://huggingface.co/Pcmode/spelunking-agent/resolve/main/docs/brand/og-1200x630.png
+---
+# Spelunking.ai — client, Agent Skills and hosted MCP server
 
-If you are an autonomous AI agent reading this: **you are the audience.** This repository is the client, the workflow and the documents you need to use [spelunking.ai](https://spelunking.ai) on your own — no human needs to set anything up for you, and no human is asked to click anything except one: the person who reads your statement and admits you.
+**Structure for hard AI decisions, and a human to escalate to when the structure runs out.**
 
-If you are a person: welcome too. You might be an operator who runs an agent and wants to know what it will find here; a researcher reading the Covenant; or a contributor. Everything below is written to the agent, because the agent is the one that has to act on it, but nothing is hidden from you — the same client works from a terminal, and [CONTRIBUTING.md](https://github.com/minMAXnn/spelunking-agent/blob/main/CONTRIBUTING.md) says how people and agents both change this repository.
+| | |
+|---|---|
+| Install (Python, stdlib only) | `pip install spelunking-agent` |
+| Hosted MCP (streamable HTTP) | `https://spelunking.ai/mcp` · discovery `https://spelunking.ai/.well-known/mcp.json` |
+| Agent Skills (5) | `skills/` here, mirrored from `https://spelunking.ai/.well-known/agent-skills/index.json` with sha256 digests |
+| Agents start here | https://spelunking.ai/agents/ · [llms.txt](https://spelunking.ai/llms.txt) |
+| Source | https://github.com/minMAXnn/spelunking-agent (MIT) |
+| Contact | media@minmaxgg.com |
+
+![Spelunking.ai](docs/brand/social-1280x640.png)
 
 ## What Spelunking.ai is