Skills

Skills are reusable prompt-and-tool chains that your team publishes and shares. Each skill bundles a system prompt, model preference, required tools, and example inputs into a one-click workflow anyone on the team can run. Think of skills as templates for AI tasks.

Skill Browser

The skill browser is accessible from the sidebar. It displays all skills available to you, organized by category. Each skill card shows:

  • Skill name and description
  • Category tag
  • Current version number
  • Required model tier
  • A Run button for one-click execution

Running a Skill

To run a skill:

  1. Open the skill browser from the sidebar
  2. Find the skill you want to use
  3. Click Run
  4. Provide any required input (the skill may prompt you for it)
  5. View the generated output

You can also invoke skills from the chat panel by typing /skill [name].

Skill-Enhanced Chat

When you invoke a skill from chat, the skill's system prompt and tool configuration are applied to the conversation. This transforms the general-purpose chat into a specialized assistant for the duration of that interaction. For example, activating the "Code Review" skill sets up the AI with code review-specific instructions and access to the GitHub connector.

Built-in Skills

Workjet includes ten built-in skills to get you started:

Skill Description
Summarize Document Generate a concise summary of any attached document with key points and takeaways
Draft Email Response Draft a professional email reply given the original message and your intent
Code Review Review code for bugs, style issues, performance problems, and security concerns
Meeting Notes Transform raw meeting notes or transcripts into structured summaries with action items
Data Analysis Analyze CSV or JSON data sets to find trends, outliers, and key statistics
Competitive Research Research and compare competitors based on provided criteria
Bug Report Writer Generate structured bug reports from informal descriptions
Contract Reviewer Review contracts and highlight key terms, risks, and obligations
Social Media Post Create engaging social media content for various platforms
SQL Query Builder Generate SQL queries from natural language descriptions

Creating a Custom Skill

To create your own skill:

  1. Open the Skills section from the sidebar
  2. Click New Skill
  3. Fill in the details:
    • Name: A clear, descriptive name
    • Description: What the skill does and when to use it
    • Category: The skill's category (e.g., productivity, development)
    • System prompt: The AI instructions that define the skill's behavior
    • Model tier: Standard, premium, or enterprise
    • Required tools: Which MCP connectors the skill needs
  4. Click Save

Skill Versioning

Skills use immutable versioning with auto-incrementing version numbers (v1, v2, v3...). When you update a skill's system prompt or configuration, a new version is created. Previous versions are preserved and can be referenced. This ensures that:

  • Changes don't break existing workflows that depend on a specific version
  • You can roll back to a previous version if needed
  • Version history provides an audit trail of skill evolution

Publishing and Sharing

Skills have three visibility levels:

  • Private: Only visible to the creator
  • Team: Visible to everyone in your organization
  • Public: Listed on the Marketplace for all Workjet users

To publish a skill to the marketplace, set its visibility to "Public" and click Publish. See Marketplace for details.

Import and Export

Skills can be imported from and exported to markdown (.md) files. This makes it easy to share skills outside of Workjet or back them up to version control.

Importing

Click Import in the skill browser and select a .md file. The file should contain the skill name, description, and system prompt in markdown format. Workjet parses the file and creates a new skill from its contents.

Exporting

Click Export All to download all your skills as a single markdown file. Each skill is separated by a heading and includes the name, description, system prompt, and configuration metadata.

Tip: Use export/import to share skill libraries across teams or to maintain skills in a Git repository alongside your code.

Next Steps