Share agents and caps

Learn how to share useful caps, or publish a tuned agent that others can run with a single command.

Share caps

Toolang currently supports GitHub as the registry for shared caps.

Standard GitHub layout

Use the standard GitHub layout when you want users to add caps with short refs like briceyan/reviewer.

A recommended repository layout is:

agents/
├── skills/
│   └── reviewer/
│       └── SKILL.md
├── services/
│   └── github.md
├── psyches/
│   └── concise.md
└── prompts/
    └── summarize.md

With this layout, users can add caps by owner and name:

toolang alice skill add briceyan/reviewer
toolang alice service add briceyan/github
toolang alice psyche add briceyan/concise
toolang alice prompt add briceyan/summarize

Skills are directory-based and should contain a SKILL.md file. Psyches, services, and prompts are file-based Markdown files.

Custom GitHub layout

You do not have to follow the standard layout. If your caps live in a custom repository or path, users can add them with full GitHub URLs:

toolang alice skill add https://github.com/briceyan/my-caps/tree/main/skills/reviewer
toolang alice service add https://github.com/briceyan/my-caps/blob/main/services/github.md

Short refs are easier to share, but full URLs work with custom layouts.

Share agents

Toolang currently supports GitHub as the registry for shared agents. Agents can also be shared as direct URLs to .too files.

Standard GitHub layout

Use the standard GitHub layout when you want users to clone agents with short refs like briceyan/dev.

A recommended repository layout is:

agents/
├── dev.too
├── reviewer.too
└── researcher.too

With this layout, users can clone an agent by owner and name:

toolang clone briceyan/dev alice

This creates a local agent named alice from the shared agent.

Custom GitHub layout

If your agent files live in a custom repository or path, users can run or clone them with full GitHub URLs:

toolang run https://github.com/briceyan/my-agents/blob/main/examples/dev.too
toolang clone https://github.com/briceyan/my-agents/blob/main/examples/dev.too alice

Direct URLs

You can also publish agents as plain .too files anywhere with a public HTTP URL, such as a product site, docs site, personal website, or cloud storage.

Users can run a URL directly, or clone it into a local agent:

toolang run https://toolang.ai/dev.too
toolang clone https://toolang.ai/dev.too alice

Direct URLs work well for quick sharing and standalone agent files. Use GitHub when you need version history or also want to publish caps.

Ref resolution

For detailed shorthand, registry, and URL resolution rules, see Ref resolution.