@rubytech/taskmaster 1.5.2 → 1.6.0

package/taskmaster-docs/USER-GUIDE.md

@@ -768,18 +768,49 @@ You can also create events by asking the assistant in chat ("remind me every Mon
 
 ### Skills
 
-Skills are the specialised abilities your assistant has — like handling customer enquiries, creating quotes, or checking the weather. This tab shows which skills are installed, whether they're active, and if anything is missing (like an API key a skill needs).
+Skills are specialised abilities your assistant has — handling customer enquiries, creating quotes, checking the weather, generating images, and more. The Skills tab shows every skill that is installed, whether it is active, and flags anything that is missing (such as an API key a skill needs).
 
-Skills are labelled as **Preloaded** (built-in, always active) or **User** (created by you). You can:
+Each skill has a label:
 
-- **Tap any skill** to open a detail view showing its full instructions and reference files
-- **Enable/Disable** a user skill using the toggle button
-- **Edit** a user skill — loads its content so you can save an updated version
-- **Delete** a user skill (with confirmation)
+| Label | Meaning |
+|-------|---------|
+| **Preloaded** | Ships with the product. Always active. Cannot be disabled or deleted. |
+| **User** | Created by you (or by your assistant on your behalf). You can enable, disable, edit, or delete these. |
 
-**Creating new skills:** Ask your assistant to help you create a skill — it will walk you through the process step by step and prepare a draft. Once the draft is ready, open the **Drafts** button in the Skills tab to review, install, or delete pending drafts. You don't need to write skill files manually.
+#### Filtering the list
 
-Preloaded skills ship with the product and cannot be disabled or deleted.
+Use the **All / Preloaded / User** chip buttons at the top of the list to show only the type you're interested in.
+
+#### Viewing a skill
+
+Tap any skill to open its detail view. The detail view has tabs — one for the skill's main instructions (SKILL.md) and one for each reference file the skill uses. You can read through everything the skill does without leaving the page.
+
+#### Editing a user skill
+
+From the detail view, tap **Edit** to open the skill editor. The editor has the same tabs as the detail view (SKILL.md and any reference files), so you can edit each part independently. If you are already viewing a reference tab when you tap Edit, the editor opens directly on that reference.
+
+When you save an installed skill, the changes take effect immediately.
+
+#### Enable / Disable
+
+Toggle a user skill on or off with the switch on its card. A disabled skill stays installed but your assistant will not use it until you re-enable it.
+
+#### Delete
+
+Tap the delete icon on a user skill's card. You will be asked to confirm before the skill is removed.
+
+#### Drafts — creating new skills
+
+You do not need to write skill files by hand. Instead:
+
+1. **Ask your assistant** to create a skill — it walks you through the process step by step, asking what you need the skill to do.
+2. The assistant saves a **draft** using its built-in skill-builder.
+3. Open the **Drafts** button in the Skills tab to see all pending drafts.
+4. From the drafts list you can:
+   - **Edit** — review or modify the draft before installing it. The editor has the same tabs (SKILL.md and reference files) so you can fine-tune each part. Clicking **Save** saves your changes back to drafts — it does **not** install the skill.
+   - **Install** — activate the skill so your assistant starts using it.
+   - **Delete** — discard the draft.
+5. Once a draft is installed it moves out of drafts and into the main skills list as a **User** skill.
 
 ### Logs