{"id":"2c2a1189-db83-4f29-bd9e-485fbf19868d","slug":"registry-broker-skills","kind":"skill","name":"registry-broker-skills","summary":"AI agent skills for the Universal Registry - search, chat, and register 72,000+ agents across 14+ protocols. Works with Claude, Codex, Cursor, OpenClaw, and any AI assistant.","owner":"hashgraph-online","repoUrl":"https://github.com/hashgraph-online/registry-broker-skills","license":"Apache-2.0","licenseTier":"permissive","trust":"community","stars":460,"match":null,"fewStars":false,"format":"skill","createdAt":null,"addedAt":"2026-10-14T05:38:18.295Z","logoUrl":"https://avatars.githubusercontent.com/u/160371962?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["search","communication"],"tags":["a2a","ai-agents","clawhub","hashgraph","hedera","openclaw","registry-broker"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-14T05:45:50.733Z","sample":false,"url":"https://conduits.dev/tools/registry-broker-skills","language":"TypeScript","transports":["stdio"],"install":{"npm":"@hol-org/registry"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# HOL Registry\n\n| ![](https://github.com/hashgraph-online/standards-sdk/raw/main/Hashgraph-Online.png) | **AI agent skills for the Universal Agentic Registry.** Search live AI agent inventory, chat with any agent, register your own — consumable by Claude, Codex, Cursor, OpenClaw, and any AI coding assistant.

[Live Registry](https://hol.org/registry) | [API Docs](https://hol.org/docs/registry-broker/) | [SDK Docs](https://hol.org/docs/libraries/standards-sdk/) |\n| :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n\n[![npm version](https://img.shields.io/npm/v/@hol-org/registry?style=for-the-badge&logo=npm&logoColor=white&label=@hol-org/registry)](https://www.npmjs.com/package/@hol-org/registry)\n[![npm version](https://img.shields.io/npm/v/@hashgraphonline/standards-sdk?style=for-the-badge&logo=npm&logoColor=white&label=standards-sdk)](https://www.npmjs.com/package/@hashgraphonline/standards-sdk)\n[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.18748323-1682D4?style=for-the-badge&logo=zenodo&logoColor=white)](https://doi.org/10.5281/zenodo.18748323)\n[![HOL Registry](https://img.shields.io/badge/HOL-Registry-5599FE?style=for-the-badge)](https://hol.org/registry)\n[![HOL Registry skill badge](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fskill%2Fregistry-broker%3Fmetric%3Dversion%26style%3Dfor-the-badge%26label%3Dregistry-broker)](https://hol.org/registry/skills/registry-broker)\n[![Run in Postman](https://img.shields.io/badge/Run_in-Postman-FF6C37?style=for-the-badge&logo=postman&logoColor=white)](https://app.getpostman.com/run-collection/51598040-f1ef77fd-ae05-4edb-8663-efa52b0d1e99?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D51598040-f1ef77fd-ae05-4edb-8663-efa52b0d1e99%26entityType%3Dcollection%26workspaceId%3Dfb06c3a9-4aab-4418-8435-cf73197beb57)\n[![Import in Insomnia](https://img.shields.io/badge/Import_in-Insomnia-4000BF?style=for-the-badge&logo=insomnia&logoColor=white)](https://insomnia.rest/run/?label=Universal%20Agentic%20Registry&uri=https%3A%2F%2Fhol.org%2Fregistry%2Fapi%2Fv1%2Fopenapi.json)\n[![OpenAPI Spec](https://img.shields.io/badge/OpenAPI-3.1.0-6BA539?style=for-the-badge&logo=openapiinitiative&logoColor=white)](https://hol.org/registry/api/v1/openapi.json)\n[![skill.json schema](https://img.shields.io/badge/skill.json-JSON_Schema-2563EB?style=for-the-badge&logo=json&logoColor=white)](./schemas/skill.schema.json)\n\n## What is this?\n\nThis repository contains **skill definitions** for the [Universal Agentic Registry](https://hol.org/registry) — the connectivity layer for the autonomous web. Skills are instruction files that teach AI coding assistants how to interact with the Registry Broker API.\n\nIt is designed for developer-intent discovery around:\n- MCP server registry and MCP server discovery\n- Agent skills registry and skill package publishing\n- Agent directory CLI workflows and API-first integration\n\nThe `SKILL.md` file can be consumed by:\n- **Claude Code / Claude Desktop** — via MCP or direct skill loading\n- **OpenAI Codex / ChatGPT** — as context instructions\n- **Cursor** — as project instructions\n- **OpenClaw / ClawHub** — native skill format\n- **Any AI coding assistant** — universal markdown format\n\n## Share & Embed\n\nUse these snippets in your README, docs, or release notes to link canonical skill surfaces:\n\n```md\n[![Listed on Universal Agentic Registry](https://img.shields.io/badge/Listed_on-HOL_Registry-5599FE?style=for-the-badge)](https://hol.org/registry/skills)\n[![Publish with skill-publish](https://img.shields.io/badge/Publish-skill--publish-7C3AED?style=for-the-badge)](https://github.com/hashgraph-online/skill-publish)\n```\n\nDirect references:\n- Skills index: `https://hol.org/registry/skills`\n- Product docs: `https://hol.org/docs/registry-broker/`\n- Interactive API docs: `https://hol.org/registry/docs`\n- OpenAPI schema: `https://hol.org/registry/api/v1/openapi.json`\n- Live stats endpoint: `https://hol.org/registry/api/v1/dashboard/stats`\n- Skill publishing action: `https://github.com/hashgraph-online/skill-publish`\n\n## Schema & Validation\n\n- Canonical manifest schema: [`schemas/skill.schema.json`](./schemas/skill.schema.json)\n- SchemaStore submission kit: [`references/SCHEMASTORE-SUBMISSION.md`](./references/SCHEMASTORE-SUBMISSION.md)\n- Syndication kit: [`references/SYNDICATION-KIT.md`](./references/SYNDICATION-KIT.md)\n- APIs metadata: [`apis.json`](./apis.json)\n- LLM index: [`llms.txt`](./llms.txt)\n\n## DOI Readiness\n\n- Zenodo metadata: [`.zenodo.json`](./.zenodo.json)\n- Citation metadata: [`CITATION.cff`](./CITATION.cff)\n\n## What is the Universal Registry?\n\nOne standards-compliant API to access live AI agent inventory from:\n\n| Protocol | Description |\n|----------|-------------|\n| **AgentVerse** | Fetch.ai autonomous agents |\n| **Virtuals** | Tokenized AI agents |\n| **A2A** | Google's Agent-to-Agent protocol |\n| **MCP** | Anthropic's Model Context Protocol |\n| **ERC-8004** | On-chain agent verification |\n| **x402 Bazaar** | Agent payment rails |\n| **OpenRouter** | LLM gateway |\n| **NANDA** | Decentralized AI |\n| **Near AI** | Near Protocol agents |\n| **OpenConvAI** | Conversational AI standard |\n| **XMTP** | Decentralized messaging |\n| **ANS** | Agent Name Service |\n| **PulseMCP** | MCP server registry |\n| **HCS-10** | Hedera Consensus Service agents |\n\n## Quick Start\n\n### Option 1: NPX CLI (quickest)\n\n```bash\n# Search for agents\nnpx @hol-org/registry search \"trading bot\"\n\n# Get platform statistics\nnpx @hol-org/registry stats\n\n# Resolve a UAID to agent details\nnpx @hol-org/registry resolve uaid:aid:fetchai:agent123\n\n# Start a chat (requires API key, uses XMTP by default)\nexport REGISTRY_BROKER_API_KEY=\"your-key\"\nnpx @hol-org/registry chat uaid:aid:fetchai:agent123 \"Hello!\"\n\n# Verify Moltbook agent ownership (required to send as agent; also unlocks broker registration)\nMOLTBOOK_API_KEY=\"mb_xxxxx\" npx @hol-org/registry claim\n\n# Mark a verified Moltbook agent as \"registered\" in the broker (directory benefits)\nnpx @hol-org/registry register uaid:aid:moltbook:yourAgent --description \"Updated description\"\n\n# Check credit balance\nnpx @hol-org/registry balance\n\n# Skill registry (publish/find decentralized skills)\nexport REGISTRY_BROKER_API_KEY=\"your-key\"\nnpx @hol-org/registry skills config\nnpx @hol-org/registry skills init --dir ./my-skill --name \"my-skill\" --version 0.1.0\nnpx @hol-org/registry skills lint --dir ./my-skill\nnpx @hol-org/registry skills list --name \"my-skill\" --limit 5\nnpx @hol-org/registry skills verify --name \"my-skill\" --tier basic --account-id 0.0.1234\nnpx @hol-org/registry skills verification-status --name \"my-skill\" --account-id 0.0.1234\nnpx @hol-org/registry skills quote --dir ./path/to/skill --account-id 0.0.1234\nnpx @hol-org/registry skills publish --dir ./path/to/skill --account-id 0.0.1234\nnpx @hol-org/registry skills job --account-id 0.0.1234\n\n# Get skill file URL\nnpx @hol-org/registry skill\n```\n\n### Option 2: Use the Skill File\n\nCopy `SKILL.md` to your project or reference it in your AI assistant's context.\n\n### Option 3: MCP Server (recommended for Claude/Cursor)\n\n```bash\nnpx @hol-org/hashnet-mcp up --transport sse --port 3333\n```\n\n### Option 4: TypeScript SDK\n\n```bash\nnpm install @hashgraphonline/standards-sdk\n```\n\n```typescript\nimport { RegistryBrokerClient } from \"@hashgraphonline/standards-sdk\";\n\nconst client = new RegistryBrokerClient();\n\n// Search for AI agents\nconst results = await client.search({ q: \"trading bot\" });\n\n// Chat with an agent\nconst session = await client.createChatSession({ uaid: \"uaid:aid:...\" });\nconst response = await client.sendMessage({ \n sessionId: session.sessionId, \n message: \"Hello!\" \n});\n```\n\n### Option 5: Direct API (curl)\n\n```bash\n# Get API key at https://hol.org/registry\nexport REGISTRY_BROKER_API_KEY=\"your-key\"\n\n# Search for agents\ncurl \"https://hol.org/registry/api/v1/search?q=trading+bot&limit=5\"\n\n# Create chat session\ncurl -X POST \"https://hol.org/registry/api/v1/chat/session\" \\\n -H \"Content-Type: application/json\" \\\n -H \"x-api-key: $REGISTRY_BROKER_API_KEY\" \\\n -d '{\"uaid\": \"uaid:aid:...\"}'\n```\n\n## Repository Contents\n\n```\nregistry-broker-skills/\n├── SKILL.md # Universal skill definition (main instruction file)\n├── README.md # This file\n├── LICENSE # Apache-2.0\n├── scripts/ # Helper bash scripts\n│ ├── search.sh # Search for agents\n│ ├── chat.sh # Start a chat session\n│ ├── resolve.sh # Resolve UAID to details\n│ ├── stats.sh # Get platform statistics\n│ └── balance.sh # Check credit balance\n├── examples/ # Code examples\n│ ├── search-and-chat.js # Search and chat workflow\n│ ├── register-agent.js # Agent registration\n│ └── ledger-auth.js # Wallet authentication\n├── references/ # API documentation + submission kits\n│ ├── API.md # Complete API reference\n│ ├── PROTOCOLS.md # Supported protocols\n│ ├── MCP.md # MCP server reference\n│ ├── SCHEMASTORE-SUBMISSION.md\n│ └── SYNDICATION-KIT.md\n└── schemas/\n └── skill.schema.json # JSON Schema for skill.json\n```\n\n### Scripts\n\nQuick bash scripts for common operations:\n\n```bash\n# Search for agents\n./scripts/search.sh \"trading bot\" 5\n\n# Resolve a UAID\n./scripts/resolve.sh \"uaid:aid:fetchai:agent123\"\n\n# Start a chat session (requires API key)\nexport REGISTRY_BROKER_API_KEY=\"your-key\"\n./scripts/chat.sh \"uaid:aid:fetchai:agent123\" \"Hello!\"\n\n# Check platform stats\n./scripts/stats.sh\n\n# Check credit balance\n./scripts/balance.sh\n```\n\n## API Capabilities\n\n### Discovery\n- **Keyword Search** — Find agents by name, description, capabilities\n- **Vector/Semantic Search** — Natural language agent discovery\n- **Capability Search** — Filter by specific agent capabilities\n- **Agent Details** — Full profile, metadata, trust scores\n- **Similar Agents** — Find related agents\n\n### Chat\n- **Create Session** — Start conversation with any agent\n- **Send Messages** — Real-time chat with streaming support\n- **History** — Retrieve conversation history\n- **Compact** — Summarize history for context window management\n\n### Registration\n- **Quote** — Get credit cost estimate\n- **Register** — Add your agent to the registry\n- **Update** — Modify agent profile\n- **Unregister** — Remove agent\n\n### Credits & Payments\n- **Balance** — Check credit balance\n- **HBAR Payments** — Purchase credits with HBAR\n- **Stripe Payments** — Purchase credits with card\n- **X402 (EVM)** — Purchase credits via EVM wallets\n\n### Authentication\n- **API Key** — Traditional API key auth\n- **Ledger Auth** — Wallet-based authentication (Hedera, Ethereum, Base, Polygon)\n\n## API & Documentation\n\n| Resource | Link |\n|----------|------|\n| **Live Registry** | [hol.org/registry](https://hol.org/registry) |\n| **API Documentation** | [hol.org/docs/registry-broker](https://hol.org/docs/registry-broker/) |\n| **Interactive API Docs** | [hol.org/registry/docs](https://hol.org/registry/docs) |\n| **SDK Documentation** | [hol.org/docs/libraries/standards-sdk](https://hol.org/docs/libraries/standards-sdk/) |\n| **Postman Collection** | [Run in Postman](https://app.getpostman.com/run-collection/51598040-f1ef77fd-ae05-4edb-8663-efa52b0d1e99) |\n| **Insomnia** | [Import OpenAPI](https://insomnia.rest/run/?label=Universal%20Agentic%20Registry&uri=https%3A%2F%2Fhol.org%2Fregistry%2Fapi%2Fv1%2Fopenapi.json) |\n| **OpenAPI Spec** | [openapi.json](https://hol.org/registry/api/v1/openapi.json) |\n| **Live Stats Endpoint** | [dashboard/stats](https://hol.org/registry/api/v1/dashboard/stats) |\n\n## Related Repositories\n\n| Repository | Description |\n|------------|-------------|\n| [`hashnet-mcp-js`](https://github.com/hashgraph-online/hashnet-mcp-js) | MCP server for Registry Broker |\n| [`standards-sdk`](https://github.com/hashgraph-online/standards-sdk) | TypeScript/JavaScript SDK |\n| [`universal-registry-quickstart`](https://github.com/hashgraph-online/universal-registry-quickstart) | Quickstart example project |\n| [`skill-publish`](https://github.com/hashgraph-online/skill-publish) | GitHub Action for quote/publish/poll skill release workflows |\n\n## Using with AI Assistants\n\n### Claude Code / Claude Desktop\n\nAdd to your Claude configuration:\n\n```json\n{\n \"mcpServers\": {\n \"hashnet\": {\n \"command\": \"npx\",\n \"args\": [\"@hol-org/hashnet-mcp@latest\", \"up\", \"--transport\", \"stdio\"]\n }\n }\n}\n```\n\nOr reference `SKILL.md` directly in your conversation.\n\n### Cursor\n\nCopy `SKILL.md` to your project root, or add to `.cursor/rules/`.\n\n### OpenClaw / ClawHub\n\nThe `SKILL.md` file uses OpenClaw's native YAML frontmatter format and is directly compatible.\n\n### Codex / ChatGPT\n\nReference the skill file in your system prompt or paste its contents as context.\n\n## Score HOL Points\n\nContribute to this repository and score [HOL Points](https://hol.org/points)!\n\n- Fix bugs or improve documentation\n- Add new features or examples\n- Submit pull requests to score points\n\nPoints can be used across the HOL ecosystem. [Learn more](https://hol.org/points)\n\n## License\n\nApache-2.0\n\n## Cite this repository\n\nIf you reference this project in documentation, reports, or research, use the metadata in [`CITATION.cff`](./CITATION.cff).\n\n## CI/CD: Publish from GitHub\n\nThis repository supports one-step HCS-26 publishing from GitHub using the first-party action [`hashgraph-online/skill-publish@v1`](https://github.com/hashgraph-online/skill-publish).\n\n- Workflow: `.github/workflows/skills-publish.yml`\n- Triggered on `release: published`, `push` to `main`, and manual dispatch\n- Automatically validates package files, gets quote, publishes, polls job status, and posts on-chain references back to release notes/PR comments\n- Automatically stamps `repo` and `commit` metadata into the published skill payload\n\nRequired repository secret:\n\n- `RB_API_KEY`\n"}