HTML artifacts, page labels, AI skill, AI text to PQL, PQL functions

docs/.vitepress/config.ts

@@ -583,8 +583,16 @@ if(n<200&&document.readyState==="loading")requestAnimationFrame(function(){bar(n
             ],
           },
           { text: "Wiki", link: "/core-concepts/pages/wiki" },
-          { text: "Collections", link: "/pages/collections" },
-          { text: "Nested Pages", link: "/core-concepts/pages/nested-pages" },
+          {
+            text: "Organize pages",
+            collapsed: false,
+            link: "/pages/organize-pages",
+            items: [
+              { text: "Collections", link: "/pages/collections" },
+              { text: "Nested Pages", link: "/pages/nested-pages" },
+              { text: "Page Labels", link: "/pages/page-labels" },
+            ],
+          },
           { text: "Page Templates", link: "/templates/page-templates" },
         ],
       },
@@ -724,6 +732,7 @@ if(n<200&&document.readyState==="loading")requestAnimationFrame(function(){bar(n
         text: "AI",
         items: [
           { text: "Plane AI", link: "/ai/plane-ai" },
+          { text: "AI Skills", link: "/ai/ai-skills" },
           { text: "AI credits", link: "/ai/plane-ai-credits" },
           { text: "MCP Connectors", link: "/ai/mcp-connectors" },
           {

docs/ai/ai-skills.md

@@ -0,0 +1,90 @@
+---
+title: AI Skills
+sidebar_label: AI Skills
+description: Save reusable instructions for Plane AI and run them as slash commands in chat.
+---
+
+# AI Skills <Badge type="info" text="Pro" />
+
+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.
+
+:::info Requirement
+AI Skills are part of Plane AI and are available when Plane AI is enabled for your workspace.
+:::
+
+## Skill scopes
+
+Every skill has a scope that determines who can use it.
+
+| Scope         | Who creates it    | Who can use it               |
+| ------------- | ----------------- | ---------------------------- |
+| **Personal**  | Any member        | Only you                     |
+| **Workspace** | A workspace admin | Everyone in the workspace    |
+| **System**    | Built into Plane  | Everyone, in every workspace |
+
+Personal and workspace skills are the ones you create. System skills are built-in and ready to use; they cannot be edited or deleted.
+
+## Find your skills
+
+Open **Skills** from the Plane AI sidebar. The page has two tabs
+
+- **Personal** - the skills only you can use.
+- **Workspace level** - the skills shared across the workspace.
+
+Each skill is listed with its name and who created it, along with **Edit** and **Delete** actions.
+
+## Create a skill
+
+1. On the Skills page, click **Add new skill** (or **Add personal skill** / **Add workspace skill**).
+2. Fill in the form.
+   - **Skill name** (required)  
+     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.
+
+   - **Description** (optional)  
+     A short summary of what the skill does, so you and your teammates can tell skills apart in the list.
+
+   - **Scope**  
+     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.
+
+   - **Instructions** (required)  
+     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).
+
+3. Click **Save**.
+
+## Use variables
+
+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:
+
+```
+Summarize the latest activity on {{ work_item }} and post a status update for {{ assignee }}.
+```
+
+When you run the skill, you supply the specific value for each variable.
+
+Two ways to add a variable in the editor:
+
+- Type <span v-pre>`{{ }}`</span> directly and name your own variable.
+- 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.
+
+Plane detects the variables in your instructions automatically. You do not declare them separately.
+
+## Run a skill in chat
+
+1. In the Plane AI chat input, type `/`.
+2. A list of your available skills appears (personal, workspace, and system). Keep typing to filter by name.
+3. Select the skill. Its instructions are added to your message.
+4. Provide values for any variables the skill uses, then send.
+
+The skill list also includes a **Manage skills** shortcut back to the Skills page.
+
+## Edit or delete a skill
+
+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.
+
+You can edit and delete your own personal skills. Editing and deleting workspace skills requires workspace admin access. System skills cannot be changed.
+
+## Notes
+
+- A skill name must be unique within its scope: unique among your personal skills, unique within the workspace for workspace skills.
+- Instructions can be up to 8,000 characters.
+- Deactivating or deleting a skill removes it from the slash command list going forward; it does not affect past chats.