docs(user-guide): document skills in workflow assistants

docs/user-guide/project-user-management/index.mdx

@@ -33,7 +33,7 @@ The **Project & User Management** section is accessible via the **Profile** icon
     icon="/img/icons/user.svg"
     iconType="image"
     title="Users"
-    description="View all platform users, inspect individual user details, manage project assignments, and update user names. Available to Platform Admins."
+    description="View all platform users, inspect individual user details, manage project assignments. Available to Platform Admins."
     link="/user-guide/project-user-management/users"
   />
 </FeatureGrid>

docs/user-guide/skills/index.md

@@ -28,6 +28,7 @@ Attach and use skills with assistants:
 
 - [Attach to Assistants](./attach-skills-to-assistants) - Assign skills to assistants
 - [Skills in Chat](./skills-in-chat) - Dynamically attach skills during conversations
+- [Skills in Workflow](./skills-in-workflow) - Configure skills in workflow YAML
 
 ## Marketplace
 

docs/user-guide/skills/skills-in-workflow.md

@@ -0,0 +1,73 @@
+---
+id: skills-in-workflow
+title: Skills in Workflow
+sidebar_label: Skills in Workflow
+sidebar_position: 8
+pagination_prev: user-guide/skills/skills-index
+pagination_next: null
+---
+
+# Skills in Workflow
+
+Attach skills to assistants defined in workflow YAML to extend their capabilities during workflow execution.
+
+## Finding a Skill ID
+
+Each skill has a unique ID required for YAML configuration.
+
+**Step 1: Open Skill Details**
+
+Navigate to **Skills** → **Project Skills** and click on the skill.
+
+**Step 2: Copy the Skill ID**
+
+Find the **Skill ID** field in the right panel and copy the value.
+
+![Skill Details — Skill ID](./images/skill-details-skill-id.png)
+
+## Configuring Skills in Workflow YAML
+
+**Step 1: Open Workflow Configuration**
+
+Open your workflow in the builder and click **Workflow Config** → **YAML** tab.
+
+**Step 2: Add the `skills` field to the assistant**
+
+Add a `skills` list under the assistant definition, using the skill IDs you copied:
+
+```yaml
+assistants:
+  - id: html_generating_assistant
+    model: gpt-5.2
+    system_prompt: |
+      Act as a product manager's assistant responsible for creating HTML emails.
+    skill_ids:
+      - skill-id
+```
+
+![Workflow YAML — Assistant Skills Configuration](./images/workflow-yaml-assistant-skills.png)
+
+**Step 3: Save and run the workflow**
+
+Click **Save**, then **Save and Run**. The assistant will load the configured skills on demand during execution.
+
+:::tip
+You can attach multiple skills to a single assistant by adding multiple IDs to the `skill_ids` list.
+:::
+
+## Viewing Skill Usage in Execution Logs
+
+After the workflow runs, open the execution details to see which skills were invoked.
+
+Navigate to **Workflows** → select your workflow → click **view** button.
+
+Each assistant step shows the skills it loaded, including the full skill content used during that run.
+
+![Workflow Execution — Skill Output](./images/workflow-execution-skill-output.png)
+
+## Related
+
+- [Create a Skill](./create-skill) — Build a new skill from scratch
+- [Skills Marketplace](./marketplace-skills) — Discover publicly shared skills
+- [Attach Skills to Assistants](./attach-skills-to-assistants) — UI-based skill attachment for regular assistants
+- [Workflow Configuration Reference](../workflows/configuration/configuration-reference) — Full YAML reference

docs/user-guide/skills/skills-overview.md

@@ -47,7 +47,18 @@ User adds "Find Duplicate Tickets" skill to current chat
 → Other chats with same assistant remain unaffected
 ```
 
-**3. Marketplace Discovery**
+**3. Workflow Assistant Configuration (YAML-level)**
+
+Skills can be embedded directly into virtual assistants defined in workflow YAML.
+
+```
+Workflow YAML defines an assistant with a skills list
+→ Assistant loads configured skills during workflow execution
+→ Skill usage is logged in execution history
+→ Other assistants and workflows are unaffected
+```
+
+**4. Marketplace Discovery**
 
 Public skills can be discovered and attached from the Skills Marketplace.
 

docs/user-guide/workflows/configuration/configuration-reference.md

@@ -28,6 +28,9 @@ assistants:
     datasource_ids:
       - datasource-id-1
       - datasource-id-2
+    skill_ids:
+      - skill-id-1
+      - skill-id-2
     mcp_servers:
       - {...}  # See Section 3.6 for MCP Server configuration
 ```
@@ -55,6 +58,7 @@ assistants:
   [Troubleshooting](./troubleshooting#tool-output-token-limit-exceeded) for diagnosis and
   mitigation strategies.
 - **exclude_extra_context_tools**: Disable automatic context tools
+- **skills**: List of skill IDs to attach to the assistant. Skills load on demand during execution based on relevance. See [Skills in Workflow Assistants](../../skills/skills-in-workflow) for usage details.
 - **mcp_servers**: List of MCP server configurations (see Section 3.6)
 
 #### Tool Configuration:

faq/how-do-i-attach-skills-to-a-assistant-in-a-workflow.md

@@ -0,0 +1,25 @@
+# How do I attach skills to assistant in a workflow?
+
+To attach skills to a assistant defined in workflow YAML:
+
+1. Open the skill in CodeMie, navigate to **Skill Details**, and copy the **Skill ID** (UUID) from the right panel.
+2. In the workflow builder, open **Workflow Config** → **YAML** tab.
+3. Under the `assistants` section, add a `skill_ids` list with the skill UUID(s):
+
+```yaml
+assistants:
+  - id: html_generating_assistant
+    model: gpt-4.1
+    system_prompt: |
+      Your assistant instructions here.
+    skill_ids:
+      - 660c5b0e-****-****-****-a0ea50db3042
+```
+
+4. Click **Save** and run the workflow. The assistant loads the configured skills on demand during execution.
+
+You can attach multiple skills to one assistant by listing multiple IDs under `skills`.
+
+## Sources
+
+- [Skills in Workflow Assistants](https://codemie-ai.github.io/docs/user-guide/skills/skills-in-workflow-assistants)

sidebars.ts

@@ -85,6 +85,7 @@ const sidebars: SidebarsConfig = {
             'user-guide/skills/manage-skills',
             'user-guide/skills/marketplace-skills',
             'user-guide/skills/skills-in-chat',
+            'user-guide/skills/skills-in-workflow',
           ],
         },
         {