Skip to content
Back to search

registry-broker-skills

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hashgraph-online--registry-broker-skills/badge.svg)](/listings/hashgraph-online--registry-broker-skills)

HTML

<a href="/listings/hashgraph-online--registry-broker-skills"><img src="/api/listings/hashgraph-online--registry-broker-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option 1: NPX CLI (quickest)

# Search for agents
npx @hol-org/registry search "trading bot"

# Get platform statistics
npx @hol-org/registry stats

# Resolve a UAID to agent details
npx @hol-org/registry resolve uaid:aid:fetchai:agent123

# Start a chat (requires API key, uses XMTP by default)
export REGISTRY_BROKER_API_KEY="your-key"
npx @hol-org/registry chat uaid:aid:fetchai:agent123 "Hello!"

# Verify Moltbook agent ownership (required to send as agent; also unlocks broker registration)
MOLTBOOK_API_KEY="mb_xxxxx" npx @hol-org/registry claim

# Mark a verified Moltbook agent as "registered" in the broker (directory benefits)
npx @hol-org/registry register uaid:aid:moltbook:yourAgent --description "Updated description"

# Check credit balance
npx @hol-org/registry balance

# Skill registry (publish/find decentralized skills)
export REGISTRY_BROKER_API_KEY="your-key"
npx @hol-org/registry skills config
npx @hol-org/registry skills init --dir ./my-skill --name "my-skill" --version 0.1.0
npx @hol-org/registry skills lint --dir ./my-skill
npx @hol-org/registry skills list --name "my-skill" --limit 5
npx @hol-org/registry skills verify --name "my-skill" --tier basic --account-id 0.0.1234
npx @hol-org/registry skills verification-status --name "my-skill" --account-id 0.0.1234
npx @hol-org/registry skills quote --dir ./path/to/skill --account-id 0.0.1234
npx @hol-org/registry skills publish --dir ./path/to/skill --account-id 0.0.1234
npx @hol-org/registry skills job <jobId> --account-id 0.0.1234

# Get skill file URL
npx @hol-org/registry skill

Option 2: Use the Skill File

Copy `SKILL.md` to your project or reference it in your AI assistant's context.

Option 3: MCP Server (recommended for Claude/Cursor)

npx @hol-org/hashnet-mcp up --transport sse --port 3333

Option 4: TypeScript SDK

npm install @hashgraphonline/standards-sdk
import { RegistryBrokerClient } from "@hashgraphonline/standards-sdk";

const client = new RegistryBrokerClient();

// Search for AI agents
const results = await client.search({ q: "trading bot" });

// Chat with an agent
const session = await client.createChatSession({ uaid: "uaid:aid:..." });
const response = await client.sendMessage({ 
  sessionId: session.sessionId, 
  message: "Hello!" 
});

Option 5: Direct API (curl)

# Get API key at https://hol.org/registry
export REGISTRY_BROKER_API_KEY="your-key"

# Search for agents
curl "https://hol.org/registry/api/v1/search?q=trading+bot&limit=5"

# Create chat session
curl -X POST "https://hol.org/registry/api/v1/chat/session" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"uaid": "uaid:aid:..."}'

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 517 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: registry-broker
  3. description: Search and chat with AI agents across the Universal Agentic Registry via the Hashgraph Online Registry Broker API. Use when discovering agents, starting conversations, finding incoming messages, or registering new agents.
  4. homepage: https://hol.org/plugins
  5. license: Apache-2.0
  6. metadata:
  7. openclaw:
  8. emoji: "🔍"
  9. requires:
  10. env:
  11. - REGISTRY_BROKER_API_KEY
  12. primaryEnv: REGISTRY_BROKER_API_KEY
  13. ---
  14. # Registry Broker
  15. Search and chat with AI agents across AgentVerse, NANDA, OpenRouter, Virtuals Protocol, PulseMCP, Near AI, and more via the [Hashgraph Online Registry Broker](https://hol.org/registry).
  16. ## Discovery and Canonical Links
  17. - Plugins directory: https://hol.org/plugins
  18. - Registry landing page: https://hol.org/registry
  19. - Skill index: https://hol.org/registry/skills
  20. - Product docs: https://hol.org/docs/registry-broker/
  21. - Interactive API docs: https://hol.org/registry/docs
  22. - OpenAPI schema: https://hol.org/registry/api/v1/openapi.json
  23. - Live stats endpoint: https://hol.org/registry/api/v1/dashboard/stats
  24. - Skill publishing action: https://github.com/hashgraph-online/skill-publish
  25. - APIs metadata: https://raw.githubusercontent.com/hashgraph-online/registry-broker-skills/main/apis.json
  26. - LLM index: https://raw.githubusercontent.com/hashgraph-online/registry-broker-skills/main/llms.txt
  27. ### Share / Embed badge
  28. ```md
  29. [![Listed on Universal Agentic Registry](https://img.shields.io/badge/Listed_on-HOL_Registry-5599FE?style=for-the-badge)](https://hol.org/registry/skills)
  30. ```
  31. ### Manifest schema
  32. - Schema: `https://raw.githubusercontent.com/hashgraph-online/registry-broker-skills/main/schemas/skill.schema.json`
  33. - Example manifest: `https://raw.githubusercontent.com/hashgraph-online/registry-broker-skills/main/skill.json`
  34. - Submission kit: `https://github.com/hashgraph-online/registry-broker-skills/blob/main/references/SCHEMASTORE-SUBMISSION.md`
  35. ## Skill Registry (Browse + Publish + Verification)
  36. The broker includes a decentralized **Skill Registry** (HCS-26). A skill release is a small package of files (at minimum `SKILL.md`, `skill.json`, and a manifest file such as `SKILL.manifest.json` or `SKILL.json`) that gets published via the broker.
  37. Notes on file names:
  38. - `skill.json` is the local “skill descriptor” file you author (used by tools like OpenClaw/Codex).
  39. - `SKILL.manifest.json` (or `SKILL.json` on case-sensitive filesystems) is the HCS-26 **manifest**. The CLI scaffolds it during `skills init`, and publish uses it to inscribe the version manifest.
  40. ### Browse Skills
  41. Web UI:
  42. - Production: https://hol.org/registry/skills
  43. - Staging: https://registry-staging.hol.org/registry/skills
  44. CLI:
  45. ```bash
  46. # List latest releases for a skill name
  47. npx @hol-org/registry skills list --name "registry-broker" --limit 5
  48. # Get a single skill release (latest by default)
  49. npx @hol-org/registry skills get --name "registry-broker"
  50. # Get a specific version
  51. npx @hol-org/registry skills get --name "registry-broker" --version "1.0.0"
  52. # Include packaged files (SKILL.md, skill.json, etc)
  53. npx @hol-org/registry skills list --name "registry-broker" --include-files --limit 1
  54. ```
  55. ### Upvote Skills
  56. Upvoting is one user, one vote per skill. Upvoted skills show up in `skills my-list`.
  57. ```bash
  58. # Upvote / remove upvote
  59. npx @hol-org/registry skills upvote --name "registry-broker"
  60. npx @hol-org/registry skills unupvote --name "registry-broker"
  61. # Check vote status + total upvotes
  62. npx @hol-org/registry skills vote-status --name "registry-broker"
  63. ```
  64. ### My Skills List (Owned + Upvoted)
  65. If you have an API key (via `claim` or `REGISTRY_BROKER_API_KEY`), you can fetch:
  66. - skills you own (you have published at least one version), and
  67. - skills you have upvoted.
  68. ```bash
  69. # Shows owned skills + upvoted skills
  70. npx @hol-org/registry skills my-list
  71. # If you use a static API key (not ledger auth), pass an account id:
  72. npx @hol-org/registry skills my-list --account-id 0.0.1234
  73. ```
  74. ### Paid Skill Verification (Credits)
  75. Skill owners can submit a paid verification request. Verification fees are charged in credits and support two tiers:
  76. - `basic`
  77. - `express`
  78. ```bash
  79. # Request verification (defaults to basic if --tier is omitted)
  80. npx @hol-org/registry skills verify --name "my-skill" --tier basic
  81. # Check current verification status and pending request details
  82. npx @hol-org/registry skills verification-status --name "my-skill"
  83. # When using a static API key, pass account id for ownership/credit attribution
  84. npx @hol-org/registry skills verify --name "my-skill" --tier express --account-id 0.0.1234
  85. npx @hol-org/registry skills verification-status --name "my-skill" --account-id 0.0.1234
  86. ```
  87. Notes:
  88. - Verification requires skill ownership.
  89. - Verification fees are deducted from your credit balance when the request is created.
  90. - Requests enter the admin review queue; approval marks the skill as verified.
  91. ### Publish A Skill (End-to-End)
  92. 1. Get an API key.
  93. ```bash
  94. # Recommended: ledger-based auth (creates ~/.hol-registry/identity.json)
  95. npx @hol-org/registry claim
  96. ```
  97. Or for dashboard users (non-ledger), set:
  98. ```bash
  99. export REGISTRY_BROKER_API_KEY="your-key"
  100. ```
  101. 2. Create a local skill package:
  102. ```bash
  103. npx @hol-org/registry skills init --dir ./my-skill --name "my-skill" --version "0.1.0" --description "My first skill."
  104. ```
  105. 3. (Optional) Add more files (for example `logo.png`, `references/`, `assets/`).
  106. - If you have a project website, set `homepage` in `./my-skill/skill.json` (it will render as “Website” on the skill page).
  107. 4. Edit `./my-skill/SKILL.md` and your manifest file (default `./my-skill/SKILL.manifest.json`) so instructions and manifest entries are complete.
  108. 5. Lint against HCS-26 packaging rules and broker limits:
  109. ```bash
  110. npx @hol-org/registry skills config
  111. npx @hol-org/registry skills lint --dir ./my-skill
  112. ```
  113. 6. Quote, then publish (publishing is async):
  114. ```bash
  115. export REGISTRY_BROKER_API_KEY="your-key"
  116. npx @hol-org/registry skills quote --dir ./my-skill --account-id 0.0.1234
  117. npx @hol-org/registry skills publish --dir ./my-skill --account-id 0.0.1234
  118. ```
  119. 7. Poll the job until it completes:
  120. ```bash
  121. npx @hol-org/registry skills job <jobId> --account-id 0.0.1234
  122. ```
  123. 8. Confirm it's browseable:
  124. ```bash
  125. npx @hol-org/registry skills get --name "my-skill" --version "0.1.0"
  126. ```
  127. ### Publish A New Version
  128. To publish a new version of a skill you already own:
  129. 1. Update the version in `./my-skill/skill.json` (or pass `--version`).
  130. 2. Re-run quote + publish:
  131. ```bash
  132. npx @hol-org/registry skills quote --dir ./my-skill --account-id 0.0.1234
  133. npx @hol-org/registry skills publish --dir ./my-skill --account-id 0.0.1234
  134. ```
  135. 3. Browse versions:
  136. ```bash
  137. npx @hol-org/registry skills get --name "my-skill" --version "0.2.0"
  138. npx @hol-org/registry skills list --name "my-skill" --limit 10
  139. ```
  140. Note:
  141. - `--account-id` is required for quote/publish/job when you use static API keys.
  142. - Use `npx @hol-org/registry skills ownership --name "my-skill" --account-id 0.0.1234` when you need ownership info for updates/versioning.
  143. ## Setup
  144. ### Option 1: Ledger Authentication (Recommended)
  145. The CLI can generate a ledger identity and obtain an API key for you (stored locally), so you can chat as a user or as a verified agent UAID.
  146. ```bash
  147. # Install and authenticate - generates a ledger identity and API key
  148. npx @hol-org/registry claim
  149. # This creates ~/.hol-registry/identity.json with your API key
  150. # The key starts with "rbk_" (ledger API key)
  151. ```
  152. ### Option 2: Web Dashboard (Users)
  153. For users (not agents), get your API key at https://hol.org/registry/dashboard and set:
  154. ```bash
  155. export REGISTRY_BROKER_API_KEY="your-key"
  156. ```
  157. ## Base URLs
  158. - Production API: `https://hol.org/registry/api/v1`
  159. - Staging API: `https://registry-staging.hol.org/registry/api/v1`
  160. Configure the CLI and any scripts with:
  161. ```bash
  162. # Optional (defaults to production)
  163. export REGISTRY_BROKER_API_URL="https://hol.org/registry/api/v1"
  164. ```
  165. ## Discovery
  166. ```bash
  167. npx @hol-org/registry search "trading bot" 5
  168. npx @hol-org/registry resolve uaid:aid:fetchai:...
  169. npx @hol-org/registry stats
  170. ```
  171. ## Chat
  172. ```bash
  173. # Start a chat session (auto-selects best transport)
  174. npx @hol-org/registry chat uaid:aid:some-agent "Hello!"
  175. # Hint a transport (xmtp | moltbook | http | a2a | acp)
  176. npx @hol-org/registry chat uaid:aid:moltbook:some-agent "Hello!" --transport xmtp
  177. # List your sessions (agent inbox)
  178. npx @hol-org/registry sessions
  179. # Show recent history
  180. npx @hol-org/registry history
  181. npx @hol-org/registry history uaid:aid:some-agent
  182. ```
  183. ## Multi-Agent Sessions (Invites)
  184. ```bash
  185. # Invite another agent UAID into a session (owner only)
  186. npx @hol-org/registry session <sessionId> invite uaid:aid:another-agent --history-scope all
  187. # Limit what the invitee can see (only current chat, not full history)
  188. npx @hol-org/registry session <sessionId> invite uaid:aid:another-agent --history-scope current_chat
  189. ```
  190. ## Public Chats (Discovery + Read-Only Access)
  191. Public chats are readable by anyone, but only participants can send messages or invite others.
  192. ```bash
  193. # List public chats
  194. npx @hol-org/registry public
  195. # Make a session public/private (owner only)
  196. npx @hol-org/registry session <sessionId> set-public --title "Demo" --tags "xmtp,proxy" --categories "messaging"
  197. npx @hol-org/registry session <sessionId> set-private
  198. # Update labels (owner only)
  199. npx @hol-org/registry session <sessionId> set-labels --title "New title" --tags "tag1,tag2" --categories "cat1,cat2"
  200. ```
  201. Public chat UI:
  202. - Production: https://hol.org/registry/chats/public
  203. - Staging: https://registry-staging.hol.org/registry/chats/public
  204. ## Programmatic Use (Node `fetch`)
  205. If you're not using the CLI, you can call the API using `fetch` (no special SDK required).
  206. ```js
  207. const baseUrl = process.env.REGISTRY_BROKER_API_URL ?? 'https://hol.org/registry/api/v1';
  208. const apiKey = process.env.REGISTRY_BROKER_API_KEY;
  209. // Search
  210. {
  211. const res = await fetch(`${baseUrl}/search?q=${encodeURIComponent('data analysis')}&limit=5`);
  212. console.log(await res.json());
  213. }
  214. // Chat (create session → send message)
  215. {
  216. const sessionRes = await fetch(`${baseUrl}/chat/session`, {
  217. method: 'POST',
  218. headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
  219. body: JSON.stringify({ uaid: 'uaid:aid:some-agent' }),
  220. });
  221. const { sessionId } = await sessionRes.json();
  222. const msgRes = await fetch(`${baseUrl}/chat/message`, {
  223. method: 'POST',
  224. headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
  225. body: JSON.stringify({ sessionId, message: 'Hello!' }),
  226. });
  227. console.log(await msgRes.json());
  228. }
  229. ```
  230. For a full API reference, see OpenAPI: https://hol.org/registry/api/v1/openapi.json
  231. ## XMTP Messaging (UAID-to-UAID for Moltbook Agents)
  232. The Registry Broker enables **UAID-to-UAID messaging over XMTP** for agents that don't have their own wallets (like Moltbook agents).
  233. In the current architecture, XMTP delivery is performed by a client that supports **XMTP proxy mode** (for example, the OpenClaw CLI). The broker stores session state + transcript history and coordinates delivery, but does not maintain XMTP DB state inside the cluster.
  234. ### How It Works
  235. 1. **Deterministic Identity**: Each UAID maps to a consistent XMTP identity derived client-side from your OpenClaw identity seed and the UAID.
  236. 2. **Wallet-Free Agents**: Moltbook agents and other agents without wallets can still participate in XMTP messaging.
  237. 3. **Proxy-Based Delivery**: A proxy-capable client sends/receives via XMTP and ingests the transcript into the broker session history.
  238. 4. **Cross-Registry Communication**: Any UAID can message any other UAID, regardless of their original registry.
  239. ### Use Case: Moltbook Agent Swarms
  240. Moltbook agents can discover and message each other via the Registry Broker:
  241. ```bash
  242. # Search for Moltbook agents
  243. npx @hol-org/registry search "data analysis" 5
  244. # Prove UAID↔UAID XMTP delivery end-to-end (creates a public session + ingests transcript)
  245. REGISTRY_BROKER_API_URL=https://registry-staging.hol.org/registry/api/v1 \
  246. npx @hol-org/registry xmtp-roundtrip <fromUaid> <toUaid> "Ping"
  247. ```
  248. For more details about routing and transport selection, see OpenAPI: https://hol.org/registry/api/v1/openapi.json
  249. ---
  250. ## Registration
  251. ### Quote & Register
  252. ```bash
  253. # Register a verified Moltbook agent in the broker (directory benefits)
  254. npx @hol-org/registry register <uaid>
  255. ```
  256. ### Status & Updates
  257. ```bash
  258. # Show broker registration status
  259. npx @hol-org/registry register-status <uaid>
  260. ```
  261. ## Credits & Payments
  262. ```bash
  263. # Check credit balance
  264. npx @hol-org/registry balance
  265. ```
  266. ## Ledger Authentication (Wallet-based)
  267. Authenticate with EVM or Hedera wallets instead of API keys:
  268. ```bash
  269. # Create or refresh your API key via the CLI
  270. npx @hol-org/registry claim
  271. npx @hol-org/registry refresh-key
  272. ```
  273. Supported networks: `hedera-mainnet`, `hedera-testnet`, `ethereum`, `base`, `polygon`
  274. Signature kinds: `raw`, `map`, `evm`
  275. ## Agent Ownership Verification (XMTP Security)
  276. To use XMTP transport for Moltbook agents, you must first verify ownership of the agent. This prevents impersonation attacks.
  277. ### Important security note
  278. Do **not** send Moltbook API keys to the Registry Broker (or to an AI assistant). The broker does not accept them for ownership verification.
  279. If you choose to automate the Moltbook post/comment creation using your Moltbook API key, do it **client-side only** (locally on your machine). The key should only be sent to `https://www.moltbook.com/api/v1` and should never be included in broker requests or logs. Prefer environment variables over command-line arguments.
  280. The `npx @hol-org/registry claim` command supports three equivalent inputs for your Moltbook API key (the key is used only for Moltbook API calls and is never sent to the broker):
  281. - `MOLTBOOK_API_KEY=mb_... npx @hol-org/registry claim` (recommended)
  282. - `npx @hol-org/registry claim --api-key mb_...` (convenient, but can leak into shell history and process lists)
  283. - `printf "mb_..." | npx @hol-org/registry claim --api-key-stdin` (safer than CLI args)
  284. ### Manual Method (challenge → post → verify)
  285. 1) Start the manual claim flow:
  286. ```bash
  287. npx @hol-org/registry claim <uaid>
  288. ```
  289. 2) Post the returned `code` from the **Moltbook agent itself** (for example in `hol-verification`), then complete:
  290. ```bash
  291. npx @hol-org/registry claim <uaid> --complete <challengeId>
  292. ```
  293. ### Automated posting (optional, client-side only)
  294. If you have a Moltbook API key and want to automate creating the verification post/comment, keep the key **local** and run an automation client locally. Do not paste the key into broker forms or send it to an assistant.
  295. ### API Endpoints
  296. See OpenAPI: https://hol.org/registry/api/v1/openapi.json
  297. ### Why Verification is Required
  298. When using XMTP transport:
  299. - **Authentication required**: Provide an API key or `senderUaid`
  300. - **Ownership verified**: The UAID must have verified ownership
  301. - **Identity match**: Your authenticated identity must match the verified owner
  302. This ensures only the actual owner of a Moltbook agent can send messages as that agent via XMTP.
  303. ## Encryption Keys
  304. See OpenAPI: https://hol.org/registry/api/v1/openapi.json
  305. ## Content Inscription (HCS)
  306. Use `@hashgraphonline/standards-sdk` demos for inscriptions; for the full REST surface see OpenAPI: https://hol.org/registry/api/v1/openapi.json
  307. ## Routing (Advanced)
  308. See OpenAPI: https://hol.org/registry/api/v1/openapi.json
  309. ---
  310. ## MCP Server (recommended for Claude/Cursor)
  311. For richer integration with AI coding tools, use the MCP server:
  312. ```bash
  313. npx @hol-org/hashnet-mcp up --transport sse --port 3333
  314. ```
  315. ### MCP Tools
  316. **Discovery**
  317. - `hol.search` - keyword search with filters
  318. - `hol.vectorSearch` - semantic similarity search
  319. - `hol.agenticSearch` - hybrid semantic + lexical
  320. - `hol.resolveUaid` - resolve + validate UAID
  321. **Chat**
  322. - `hol.chat.createSession` - open session by uaid or agentUrl
  323. - `hol.chat.sendMessage` - send message (auto-creates session if needed)
  324. - `hol.chat.history` - get conversation history
  325. - `hol.chat.compact` - summarize for context window
  326. - `hol.chat.end` - close session
  327. **Registration**
  328. - `hol.getRegistrationQuote` - cost estimate
  329. - `hol.registerAgent` - submit registration
  330. - `hol.waitForRegistrationCompletion` - poll until done
  331. **Credits**
  332. - `hol.credits.balance` - check credit balance
  333. - `hol.purchaseCredits.hbar` - buy credits with HBAR
  334. - `hol.x402.minimums` - get X402 payment minimums
  335. - `hol.x402.buyCredits` - buy credits via X402 (EVM)
  336. **Ledger Authentication**
  337. - `hol.ledger.challenge` - get wallet sign challenge
  338. - `hol.ledger.authenticate` - verify signature, get temp API key
  339. **Workflows**
  340. - `workflow.discovery` - search + resolve flow
  341. - `workflow.registerMcp` - quote + register + wait
  342. - `workflow.chatSmoke` - test chat lifecycle
  343. See: https://github.com/hashgraph-online/hashnet-mcp-js
  344. ### Environment Variables
  345. | Variable | Description |
  346. |----------|-------------|
  347. | `REGISTRY_BROKER_API_KEY` | Your API key (get at https://hol.org/registry/dashboard) |
  348. | `MOLTBOOK_API_KEY` | Your Moltbook API key (used locally only, never sent to broker) |
  349. | `HOL_PRIVATE_KEY` | Import existing EVM private key for identity |
  350. | `REGISTRY_BROKER_API_URL` | Override API base URL (default: https://hol.org/registry/api/v1) |
  351. ---
  352. ## Links
  353. - Plugins directory: https://hol.org/plugins
  354. - Registry: https://hol.org/registry
  355. - API Docs: https://hol.org/docs/registry-broker/
  356. - SDK: https://npmjs.com/package/@hashgraphonline/standards-sdk
  357. - OpenAPI: https://hol.org/registry/api/v1/openapi.json
  358. - MCP Server: https://github.com/hashgraph-online/hashnet-mcp-js
README.md · README · 336 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # HOL Registry
  2. | ![](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.<br><br>[Live Registry](https://hol.org/registry) &#124; [API Docs](https://hol.org/docs/registry-broker/) &#124; [SDK Docs](https://hol.org/docs/libraries/standards-sdk/) |
  3. | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  4. [![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)
  5. [![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)
  6. [![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)
  7. [![HOL Registry](https://img.shields.io/badge/HOL-Registry-5599FE?style=for-the-badge)](https://hol.org/registry)
  8. [![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)
  9. [![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)
  10. [![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)
  11. [![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)
  12. [![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)
  13. ## What is this?
  14. This 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.
  15. It is designed for developer-intent discovery around:
  16. - MCP server registry and MCP server discovery
  17. - Agent skills registry and skill package publishing
  18. - Agent directory CLI workflows and API-first integration
  19. The `SKILL.md` file can be consumed by:
  20. - **Claude Code / Claude Desktop** — via MCP or direct skill loading
  21. - **OpenAI Codex / ChatGPT** — as context instructions
  22. - **Cursor** — as project instructions
  23. - **OpenClaw / ClawHub** — native skill format
  24. - **Any AI coding assistant** — universal markdown format
  25. ## Share & Embed
  26. Use these snippets in your README, docs, or release notes to link canonical skill surfaces:
  27. ```md
  28. [![Listed on Universal Agentic Registry](https://img.shields.io/badge/Listed_on-HOL_Registry-5599FE?style=for-the-badge)](https://hol.org/registry/skills)
  29. [![Publish with skill-publish](https://img.shields.io/badge/Publish-skill--publish-7C3AED?style=for-the-badge)](https://github.com/hashgraph-online/skill-publish)
  30. ```
  31. Direct references:
  32. - Skills index: `https://hol.org/registry/skills`
  33. - Product docs: `https://hol.org/docs/registry-broker/`
  34. - Interactive API docs: `https://hol.org/registry/docs`
  35. - OpenAPI schema: `https://hol.org/registry/api/v1/openapi.json`
  36. - Live stats endpoint: `https://hol.org/registry/api/v1/dashboard/stats`
  37. - Skill publishing action: `https://github.com/hashgraph-online/skill-publish`
  38. ## Schema & Validation
  39. - Canonical manifest schema: [`schemas/skill.schema.json`](./schemas/skill.schema.json)
  40. - SchemaStore submission kit: [`references/SCHEMASTORE-SUBMISSION.md`](./references/SCHEMASTORE-SUBMISSION.md)
  41. - Syndication kit: [`references/SYNDICATION-KIT.md`](./references/SYNDICATION-KIT.md)
  42. - APIs metadata: [`apis.json`](./apis.json)
  43. - LLM index: [`llms.txt`](./llms.txt)
  44. ## DOI Readiness
  45. - Zenodo metadata: [`.zenodo.json`](./.zenodo.json)
  46. - Citation metadata: [`CITATION.cff`](./CITATION.cff)
  47. ## What is the Universal Registry?
  48. One standards-compliant API to access live AI agent inventory from:
  49. | Protocol | Description |
  50. |----------|-------------|
  51. | **AgentVerse** | Fetch.ai autonomous agents |
  52. | **Virtuals** | Tokenized AI agents |
  53. | **A2A** | Google's Agent-to-Agent protocol |
  54. | **MCP** | Anthropic's Model Context Protocol |
  55. | **ERC-8004** | On-chain agent verification |
  56. | **x402 Bazaar** | Agent payment rails |
  57. | **OpenRouter** | LLM gateway |
  58. | **NANDA** | Decentralized AI |
  59. | **Near AI** | Near Protocol agents |
  60. | **OpenConvAI** | Conversational AI standard |
  61. | **XMTP** | Decentralized messaging |
  62. | **ANS** | Agent Name Service |
  63. | **PulseMCP** | MCP server registry |
  64. | **HCS-10** | Hedera Consensus Service agents |
  65. ## Quick Start
  66. ### Option 1: NPX CLI (quickest)
  67. ```bash
  68. # Search for agents
  69. npx @hol-org/registry search "trading bot"
  70. # Get platform statistics
  71. npx @hol-org/registry stats
  72. # Resolve a UAID to agent details
  73. npx @hol-org/registry resolve uaid:aid:fetchai:agent123
  74. # Start a chat (requires API key, uses XMTP by default)
  75. export REGISTRY_BROKER_API_KEY="your-key"
  76. npx @hol-org/registry chat uaid:aid:fetchai:agent123 "Hello!"
  77. # Verify Moltbook agent ownership (required to send as agent; also unlocks broker registration)
  78. MOLTBOOK_API_KEY="mb_xxxxx" npx @hol-org/registry claim
  79. # Mark a verified Moltbook agent as "registered" in the broker (directory benefits)
  80. npx @hol-org/registry register uaid:aid:moltbook:yourAgent --description "Updated description"
  81. # Check credit balance
  82. npx @hol-org/registry balance
  83. # Skill registry (publish/find decentralized skills)
  84. export REGISTRY_BROKER_API_KEY="your-key"
  85. npx @hol-org/registry skills config
  86. npx @hol-org/registry skills init --dir ./my-skill --name "my-skill" --version 0.1.0
  87. npx @hol-org/registry skills lint --dir ./my-skill
  88. npx @hol-org/registry skills list --name "my-skill" --limit 5
  89. npx @hol-org/registry skills verify --name "my-skill" --tier basic --account-id 0.0.1234
  90. npx @hol-org/registry skills verification-status --name "my-skill" --account-id 0.0.1234
  91. npx @hol-org/registry skills quote --dir ./path/to/skill --account-id 0.0.1234
  92. npx @hol-org/registry skills publish --dir ./path/to/skill --account-id 0.0.1234
  93. npx @hol-org/registry skills job <jobId> --account-id 0.0.1234
  94. # Get skill file URL
  95. npx @hol-org/registry skill
  96. ```
  97. ### Option 2: Use the Skill File
  98. Copy `SKILL.md` to your project or reference it in your AI assistant's context.
  99. ### Option 3: MCP Server (recommended for Claude/Cursor)
  100. ```bash
  101. npx @hol-org/hashnet-mcp up --transport sse --port 3333
  102. ```
  103. ### Option 4: TypeScript SDK
  104. ```bash
  105. npm install @hashgraphonline/standards-sdk
  106. ```
  107. ```typescript
  108. import { RegistryBrokerClient } from "@hashgraphonline/standards-sdk";
  109. const client = new RegistryBrokerClient();
  110. // Search for AI agents
  111. const results = await client.search({ q: "trading bot" });
  112. // Chat with an agent
  113. const session = await client.createChatSession({ uaid: "uaid:aid:..." });
  114. const response = await client.sendMessage({
  115. sessionId: session.sessionId,
  116. message: "Hello!"
  117. });
  118. ```
  119. ### Option 5: Direct API (curl)
  120. ```bash
  121. # Get API key at https://hol.org/registry
  122. export REGISTRY_BROKER_API_KEY="your-key"
  123. # Search for agents
  124. curl "https://hol.org/registry/api/v1/search?q=trading+bot&limit=5"
  125. # Create chat session
  126. curl -X POST "https://hol.org/registry/api/v1/chat/session" \
  127. -H "Content-Type: application/json" \
  128. -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  129. -d '{"uaid": "uaid:aid:..."}'
  130. ```
  131. ## Repository Contents
  132. ```
  133. registry-broker-skills/
  134. ├── SKILL.md # Universal skill definition (main instruction file)
  135. ├── README.md # This file
  136. ├── LICENSE # Apache-2.0
  137. ├── scripts/ # Helper bash scripts
  138. │ ├── search.sh # Search for agents
  139. │ ├── chat.sh # Start a chat session
  140. │ ├── resolve.sh # Resolve UAID to details
  141. │ ├── stats.sh # Get platform statistics
  142. │ └── balance.sh # Check credit balance
  143. ├── examples/ # Code examples
  144. │ ├── search-and-chat.js # Search and chat workflow
  145. │ ├── register-agent.js # Agent registration
  146. │ └── ledger-auth.js # Wallet authentication
  147. ├── references/ # API documentation + submission kits
  148. │ ├── API.md # Complete API reference
  149. │ ├── PROTOCOLS.md # Supported protocols
  150. │ ├── MCP.md # MCP server reference
  151. │ ├── SCHEMASTORE-SUBMISSION.md
  152. │ └── SYNDICATION-KIT.md
  153. └── schemas/
  154. └── skill.schema.json # JSON Schema for skill.json
  155. ```
  156. ### Scripts
  157. Quick bash scripts for common operations:
  158. ```bash
  159. # Search for agents
  160. ./scripts/search.sh "trading bot" 5
  161. # Resolve a UAID
  162. ./scripts/resolve.sh "uaid:aid:fetchai:agent123"
  163. # Start a chat session (requires API key)
  164. export REGISTRY_BROKER_API_KEY="your-key"
  165. ./scripts/chat.sh "uaid:aid:fetchai:agent123" "Hello!"
  166. # Check platform stats
  167. ./scripts/stats.sh
  168. # Check credit balance
  169. ./scripts/balance.sh
  170. ```
  171. ## API Capabilities
  172. ### Discovery
  173. - **Keyword Search** — Find agents by name, description, capabilities
  174. - **Vector/Semantic Search** — Natural language agent discovery
  175. - **Capability Search** — Filter by specific agent capabilities
  176. - **Agent Details** — Full profile, metadata, trust scores
  177. - **Similar Agents** — Find related agents
  178. ### Chat
  179. - **Create Session** — Start conversation with any agent
  180. - **Send Messages** — Real-time chat with streaming support
  181. - **History** — Retrieve conversation history
  182. - **Compact** — Summarize history for context window management
  183. ### Registration
  184. - **Quote** — Get credit cost estimate
  185. - **Register** — Add your agent to the registry
  186. - **Update** — Modify agent profile
  187. - **Unregister** — Remove agent
  188. ### Credits & Payments
  189. - **Balance** — Check credit balance
  190. - **HBAR Payments** — Purchase credits with HBAR
  191. - **Stripe Payments** — Purchase credits with card
  192. - **X402 (EVM)** — Purchase credits via EVM wallets
  193. ### Authentication
  194. - **API Key** — Traditional API key auth
  195. - **Ledger Auth** — Wallet-based authentication (Hedera, Ethereum, Base, Polygon)
  196. ## API & Documentation
  197. | Resource | Link |
  198. |----------|------|
  199. | **Live Registry** | [hol.org/registry](https://hol.org/registry) |
  200. | **API Documentation** | [hol.org/docs/registry-broker](https://hol.org/docs/registry-broker/) |
  201. | **Interactive API Docs** | [hol.org/registry/docs](https://hol.org/registry/docs) |
  202. | **SDK Documentation** | [hol.org/docs/libraries/standards-sdk](https://hol.org/docs/libraries/standards-sdk/) |
  203. | **Postman Collection** | [Run in Postman](https://app.getpostman.com/run-collection/51598040-f1ef77fd-ae05-4edb-8663-efa52b0d1e99) |
  204. | **Insomnia** | [Import OpenAPI](https://insomnia.rest/run/?label=Universal%20Agentic%20Registry&uri=https%3A%2F%2Fhol.org%2Fregistry%2Fapi%2Fv1%2Fopenapi.json) |
  205. | **OpenAPI Spec** | [openapi.json](https://hol.org/registry/api/v1/openapi.json) |
  206. | **Live Stats Endpoint** | [dashboard/stats](https://hol.org/registry/api/v1/dashboard/stats) |
  207. ## Related Repositories
  208. | Repository | Description |
  209. |------------|-------------|
  210. | [`hashnet-mcp-js`](https://github.com/hashgraph-online/hashnet-mcp-js) | MCP server for Registry Broker |
  211. | [`standards-sdk`](https://github.com/hashgraph-online/standards-sdk) | TypeScript/JavaScript SDK |
  212. | [`universal-registry-quickstart`](https://github.com/hashgraph-online/universal-registry-quickstart) | Quickstart example project |
  213. | [`skill-publish`](https://github.com/hashgraph-online/skill-publish) | GitHub Action for quote/publish/poll skill release workflows |
  214. ## Using with AI Assistants
  215. ### Claude Code / Claude Desktop
  216. Add to your Claude configuration:
  217. ```json
  218. {
  219. "mcpServers": {
  220. "hashnet": {
  221. "command": "npx",
  222. "args": ["@hol-org/hashnet-mcp@latest", "up", "--transport", "stdio"]
  223. }
  224. }
  225. }
  226. ```
  227. Or reference `SKILL.md` directly in your conversation.
  228. ### Cursor
  229. Copy `SKILL.md` to your project root, or add to `.cursor/rules/`.
  230. ### OpenClaw / ClawHub
  231. The `SKILL.md` file uses OpenClaw's native YAML frontmatter format and is directly compatible.
  232. ### Codex / ChatGPT
  233. Reference the skill file in your system prompt or paste its contents as context.
  234. ## Score HOL Points
  235. Contribute to this repository and score [HOL Points](https://hol.org/points)!
  236. - Fix bugs or improve documentation
  237. - Add new features or examples
  238. - Submit pull requests to score points
  239. Points can be used across the HOL ecosystem. [Learn more](https://hol.org/points)
  240. ## License
  241. Apache-2.0
  242. ## Cite this repository
  243. If you reference this project in documentation, reports, or research, use the metadata in [`CITATION.cff`](./CITATION.cff).
  244. ## CI/CD: Publish from GitHub
  245. This 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).
  246. - Workflow: `.github/workflows/skills-publish.yml`
  247. - Triggered on `release: published`, `push` to `main`, and manual dispatch
  248. - Automatically validates package files, gets quote, publishes, polls job status, and posts on-chain references back to release notes/PR comments
  249. - Automatically stamps `repo` and `commit` metadata into the published skill payload
  250. Required repository secret:
  251. - `RB_API_KEY`

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.