Skip to main content

Publishing

Publish via API​

Publish a skill using the extension service REST API:

POST /api/extension/publish

With the skill's folder path and type skill in the request body.

Install from marketplace​

Users can install published skills from the Codebolt marketplace in two ways:

From the UI: Open the Capability Panel's Marketplace tab or go to Settings → Marketplace to browse, search, and install skills directly. See The Marketplace for details.

Via API:

POST /api/capability/download

Downloaded skills are extracted as zip archives into the project's .codebolt/capabilities/skill/ directory and picked up on the next registry refresh.

Standalone vs. bundled​

Publish standalone if the skill is useful on its own. If it only makes sense together with prompts, tools, and conventions, ship it inside a capability.

Common mistakes​

  • A skill that is really just one tool call — use a tool instead
  • A skill so broad it becomes a second system prompt — break it down
  • Unstructured outputs where downstream callers need fields — define typed outputs in capability.yaml
  • Missing type: skill in capability.yaml — the registry uses directory structure to infer type, but being explicit avoids confusion