falcon skill builder doc

src/lib/navigation.ts

@@ -145,6 +145,7 @@ export const tabNavigation: NavTab[] = [
             title: 'Features',
             items: [
               { title: 'Using Falcon AI', href: '/docs/falcon-ai/features/chat' },
+              { title: 'Skill Builder', href: '/docs/falcon-ai/features/skills' },
             ]
           },
         ]

src/pages/docs/falcon-ai/features/skills.mdx

@@ -0,0 +1,50 @@
+---
+title: "Skill Builder"
+description: "Create custom reusable workflows that run as slash commands in Falcon AI."
+---
+
+## About
+
+The same multi-step analysis (checking regressions, generating cost reports, investigating error spikes) gets repeated across conversations and team members. Skills package these workflows into reusable slash commands. Create a skill once, and the whole workspace can run it from the command picker with one click. The built-in `/clear` command starts a new conversation.
+
+---
+
+## When to use
+
+- **Recurring analysis**: Package "check evaluation scores, find regressions, compare with last week" into a single `/weekly-review` command.
+- **Team workflows**: Create skills that standardize how the team investigates issues, generates reports, or sets up experiments.
+- **Onboarding**: Build a `/getting-started` skill that walks new users through the workspace setup.
+
+---
+
+## How to
+
+<Steps>
+  <Step title="Open the skill editor">
+    In the Falcon AI chat input, click the **customize** button to open the skill picker. Click **Create Skill** to open the editor dialog.
+    ![Open skill editor](/screenshot/product/falcon/7.png)
+  </Step>
+
+  <Step title="Configure the skill">
+    Fill in the skill fields:
+    ![Skill editor fields](/screenshot/product/falcon/8.png)
+
+    | Field | Description |
+    |-------|-------------|
+    | **Name** | Display name for the skill (e.g., "Weekly Cost Review") |
+    | **Description** | Short description shown in the command picker |
+    | **Icon** | Icon displayed next to the skill name |
+    | **Instructions** | The prompt that Falcon AI follows when the skill is triggered. Write it as a set of instructions for the AI to execute. |
+    | **Trigger phrases** | Optional phrases that activate the skill automatically when typed in a message. Press Enter to add each phrase. |
+  </Step>
+
+  <Step title="Run a skill">
+    Type `/` in the chat input to open the command picker. All active skills appear alongside the built-in `/clear` command. Select a skill to run its instructions in the current conversation.
+
+    Skills can also trigger automatically when a message matches one of the configured trigger phrases.
+  </Step>
+
+  <Step title="Edit or delete a skill">
+    Open the skill picker, click on an existing skill to open the editor. Update any field and save, or click **Delete** to remove it.
+  </Step>
+</Steps>