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.
Ask AI about Registry Broker Skills
Powered by Claude Β· Grounded in docs
I know everything about Registry Broker Skills. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
HOL Registry
![]() | 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 | API Docs | SDK Docs |
|---|
What is this?
This repository contains skill definitions for the Universal Agentic 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.
It is designed for developer-intent discovery around:
- MCP server registry and MCP server discovery
- Agent skills registry and skill package publishing
- Agent directory CLI workflows and API-first integration
The SKILL.md file can be consumed by:
- Claude Code / Claude Desktop β via MCP or direct skill loading
- OpenAI Codex / ChatGPT β as context instructions
- Cursor β as project instructions
- OpenClaw / ClawHub β native skill format
- Any AI coding assistant β universal markdown format
Share & Embed
Use these snippets in your README, docs, or release notes to link canonical skill surfaces:
[](https://hol.org/registry/skills)
[](https://github.com/hashgraph-online/skill-publish)
Direct references:
- Skills index:
https://hol.org/registry/skills - Product docs:
https://hol.org/docs/registry-broker/ - Interactive API docs:
https://hol.org/registry/docs - OpenAPI schema:
https://hol.org/registry/api/v1/openapi.json - Live stats endpoint:
https://hol.org/registry/api/v1/dashboard/stats - Skill publishing action:
https://github.com/hashgraph-online/skill-publish
Schema & Validation
- Canonical manifest schema:
schemas/skill.schema.json - SchemaStore submission kit:
references/SCHEMASTORE-SUBMISSION.md - Syndication kit:
references/SYNDICATION-KIT.md - APIs metadata:
apis.json - LLM index:
llms.txt
DOI Readiness
- Zenodo metadata:
.zenodo.json - Citation metadata:
CITATION.cff
What is the Universal Registry?
One standards-compliant API to access live AI agent inventory from:
| Protocol | Description |
|---|---|
| AgentVerse | Fetch.ai autonomous agents |
| Virtuals | Tokenized AI agents |
| A2A | Google's Agent-to-Agent protocol |
| MCP | Anthropic's Model Context Protocol |
| ERC-8004 | On-chain agent verification |
| x402 Bazaar | Agent payment rails |
| OpenRouter | LLM gateway |
| NANDA | Decentralized AI |
| Near AI | Near Protocol agents |
| OpenConvAI | Conversational AI standard |
| XMTP | Decentralized messaging |
| ANS | Agent Name Service |
| PulseMCP | MCP server registry |
| HCS-10 | Hedera Consensus Service agents |
Quick Start
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:..."}'
Repository Contents
registry-broker-skills/
βββ SKILL.md # Universal skill definition (main instruction file)
βββ README.md # This file
βββ LICENSE # Apache-2.0
βββ scripts/ # Helper bash scripts
β βββ search.sh # Search for agents
β βββ chat.sh # Start a chat session
β βββ resolve.sh # Resolve UAID to details
β βββ stats.sh # Get platform statistics
β βββ balance.sh # Check credit balance
βββ examples/ # Code examples
β βββ search-and-chat.js # Search and chat workflow
β βββ register-agent.js # Agent registration
β βββ ledger-auth.js # Wallet authentication
βββ references/ # API documentation + submission kits
β βββ API.md # Complete API reference
β βββ PROTOCOLS.md # Supported protocols
β βββ MCP.md # MCP server reference
β βββ SCHEMASTORE-SUBMISSION.md
β βββ SYNDICATION-KIT.md
βββ schemas/
βββ skill.schema.json # JSON Schema for skill.json
Scripts
Quick bash scripts for common operations:
# Search for agents
./scripts/search.sh "trading bot" 5
# Resolve a UAID
./scripts/resolve.sh "uaid:aid:fetchai:agent123"
# Start a chat session (requires API key)
export REGISTRY_BROKER_API_KEY="your-key"
./scripts/chat.sh "uaid:aid:fetchai:agent123" "Hello!"
# Check platform stats
./scripts/stats.sh
# Check credit balance
./scripts/balance.sh
API Capabilities
Discovery
- Keyword Search β Find agents by name, description, capabilities
- Vector/Semantic Search β Natural language agent discovery
- Capability Search β Filter by specific agent capabilities
- Agent Details β Full profile, metadata, trust scores
- Similar Agents β Find related agents
Chat
- Create Session β Start conversation with any agent
- Send Messages β Real-time chat with streaming support
- History β Retrieve conversation history
- Compact β Summarize history for context window management
Registration
- Quote β Get credit cost estimate
- Register β Add your agent to the registry
- Update β Modify agent profile
- Unregister β Remove agent
Credits & Payments
- Balance β Check credit balance
- HBAR Payments β Purchase credits with HBAR
- Stripe Payments β Purchase credits with card
- X402 (EVM) β Purchase credits via EVM wallets
Authentication
- API Key β Traditional API key auth
- Ledger Auth β Wallet-based authentication (Hedera, Ethereum, Base, Polygon)
API & Documentation
| Resource | Link |
|---|---|
| Live Registry | hol.org/registry |
| API Documentation | hol.org/docs/registry-broker |
| Interactive API Docs | hol.org/registry/docs |
| SDK Documentation | hol.org/docs/libraries/standards-sdk |
| Postman Collection | Run in Postman |
| Insomnia | Import OpenAPI |
| OpenAPI Spec | openapi.json |
| Live Stats Endpoint | dashboard/stats |
Related Repositories
| Repository | Description |
|---|---|
hashnet-mcp-js | MCP server for Registry Broker |
standards-sdk | TypeScript/JavaScript SDK |
universal-registry-quickstart | Quickstart example project |
skill-publish | GitHub Action for quote/publish/poll skill release workflows |
Using with AI Assistants
Claude Code / Claude Desktop
Add to your Claude configuration:
{
"mcpServers": {
"hashnet": {
"command": "npx",
"args": ["@hol-org/hashnet-mcp@latest", "up", "--transport", "stdio"]
}
}
}
Or reference SKILL.md directly in your conversation.
Cursor
Copy SKILL.md to your project root, or add to .cursor/rules/.
OpenClaw / ClawHub
The SKILL.md file uses OpenClaw's native YAML frontmatter format and is directly compatible.
Codex / ChatGPT
Reference the skill file in your system prompt or paste its contents as context.
Score HOL Points
Contribute to this repository and score HOL Points!
- Fix bugs or improve documentation
- Add new features or examples
- Submit pull requests to score points
Points can be used across the HOL ecosystem. Learn more
License
Apache-2.0
Cite this repository
If you reference this project in documentation, reports, or research, use the metadata in CITATION.cff.
CI/CD: Publish from GitHub
This repository supports one-step HCS-26 publishing from GitHub using the first-party action hashgraph-online/skill-publish@v1.
- Workflow:
.github/workflows/skills-publish.yml - Triggered on
release: published,pushtomain, and manual dispatch - Automatically validates package files, gets quote, publishes, polls job status, and posts on-chain references back to release notes/PR comments
- Automatically stamps
repoandcommitmetadata into the published skill payload
Required repository secret:
RB_API_KEY

