|
| 1 | +--- |
| 2 | +title: AI Skills |
| 3 | +sidebar_label: AI Skills |
| 4 | +description: Save reusable instructions for Plane AI and run them as slash commands in chat. |
| 5 | +--- |
| 6 | + |
| 7 | +# AI Skills <Badge type="info" text="Pro" /> |
| 8 | + |
| 9 | +AI Skills are reusable instructions you save once and run in Plane AI chat with a slash command. Instead of retyping a detailed prompt every time, you capture it as a skill, give it a name, and invoke it with `/name` whenever you need it. Skills can include variables so a single skill adapts to different work items, projects, or people each time you run it. |
| 10 | + |
| 11 | +:::info Requirement |
| 12 | +AI Skills are part of Plane AI and are available when Plane AI is enabled for your workspace. |
| 13 | +::: |
| 14 | + |
| 15 | +## Skill scopes |
| 16 | + |
| 17 | +Every skill has a scope that determines who can use it. |
| 18 | + |
| 19 | +| Scope | Who creates it | Who can use it | |
| 20 | +| ------------- | ----------------- | ---------------------------- | |
| 21 | +| **Personal** | Any member | Only you | |
| 22 | +| **Workspace** | A workspace admin | Everyone in the workspace | |
| 23 | +| **System** | Built into Plane | Everyone, in every workspace | |
| 24 | + |
| 25 | +Personal and workspace skills are the ones you create. System skills are built-in and ready to use; they cannot be edited or deleted. |
| 26 | + |
| 27 | +## Find your skills |
| 28 | + |
| 29 | +Open **Skills** from the Plane AI sidebar. The page has two tabs |
| 30 | + |
| 31 | +- **Personal** - the skills only you can use. |
| 32 | +- **Workspace level** - the skills shared across the workspace. |
| 33 | + |
| 34 | +Each skill is listed with its name and who created it, along with **Edit** and **Delete** actions. |
| 35 | + |
| 36 | +## Create a skill |
| 37 | + |
| 38 | +1. On the Skills page, click **Add new skill** (or **Add personal skill** / **Add workspace skill**). |
| 39 | +2. Fill in the form. |
| 40 | + - **Skill name** (required) |
| 41 | + The name becomes the skill's slash command. Use lowercase words separated by hyphens, for example `weekly-update`. In chat you will run it as `/weekly-update`. The name is shown with a leading `/` in the form to make this clear. |
| 42 | + |
| 43 | + - **Description** (optional) |
| 44 | + A short summary of what the skill does, so you and your teammates can tell skills apart in the list. |
| 45 | + |
| 46 | + - **Scope** |
| 47 | + Choose **Personal** (only you can use it) or **Workspace** (anyone in the workspace can use it). The Workspace option is available only to workspace admins. |
| 48 | + |
| 49 | + - **Instructions** (required) |
| 50 | + The prompt Plane AI runs when the skill is invoked. Write it as clear instructions describing what you want done. You can include variables (see below). |
| 51 | + |
| 52 | +3. Click **Save**. |
| 53 | + |
| 54 | +## Use variables |
| 55 | + |
| 56 | +Variables let one skill handle different inputs each time it runs. Write a variable <span v-pre>`{{ variable_name }}`</span> anywhere in the instructions, for example: |
| 57 | + |
| 58 | +``` |
| 59 | +Summarize the latest activity on {{ work_item }} and post a status update for {{ assignee }}. |
| 60 | +``` |
| 61 | + |
| 62 | +When you run the skill, you supply the specific value for each variable. |
| 63 | + |
| 64 | +Two ways to add a variable in the editor: |
| 65 | + |
| 66 | +- Type <span v-pre>`{{ }}`</span> directly and name your own variable. |
| 67 | +- Click **Add variable**, or press `{`, to insert a Plane entity variable. The available Plane entities are: work item, project, workspace, initiative, cycle, module, view, teamspace, page, assignee, priority, due date, and state. |
| 68 | + |
| 69 | +Plane detects the variables in your instructions automatically. You do not declare them separately. |
| 70 | + |
| 71 | +## Run a skill in chat |
| 72 | + |
| 73 | +1. In the Plane AI chat input, type `/`. |
| 74 | +2. A list of your available skills appears (personal, workspace, and system). Keep typing to filter by name. |
| 75 | +3. Select the skill. Its instructions are added to your message. |
| 76 | +4. Provide values for any variables the skill uses, then send. |
| 77 | + |
| 78 | +The skill list also includes a **Manage skills** shortcut back to the Skills page. |
| 79 | + |
| 80 | +## Edit or delete a skill |
| 81 | + |
| 82 | +From the Skills page, use the **Edit** action to change a skill's name, description, scope, or instructions, and **Delete** to remove it. Deleting a skill cannot be undone. |
| 83 | + |
| 84 | +You can edit and delete your own personal skills. Editing and deleting workspace skills requires workspace admin access. System skills cannot be changed. |
| 85 | + |
| 86 | +## Notes |
| 87 | + |
| 88 | +- A skill name must be unique within its scope: unique among your personal skills, unique within the workspace for workspace skills. |
| 89 | +- Instructions can be up to 8,000 characters. |
| 90 | +- Deactivating or deleting a skill removes it from the slash command list going forward; it does not affect past chats. |
0 commit comments