oo-publish-skill

name

oo-publish-skill

description

Publish, release, upload, or submit an existing AI agent skill directory with SKILL.md to the OOMOL registry by running oo skills publish, or generate a share prompt for a published skill by running oo skills share, including temporary shares for private packages. Use when the user asks to publish a skill, share a published skill, make a skill available in the OOMOL skill catalog, release a registry skill package, resolve publish visibility, version, package-name, or overwrite prompts, or publish from a local, registry-installed, or path-based skill source. Do not use for finding, installing, creating, or editing skills unless the final goal is publication or sharing.

oo Publish Skill

Use this skill when the user wants to publish an existing agent skill to the OOMOL registry or skill catalog. The source can be any valid agent skill directory with a SKILL.md; it does not need to be an oo-specific skill.

Workflow

Share a published skill

If the user asks to share a published skill, run:

oo --lang zh skills share <skill-id> -y
oo --lang en skills share <skill-id> -y

Use the skill id from the current context when the user has just created, published, or used a specific skill. If no likely skill id is available, ask the user which skill or package to share. oo skills share will confirm the resolved id and package, then print the copyable share prompt. Public packages are shared directly. Private packages create a temporary share id and the prompt must use <packageName>#<shareID>. Private package shares support optional limits: --days <days> sets the share duration, defaults to 7, and cannot exceed 7; --downloads <downloads> limits install count; omitting --downloads leaves installs unlimited. Match the user's language when generating the prompt: use oo --lang zh skills share <skill-id> -y for Chinese users and oo --lang en skills share <skill-id> -y for English users. That prompt is meant for recipients to follow a language-specific general install preparation guide before running the final install command. It should include the package name, skill name when applicable, Hub URL, the general install preparation URL, and the exact oo skills install ... command. In the final response, put the complete recipient-facing share prompt in one copyable text code block. Do not use nested fenced code blocks inside it. Do not split the hub URL, guide URL, or install command outside the block.

1. Identify the publish source

Ask for the missing skill id or skill directory path only when needed:

• skill id or path to a skill directory

Publish accepts a concrete path:

oo skills publish <path-to-skill-directory-or-SKILL.md>

If the user gives only a skill id, oo skills locate <skill-id> --agent <!-- agentic:var agent --> can help resolve the local path. Use it when it is helpful, but do not force an extra locate step when the path is already clear from context.

The publish command performs its own environment, authentication, and account checks, so run it directly.

For first-time packages in non-interactive agent sessions, choose visibility before publishing and pass --visibility private or --visibility public. Use --visibility public when the user asks to publish to the public catalog or otherwise clearly wants a public package. Use --visibility private only when the user asks for a private package. If the user's intended visibility is unclear, ask before publishing. Existing packages can omit --visibility when the current registry visibility should be preserved.

Do not ask whether to publish to the current account. oo skills publish resolves the account and asks any necessary ownership questions itself.

2. Publish through oo

Run the publish command directly:

oo skills publish ./my-skill --visibility public
oo skills publish /path/to/my-skill/SKILL.md --visibility private
oo skills publish ./already-published-skill

If this shared skill file is running in another supported host, replace <!-- agentic:var agent --> with that host id from the supported list.

If the command prompts about publishing a registry-installed skill under the active account or overwriting an existing remote package, let that prompt drive the next user confirmation. Do not ask those questions in advance.

Do not package manually, do not use npm publish, and do not copy files into an arbitrary fallback directory.

3. Report the result

Report the published package name, version, visibility, and hub URL from the command output. Also mention any metadata writeback that occurred. If publish fails, do not retry blindly; summarize the failing command, the user-facing error, and the smallest next fix. If the failure says the self-hosted connector only supports connector commands, or the JSON error code is not_authenticated in self-hosted connector mode, publishing requires an OOMOL account: ask the user to run oo auth login, then stop.