Skip to content
Programmatic Resources

Publishing Guide

Publishing an Agent Workflow

1. Create a GitHub repository

Your repository needs these files in the root:

  • programmatic.json — Bundle metadata (name, id, format, description, tags)
  • SKILL.md — Documentation with YAML frontmatter
  • setup.yaml — Variable definitions and defaults
  • manifest.template.yaml — Agent manifest template

2. programmatic.json

{
  "name": "My Agent",
  "id": "my-agent",
  "version": "2026-03-01",
  "format": "robothor-native/v1",
  "department": "email",
  "description": "What this agent does",
  "tags": ["email", "classification"]
}

3. SKILL.md

Include YAML frontmatter at the top:

---
name: My Agent
version: "2026-03-01"
description: What this agent does
format: robothor-native/v1
department: email
---

# My Agent

Detailed documentation here...

4. Submit to the catalog

Via the web:

Go to /submit and enter your repository URL. The system validates the required files and adds your agent.

Via the CLI:

robothor agent publish https://github.com/your-org/your-agent

5. Create a GitHub Release

Tag a release so users can download a specific version:

git tag v1.0.0
git push --tags
gh release create v1.0.0 --generate-notes

The catalog automatically picks up new releases during sync.

6. Premium bundles

To sell your agent as a premium bundle, contact us after listing. Premium bundles are stored on S3 with presigned download URLs after purchase.