Ref resolution

Toolang accepts short refs and URLs when you add shared caps or run shared agents.

Short refs

Short refs use this shape:

owner/name

Toolang resolves the ref based on the command kind.

Command	Example	Standard GitHub target
`skill add`	`briceyan/reviewer`	`briceyan/agents/skills/reviewer/SKILL.md`
`service add`	`briceyan/github`	`briceyan/agents/services/github.md`
`psyche add`	`briceyan/concise`	`briceyan/agents/psyches/concise.md`
`prompt add`	`briceyan/summarize`	`briceyan/agents/prompts/summarize.md`
`clone`	`briceyan/dev`	`briceyan/agents/dev.too`

For example:

toolang alice skill add briceyan/reviewer
toolang clone briceyan/dev alice

GitHub URLs

Use a GitHub URL when the shared file or directory does not use the standard layout.

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
toolang clone https://github.com/briceyan/my-agents/blob/main/examples/dev.too alice

Skill URLs can point to a directory that contains SKILL.md. Service, psyche, prompt, and agent URLs usually point to a single file.

Direct URLs

Agent commands can also use direct HTTP URLs that point to .too files:

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

Direct URLs are useful when the agent is published outside GitHub.