Workjet
Back to Workjet

Publishing Skills

Publishing a skill to the Marketplace makes it available to all Workjet users. This guide walks through the publishing process, from creating a skill to making it publicly available.

Publishing Workflow

The publishing process has four steps:

Step 1: Create the Skill

Start by creating a skill in the desktop app:

  1. Open the Skills section from the sidebar
  2. Click New Skill
  3. Write a clear name and description
  4. Author the system prompt that defines the skill's behavior
  5. Select the required model tier and tools
  6. Click Save

Step 2: Add a Version

Each skill can have multiple versions. Before publishing, make sure your skill has at least one version:

  • New skills start as v1 automatically
  • When you update a skill's system prompt or configuration, a new version is created (v2, v3, etc.)
  • Versions are immutable — once created, a version cannot be changed
  • The latest version is what gets installed by other users

Versioning: Skill versions use auto-incrementing numbers (v1, v2, v3...). Each version captures the complete skill configuration at that point in time. Users who install your skill get the latest version, and their copy is independent of future updates.

Step 3: Set Visibility to Public

Change the skill's visibility from Team or Private to Public:

  1. Open the skill detail view
  2. Click the Visibility dropdown
  3. Select Public
  4. Review the skill description (this is what Marketplace users will see)

Step 4: Publish

  1. Click the Publish button
  2. Confirm that you want to make the skill available on the Marketplace
  3. The skill appears on the Marketplace immediately

Best Practices for Publishing

  • Clear description: Write a description that explains what the skill does, when to use it, and what input it expects
  • Specific system prompt: A well-crafted system prompt produces consistent, high-quality results
  • Minimal tool requirements: Only require tools that are essential for the skill to function
  • Test thoroughly: Run the skill multiple times with different inputs before publishing
  • Choose the right model tier: Use Standard tier when possible to make the skill accessible to more users

Note: Published skills are visible to all Workjet users. Do not include proprietary information, internal data, or sensitive content in the system prompt or description.

Updating a Published Skill

When you update a published skill, a new version is created automatically. Users who previously installed the skill keep their existing version — they are not automatically updated. To get the latest version, users can reinstall the skill from the Marketplace.

Unpublishing a Skill

To remove a skill from the Marketplace, change its visibility back to Team or Private. The skill is removed from the Marketplace listing immediately. Users who have already installed it retain their copy.

Next Steps