docs: add skills documentation images

Author: jsourcebot

docs/docs.json

@@ -66,6 +66,7 @@
                                 "group": "Ask Sourcebot",
                                 "root": "docs/features/ask/ask-sourcebot",
                                 "pages": [
+                                    "docs/features/ask/skills",
                                     "docs/features/ask/connectors",
                                     "docs/features/ask/chat-sharing",
                                     "docs/features/ask/add-model-providers"

docs/docs/features/ask/skills.mdx

@@ -24,12 +24,20 @@ Each skill has four fields:
 - **Description**: A short summary of when Ask Sourcebot should use the skill.
 - **Instructions**: The markdown context or guidance Ask Sourcebot uses when the skill runs.
 
+<Frame>
+  <img src="/images/skills_create.png" alt="Create a skill" />
+</Frame>
+
 ## Writing instructions
 
 Keep the description specific. Ask Sourcebot uses it to decide when a skill is relevant, and users see it when browsing slash commands.
 
 Put the useful context or guidance in the instructions.
 
+<Frame>
+  <img src="/images/skills_editor.png" alt="Skill editor" />
+</Frame>
+
 ## Using skills in chat
 
 Type `/` at the start of an Ask Sourcebot prompt to browse available skill commands.
@@ -38,6 +46,10 @@ When you select a skill, Ask Sourcebot expands the command into that skill's ins
 
 Ask Sourcebot may also load a matching skill automatically. When this happens, the chat details show the loaded skill name and command.
 
+<Frame>
+  <img src="/images/skills_slash_command.png" alt="Skill slash command suggestions" />
+</Frame>
+
 ## Personal and shared skills
 
 Skills can be personal or shared:
@@ -49,6 +61,10 @@ You can add or remove shared skills from your own Ask commands from **Settings -
 
 Organization owners can manage shared skills from **Settings -> Workspace -> Ask Sourcebot**. Owners can also enable **Auto** for a shared skill, which adds it to members' Ask commands by default.
 
+<Frame>
+  <img src="/images/skills_workspace_manager.png" alt="Workspace shared skills manager" />
+</Frame>
+
 ## Importing skills
 
 ### Import from file
@@ -82,6 +98,10 @@ Synced skills behave like manually-created skills, with a link back to their sou
 - Either action warns you first if it would overwrite local edits.
 - Fields the source file does not provide (for example, a missing `description`) keep their local values when you sync.
 
+<Frame>
+  <img src="/images/skills_synced_from_repo.png" alt="Synced repository skill" />
+</Frame>
+
 ## Permissions and synced skills
 
 Synced skills mirror content from a repository file, so Sourcebot only shows them to users who can access the source repository.