Ctrlk
註冊/登入
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Skill Management

Learn how to create, edit, and manage skills, including manual creation, uploading skill packages, attaching tools, and export functionality

If you're not yet familiar with what skills are, please read: Skill Overview

Creating Skills

Click Skills in the left sidebar to enter the skills management page, then click the Add Skill button in the upper right corner.

The system provides two creation methods:

Method 1: Manual Creation

Suitable for writing skill instructions from scratch.

  1. In the add skill dialog, click the Switch to manual creation link at the bottom to switch to manual mode

  2. Fill in the Basic Settings tab:

    • Skill Name (required): Give the skill an easily identifiable name

    • Description (required): Briefly describe the skill's purpose

  3. Switch to the Instructions tab and write instructions in Markdown format. You can also click the Apply Template button to use a system-provided default template as a starting point

  4. (Optional) Switch to the Attached Tools tab to select the tools required by the skill

  5. Click Save to complete creation

Method 2: Upload Skill Package

Suitable for importing pre-packaged .skill or .zip files.

  1. In the add skill dialog (upload mode by default), drag and drop the .skill or .zip file into the upload area, or click the area to select a file

  2. After the upload is complete, the system automatically parses the SKILL.md file to extract the skill name, description, and instructions

  3. After successful creation, you are automatically redirected to the edit page where you can further adjust the settings

The skill package must contain a SKILL.md file in the following format:

Editing and Configuring Skills

In the skill list, click the Edit icon for the skill to enter the skill settings page.

Basic Settings

Edit the skill's name and description.

Instructions

Edit the skill instructions in Markdown format. These instructions serve as the execution guide when the AI assistant activates the skill.

Click Apply Template to load a default instruction template.

Applying a template will overwrite the current instructions. Please confirm before proceeding.

Skill Package (Upload-created skills only)

If the skill was created by uploading a .skill / .zip file, this tab displays:

  • Skill package info: File name, size, upload time

  • Preview: Expand to view the file structure within the skill package

  • Download: Export the skill package file

  • Re-upload skill package: Upload a new version to replace the existing skill package

Attached Tools

Bind the required tools to the skill so the AI assistant can call them when executing the skill.

  1. Click the Select Tools button to open the tool selection dialog

  2. Check the tools to attach (multiple selection supported), then click Confirm

  3. Selected tools appear in the list, showing the tool name, type (API / MCP), and description

  4. To remove a tool, click the delete icon on the tool card

After completing the configuration, click the Save button in the lower right corner of the page.

Exporting Skills

In the skill edit page's Skill Package tab, click the Download button to export the skill as a .skill file.

Manually created skills can also be exported. The system automatically packages the instructions and resources into a .skill file. Exported skill packages can be shared with other organizations for import.

Binding Skills to an AI Assistant

Skills must be bound to an AI assistant to take effect:

  1. Go to the AI Assistant page, select the target AI assistant, and enter its settings

  2. Find the Skills setting in the model configuration area

  3. Select the skills to bind and click Confirm

  4. Save the AI assistant settings

Once bound, the AI assistant automatically determines whether to activate a skill based on the user's question during conversations and executes the corresponding task according to the skill instructions.

Controlling Skill Visibility and Permissions by Role

If you want members with specific roles to see only the skills relevant to their work, you can use role permission management to assign skills to each role individually.

For example, suppose a company's system administrator wants sales representatives to be able to read the “Customer Summary” skill but not modify or delete it. The administrator can edit the sales role, assign this skill, and grant read permission only. Once configured, sales representatives can see “Customer Summary” in the skill list without receiving permission to modify or delete it.

How It Works

  • Unassigned means hidden: Skills created by the organization must be assigned to a role before members with that role can see them in the skill list. Unassigned skills are completely hidden from that role

  • Granular permissions: Each “role × skill” assignment can have its Read, Edit, and Delete permissions configured independently, allowing read-only scenarios such as “can read but cannot modify”

  • Create permission: Each role has its own “Allow skill creation” toggle, which controls whether members with that role can create skills

  • Owners are unrestricted: Organization owners automatically have full access to all skills and do not require assignments

  • Global skill exception: Built-in global skills are visible to all members and cannot be restricted through role assignments

Configuration Steps

1

Open Role Settings

From the left sidebar, select “Organization Settings” → “Organization Overview,” then click “Edit Role Permissions.” Select the role you want to configure, then switch to the “Assign Skills” tab.

2

Set Skill Creation Permission

Select or clear “Allow skill creation” as needed to determine whether members with this role can create skills. Changes are saved immediately, and a success message appears after the update is complete.

3

Assign Skills

Click the “Assign Skills” button, select the skills you want to make available to this role, and confirm your selection.

4

Set Skill Permissions

In the assigned skills list, configure the read, edit, and delete permissions for each skill individually, or remove the assignment. Permission changes are saved immediately when selected or cleared. A success message appears after the update, and there is no separate “Save” button on the page.

Assign Skills tab in role permission management, where skill creation and skill permissions can be configured
Manage skill creation permission and individual skill permissions on the “Assign Skills” tab
Assign Skills dialog, with available skills on the left and selected skills on the right
Select the skills to assign to the role from the available skills

For information about creating roles and assigning members, see Role Permission Management.

Deleting Skills

In the skill list, click the Delete icon for the skill, then confirm to delete it.

After deleting a skill, AI assistants that had this skill bound will no longer be able to use it. This action cannot be undone.

PreviousSkill Features Overview
NextAgent Teams

Last updated

Was this helpful?