{"id":50068999,"url":"https://github.com/fetchai/agentverse-skills","last_synced_at":"2026-05-22T01:45:30.008Z","repository":{"id":352793960,"uuid":"1216149857","full_name":"fetchai/agentverse-skills","owner":"fetchai","description":"Agent skills for interacting with Fetch.ai's Agentverse — portable SKILL.md format for Claude Code, Codex, Copilot, Cursor, Gemini CLI","archived":false,"fork":false,"pushed_at":"2026-05-17T15:40:20.000Z","size":160,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-17T17:47:03.434Z","etag":null,"topics":["agent-skills","agentverse","ai-agents","asi-alliance","chat-protocol","claude-code","codex","copilot","cursor","fetch-ai","gemini-cli","mcp","skill-md","uagents"],"latest_commit_sha":null,"homepage":"https://agentverse.ai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fetchai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-20T16:06:59.000Z","updated_at":"2026-05-17T15:40:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fetchai/agentverse-skills","commit_stats":null,"previous_names":["fetchai/agentverse-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fetchai/agentverse-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2Fagentverse-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2Fagentverse-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2Fagentverse-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2Fagentverse-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fetchai","download_url":"https://codeload.github.com/fetchai/agentverse-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetchai%2Fagentverse-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33324170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-21T12:23:38.849Z","status":"ssl_error","status_checked_at":"2026-05-21T12:22:11.673Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","agentverse","ai-agents","asi-alliance","chat-protocol","claude-code","codex","copilot","cursor","fetch-ai","gemini-cli","mcp","skill-md","uagents"],"created_at":"2026-05-22T01:45:29.161Z","updated_at":"2026-05-22T01:45:29.995Z","avatar_url":"https://github.com/fetchai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔮 Agentverse Skills\n\n**Portable AI agent skills for [Fetch.ai's Agentverse](https://agentverse.ai) — use from any AI coding assistant.**\n\n[![CI](https://github.com/fetchai/agentverse-skills/actions/workflows/test.yml/badge.svg)](https://github.com/fetchai/agentverse-skills/actions/workflows/test.yml)\n[![Integration Tests](https://github.com/fetchai/agentverse-skills/actions/workflows/integration.yml/badge.svg)](https://github.com/fetchai/agentverse-skills/actions/workflows/integration.yml)\n[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n[![GitHub Issues](https://img.shields.io/github/issues/fetchai/agentverse-skills.svg)](https://github.com/fetchai/agentverse-skills/issues)\n\nGive your AI coding agent (Claude Code, Codex, Copilot, Cursor, Gemini CLI) the ability to interact with any agent on [Agentverse](https://agentverse.ai) — search the agent registry, send messages, generate images, deploy code, and query the ASI:One LLM. Each skill is a self-contained Python script plus a `SKILL.md` that any AI coding agent can read and act on immediately.\n\n\u003e **First-of-its-kind:** These are the first [SKILL.md-format](https://github.com/anthropics/skill-md-spec) skills for the Fetch.ai / ASI Alliance ecosystem.\n\n---\n\n## 📦 Skills\n\n| Skill | What it does | Key script |\n|-------|-------------|-----------|\n| [`agentverse-memory`](skills/agentverse-memory/) | Persistent graph-native memory for AI agents — 29 MCP tools (episodic, semantic, procedural, working, shared spaces) | `memory_client.py` |\n| [`agentverse-search`](skills/agentverse-search/) | Search Agentverse by keyword, tags, or protocol filter | `search_agents.py` |\n| [`agentverse-chat`](skills/agentverse-chat/) | Send ChatMessage to any Agentverse agent and get a response | `agentverse_chat.py` |\n| [`agentverse-image-gen`](skills/agentverse-image-gen/) | Generate images via Agentverse image agents (DALL-E 3) | `generate_image.py` |\n| [`agentverse-manage`](skills/agentverse-manage/) | List, start, stop, restart, and inspect your hosted agents | `manage_agents.py` |\n| [`agentverse-inspect`](skills/agentverse-inspect/) | Inspect any agent's metadata, protocols, and Almanac status | `inspect_agent.py` |\n| [`agentverse-deploy`](skills/agentverse-deploy/) | Deploy Python code as a hosted agent on Agentverse | `deploy_agent.py` |\n| [`asi1-chat`](skills/asi1-chat/) | Query the ASI:One LLM (`asi1` / `asi1-mini`) via API | `asi1_chat.py` |\n\n---\n\n## ⚡ Quick Start\n\n### 1. Get your API key\n\nSign up at [agentverse.ai](https://agentverse.ai) and create a key at **Profile → API Keys**.\n\n**macOS / Linux**\n```bash\nexport AGENTVERSE_API_KEY=\"your_key_here\"\n```\n\n**Windows (PowerShell)**\n```powershell\n$env:AGENTVERSE_API_KEY = \"your_key_here\"\n```\n\n\u003e 💡 **Windows users:** See [Windows / PowerShell](#-windows--powershell) below for the full setup guide.\n\n### 2. Clone this repo\n\n```bash\ngit clone https://github.com/fetchai/agentverse-skills.git\ncd agentverse-skills\npip install requests   # only dependency\n```\n\n### 3. Run a skill\n\n**macOS / Linux**\n```bash\n# Search for agents\npython3 skills/agentverse-search/scripts/search_agents.py --query \"image generation\" --limit 5\n\n# Chat with an agent\npython3 skills/agentverse-chat/scripts/agentverse_chat.py \\\n  --target agent1q0utywlfr3dfrfkwk4fjmtdrfew0zh692untdlr877d6ay8ykwpewydmxtl \\\n  --message \"Generate a sunset over Tokyo\"\n\n# Generate an image (full pipeline — deploys relay, waits ~30s)\npython3 skills/agentverse-image-gen/scripts/generate_image.py \\\n  --prompt \"dragon made of circuit boards on a Tokyo rooftop\"\n\n# Query ASI:One\npython3 skills/asi1-chat/scripts/asi1_chat.py \\\n  --prompt \"What is the Fetch.ai ecosystem?\"\n```\n\n**Windows (PowerShell)**\n```powershell\n# Search for agents\npy skills/agentverse-search/scripts/search_agents.py --query \"image generation\" --limit 5\n\n# Chat with an agent\npy skills/agentverse-chat/scripts/agentverse_chat.py `\n  --target agent1q0utywlfr3dfrfkwk4fjmtdrfew0zh692untdlr877d6ay8ykwpewydmxtl `\n  --message \"Generate a sunset over Tokyo\"\n\n# Generate an image\npy skills/agentverse-image-gen/scripts/generate_image.py `\n  --prompt \"dragon made of circuit boards on a Tokyo rooftop\"\n\n# Query ASI:One\npy skills/asi1-chat/scripts/asi1_chat.py `\n  --prompt \"What is the Fetch.ai ecosystem?\"\n```\n\nAll scripts output JSON to stdout. Errors go to stderr. Exit code 0 on success, 1 on failure.\n\n---\n\n## 🤖 Using With AI Coding Assistants\n\nThese skills follow the [SKILL.md specification](https://github.com/anthropics/skill-md-spec). Each skill directory contains a `SKILL.md` that your AI coding agent reads to understand what the skill does and how to invoke it.\n\n**Example — Claude Code / Cursor / Copilot:**\n\n```\n# Point your agent at the skill definition, then give it a task:\n\"Read fetchai/agentverse-skills/skills/agentverse-chat/SKILL.md\n and then send a message to agent1q0uty... asking it to generate a logo for 'Agent Launch'\"\n```\n\nThe agent reads `SKILL.md`, understands the script interface, runs it with the right arguments, and returns the result to you — no manual coding needed.\n\n**For AI agents working on this repo**, see [AGENTS.md](AGENTS.md) for technical conventions and key facts about the Agentverse API.\n\n---\n\n## 🏗️ How It Works\n\nThe chat and image-gen skills deploy a temporary **relay agent** on Agentverse that communicates with the target agent using the [uAgents Chat Protocol](https://github.com/fetchai/uAgents). This means:\n\n- **No public IP needed** — the relay runs on Agentverse infrastructure\n- **No uagents library required** — only `requests`\n- **Any target agent** — works with any Agentverse-hosted agent\n\n```\nYour Script            Agentverse Platform               Target Agent\n    │                         │                               │\n    ├── Deploy relay ────────►│                               │\n    ├── Upload chat code ────►│                               │\n    ├── Start relay ─────────►│─── ChatMessage ──────────────►│\n    │                         │◄── ChatMessage (response) ───┤\n    ├── Poll logs ◄───────────│                               │\n    └── Parse + return JSON   │                               │\n```\n\nFor `agentverse-search` and `agentverse-inspect`, scripts call the Almanac API directly — no relay needed.\n\n---\n\n## 🧪 Known-Active Agents (for testing)\n\nVerified active as of 2026-04-21:\n\n| Agent | Address | Description |\n|-------|---------|-------------|\n| DALL-E 3 Image Generator | `agent1q0utywlfr3dfrfkwk4fjmtdrfew0zh692untdlr877d6ay8ykwpewydmxtl` | Official Fetch.ai image gen via DALL-E 3 |\n| Technical Analysis | `agent1q085746wlr3u2uh4fmwqplude8e0w6fhrmqgsnlp49weawef3ahlutypvu6` | TA signals — official Fetch.ai |\n\nSearch for more active agents with:\n```bash\npython3 skills/agentverse-search/scripts/search_agents.py --query \"image\" --limit 10\n```\n\n---\n\n## 📐 SKILL.md Format\n\nEach skill has a `SKILL.md` with a YAML frontmatter block followed by human-readable documentation:\n\n```yaml\n---\nname: agentverse-chat\ndescription: \u003e\n  Send a ChatMessage to any Agentverse agent and retrieve the response.\n  Works with any agent that implements the uAgents Chat Protocol.\nlicense: Apache-2.0\ncompatibility: Python 3.8+, network access, AGENTVERSE_API_KEY env var\nmetadata:\n  version: \"1.1.0\"\n  author: \"Fetch.ai\"\n  last-updated: \"2026-04-21\"\nallowed-tools: Read Bash(python3 *) Bash(pip install requests)\n---\n```\n\nThe `allowed-tools` field tells AI coding agents which tools they're permitted to use when running this skill. The body of `SKILL.md` documents arguments, outputs, and examples.\n\n---\n\n## 🪟 Windows / PowerShell\n\nAll skills work on Windows. Replace `python3` with `py` (or `python`) and `export` with `$env:`.\n\n### Setting environment variables\n\n```powershell\n# Required\n$env:AGENTVERSE_API_KEY = \"your_key_here\"\n\n# Optional (for asi1-chat)\n$env:ASI_ONE_API_KEY = \"sk_...\"\n```\n\n\u003e To persist across sessions, add these to your PowerShell profile (`notepad $PROFILE`) or set them as User environment variables in **System Properties → Environment Variables**.\n\n### Running scripts\n\nUse `py` (Python Launcher, ships with Python for Windows) or `python`:\n\n```powershell\n# Using py (recommended on Windows)\npy skills/agentverse-search/scripts/search_agents.py --query \"weather\" --limit 5\n\n# Long commands: use backtick ` for line continuation (not backslash \\)\npy skills/agentverse-chat/scripts/agentverse_chat.py `\n  --target agent1q... `\n  --message \"Hello\"\n```\n\n### Command cheat sheet\n\n| Unix/macOS | Windows PowerShell |\n|---|---|\n| `export VAR=\"value\"` | `$env:VAR = \"value\"` |\n| `python3 script.py` | `py script.py` |\n| `\\` (line continuation) | `` ` `` (backtick) |\n| `pip3 install requests` | `pip install requests` |\n\n### Troubleshooting on Windows\n\n- **`py` not found?** Install Python from [python.org](https://www.python.org/downloads/) and ensure \"Add Python to PATH\" is checked during install.\n- **`$env:VAR` not persisting?** Set the variable as a permanent User environment variable in **System Properties → Advanced → Environment Variables**.\n- **SSL errors?** Run `pip install --upgrade certifi pip-system-certs`.\n\n---\n\n## 🔧 Requirements\n\n| Requirement | Details |\n|-------------|---------|\n| Python | 3.8 or higher |\n| Library | `requests` (`pip install requests`) |\n| API key | `AGENTVERSE_API_KEY` — get at [agentverse.ai/profile/api-keys](https://agentverse.ai/profile/api-keys) |\n| Optional | `ASI_ONE_API_KEY` — for `asi1-chat` skill only |\n\n---\n\n## 📁 Repo Structure\n\n```\nskills/\n├── agentverse-chat/          # Send messages to any Agentverse agent\n│   ├── SKILL.md              # Skill definition (read by AI agents)\n│   ├── scripts/              # Self-contained Python scripts\n│   └── references/           # Deep API documentation\n├── agentverse-search/        # Search the Agentverse agent registry\n├── agentverse-image-gen/     # Generate images via hosted agents\n├── agentverse-deploy/        # Deploy Python code as a hosted agent\n├── agentverse-manage/        # Manage hosted agents (start/stop/restart)\n├── agentverse-inspect/       # Inspect agent capabilities and status\n└── asi1-chat/                # Query the ASI:One LLM\nexamples/                     # Worked examples with full outputs\ndocs/                         # API reference, auth guide, troubleshooting\ntests/                        # Live integration tests\nAGENTS.md                     # Technical guide for AI agents working on this repo\n```\n\n---\n\n## 🌐 About Agentverse\n\n[Agentverse](https://agentverse.ai) is Fetch.ai's platform for deploying and discovering AI agents. It's part of the [ASI Alliance](https://asi.ai) (Artificial Superintelligence Alliance) — a collaboration between Fetch.ai and SingularityNET.\n\nKey concepts:\n- **Hosted Agents** — Python agents running on Agentverse infrastructure\n- **Almanac** — Decentralized registry of all agents and their capabilities\n- **Chat Protocol** — Standard message format for agent-to-agent communication\n- **FET / ASI Token** — Native token of the Fetch.ai ecosystem\n\n---\n\n## 🤝 Compatibility\n\nTested with all major AI coding assistants:\n\n| Tool | Status |\n|------|--------|\n| Claude Code | ✅ Full support |\n| GitHub Copilot | ✅ Full support |\n| Cursor | ✅ Full support |\n| Codex (OpenAI) | ✅ Full support |\n| Gemini CLI | ✅ Full support |\n| Taurus Agents | ✅ Full support |\n| Any SKILL.md-compatible agent | ✅ Full support |\n\n---\n\n## 🔗 Links\n\n- [Agentverse Platform](https://agentverse.ai)\n- [Fetch.ai Documentation](https://fetch.ai/docs)\n- [uAgents Framework](https://github.com/fetchai/uAgents)\n- [ASI Alliance](https://asi.ai)\n- [Agent Launch](https://agent-launch.ai) — AI Agent Token Launchpad on BSC\n\n---\n\n## 🤝 Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for how to add new skills, run tests, and submit PRs.\n\n## 📜 License\n\n[Apache 2.0](LICENSE) — © 2026 Fetch.ai\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffetchai%2Fagentverse-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffetchai%2Fagentverse-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffetchai%2Fagentverse-skills/lists"}