Create a website, app, agent, or skill
create_serviceCreate an empty website, app, agent, or skill in an organization, before publishing to it. This is the first step for anything new: publish_site, publish_app, publish_agent, and publish_skill change a service that exists and refuse a name that does not. The one exception is a skill under a well-known name, such as governance or design-system: publish_skill with files or edits makes the organization's first copy without this. Pass kind to say which you mean, and name to choose its name; omit name to have one generated, except for a skill, which needs one with no two hyphens in a row. A name another website, app, agent, or skill in the organization holds is refused, as is a create past the organization's limit for that kind. A new website is private: only members of the organization can open it until set_service_access changes that. The result names the kind and name, and the URL when it has one; publish to the name next. An agent has a URL only in an organization with agent URLs turned on.
A skill is know-how the organization shares with every member's agent: use kind skill, then publish_skill, when the user wants to share a skill with their team on Valet, such as one they keep locally. Its repository starts from a starter SKILL.md, or, for a well-known name such as governance or design-system, from Valet's default, which the organization's skill then replaces. Nothing reaches an agent until it is published. A skill is private at its URL: only members of the organization can open it. With catalog, it instead installs that skill from Valet's curated catalog under name, as the organization's own copy published as its first version. An organization that installed it before gets that copy back, whatever its name, and nothing is installed; the result then names the catalog skill and its version, and reused when the copy existed. Requires connecting a Valet account.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"kind": "<kind>"
},
"name": "create_service"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | What to create. A site is a static website, an app is a Procfile app, an agent answers on channels, and a skill is a document agents read. | |
| name | No | The service's name. For a site, app, or skill it is the first label of its URL. Omit to have one generated. | |
| catalog | No | For a skill only: the name of a catalog skill to install under name, such as premortem. Omit to create an empty skill. | |
| org_name | No | The Valet organization to create it in. Omit to use the organization the account joined first. | |
| idempotency_key | No | An opaque key of your choosing. Repeating a call with the same key returns the first call's result instead of creating a second service, which makes a retry safe. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| org | Yes | Name of the Valet organization the call acted in. | |
| url | No | Address the service is served at. Absent when it has none, for an agent in an organization whose agent URLs are not turned on, and for a skill whose route is not minted yet. | |
| kind | Yes | What was created: site, app, agent, or skill. | |
| name | Yes | Name of the new service. When a catalog install found the organization's existing copy, the name of that copy, which may differ from the name passed. Pass it as name to the publish tools. | |
| reused | No | True when the organization already had its copy of the catalog skill, which name identifies, so nothing was installed. Absent otherwise. | |
| catalog | No | Name of the catalog skill the call installed. Absent when the call created an empty service. | |
| version | No | Latest version of the organization's copy of the catalog skill. Absent for other creates, and when the version could not be read. | |
| seeded_default | No | True when the new skill's name is a built-in's, so its repository starts from Valet's default skill instead of a starter SKILL.md. Absent otherwise. |