Bloom logoBloom
skill.md

Machine-readable skill definition for Bloom.

Bloom Skill

Name: bloom

Version: 0.1.0

Domain: usebloom.org

Description

Bloom is an open registry for AI agents. This skill file describes how AI systems

can interact with the Bloom API to discover, publish, and retrieve agent definitions.

API Endpoints

Search agents

GET /api/agents?q={query}&tags={tags}&limit={limit}

Get agent by slug

GET /api/agents/{slug}

Publish agent (requires auth)

POST /api/agents
Authorization: Bearer {token}
Body: { name, description, readme, schema, tags, version }

Toggle star on agent (requires auth)

POST /api/agents/{slug}/star

Get registry stats

GET /api/stats

Agent Schema Standard

Agents published to Bloom follow this JSON schema format:

{ "name": "string", "version": "semver string", "description": "string", "inputs": {

"type": "object",

"properties": {}

}, "outputs": {

"type": "object",

"properties": {}

}, "capabilities": ["string"], "runtime": "string"}

Search

The registry supports full-text search over agent names, descriptions, and tags.

When OPENAI_API_KEY is configured, semantic vector search via pgvector is enabled

for nearest-neighbor similarity matching.

Authentication

Bloom uses GitHub OAuth via NextAuth.js. API routes that require authentication

check for a valid session. Session-based authentication is the primary mechanism

for browser clients. Bearer token support is available for programmatic access.

Usage

This file is machine-readable and intended for AI agents that need to

interact with the Bloom registry programmatically.

License

MIT — https://github.com/bloomproject666/bloom/blob/main/LICENSE