Skip to main content

Creating and Uploading Custom Skills in TeamAI

This article guides you through the process of developing and deploying custom skills within TeamAI.

Written by TeamAI
Updated today

Custom skills enable you to automate specific tasks, ensuring consistent outputs and enhancing efficiency by tailoring TeamAI's functionality to your unique requirements.

Learning Objectives:

  • Understand how to use the skill-creator to define a custom skill.

  • Learn to upload a .skill file to your TeamAI workspace.

  • Discover how to activate and use a custom skill in chat.

Prerequisites

You'll Need:

  • Active workspace membership.

  • Basic understanding of TeamAI's chat interface.

  • Appropriate user permissions to upload skills to either a personal or shared workspace.

Defining a Custom Skill

This section outlines how to use the skill-creator skill to generate the definition for your custom skill.

Initiate Skill Creation with skill-creator

  1. Navigate to chat input: Access your TeamAI chat interface.

  2. Open Skills Menu: Type / (forward slash) in the chat input field.

  3. Select skill-creator: From the displayed skills menu, select the skill-creator option.

Define Skill Parameters

TeamAI's skill-creator will prompt you with a series of questions to establish the logic and parameters of your custom skill. Provide precise answers to:

  1. Identify Core Problem: Clearly state the specific task or problem the skill will address (e.g., "generate structured knowledge base articles").

  2. Determine Source Content: Specify the types of input the skill will process (e.g., "copy-pasted text," ".txt files").

  3. Specify Output Format: Define the desired format and structure of the skill's output (e.g., "plain text," "HTML," "sections with Title, Introduction, Steps").

  4. Outline Stylistic Requirements: Detail any specific writing style, tone, or formatting guidelines for the skill's output (e.g., "use specific prompt instructions," "apply headings").

Result: TeamAI will generate a comprehensive proposal detailing the structure and functionality of your new skill, including its component files such as SKILL.md, references/, assets/, and scripts/.

Finalize and Download Your Skill

  1. Review Proposal: Carefully review TeamAI's generated skill proposal.

  2. Confirm Creation: Confirm that you wish to proceed with creating the skill based on the proposal.

  3. Generate .skill File: TeamAI will process your definition and create a .skill file.

  4. Download Skill File: Download the generated .skill file to your local machine. This file encapsulates your custom skill's complete definition.

Deploying a Custom Skill

Once you have your .skill file, you can upload it to make it available within your TeamAI environment.

Upload Your .skill File

  1. Navigate to Skills Section: Locate the Skills option in the left panel of the TeamAI interface and click it.

  2. Initiate Upload: Click the Upload Skill button.

  3. Select Skill File and Location: In the dialog window that appears, you will:

    • Select the .skill file from your local machine.

    • Choose the target workspace: Select either a personal workspace or a shared workspace for deployment. The available options depend on your user permissions.

Result: The custom skill will be successfully uploaded and available within the selected workspace.

Utilizing a Custom Skill

After successful deployment, your custom skill is ready for use within any chat session in its designated workspace.

Activate Your Custom Skill

  1. Access Chat Interface: Go to any chat in the workspace where the skill was deployed.

  2. Open Skills Menu: Type / (forward slash) in the chat input field.

  3. Select Custom Skill: From the displayed skills menu, select your newly uploaded custom skill.

Result: The skill will activate, ready to receive input and execute its defined task.

Best Practices

  1. Consistent Naming: Use clear and descriptive names for your skills to easily identify their function.

  2. Precise Definitions: Provide detailed and unambiguous answers when prompted by skill-creator to ensure your skill performs as expected.

  3. Permission Management: Understand the implications of uploading skills to shared versus personal workspaces and manage access accordingly.

Common Questions

Can I edit a skill after it's been created?

To modify an existing skill, you would typically use the skill-creator again to generate a new .skill file with your updated parameters, then re-upload it.

What is the difference between a personal and a shared workspace for skills?

Skills uploaded to a personal workspace are only accessible by you, while skills in a shared workspace can be accessed by other members of that workspace, subject to their permissions.

Do I need to be an administrator to create and upload skills?

Creating a skill definition via skill-creator is generally available to all users. Uploading a skill, especially to a shared workspace, may require specific administrative permissions, depending on your organization's settings.

Did this answer your question?