# Skills in Blockbrain
### What Are Skills?
**Skills** are reusable, saved instructions or procedures that you can create, store, and invoke within Blockbrain. Think of a Skill as a shortcut to a predefined workflow or action - instead of typing out the same instructions every time, you save them once as a Skill and run them on demand with just a few keystrokes.
***
### Why Use Skills?
| Benefit | Description |
| ---------------- | ---------------------------------------------------------------------- |
| **Speed** | Invoke complex workflows instantly without retyping instructions |
| **Reusability** | Create once, use many times across conversations |
| **Organization** | Store Skills in folders to keep your workspace tidy |
| **Agent-ready** | Your AI agent can execute Skills automatically as part of its workflow |
| **Precision** | Skills ensure the same procedure is followed every time |
***
### Creating a Skill
There are two ways to create a Skill in Blockbrain:
#### Option 1: Save a Message as a Skill
This is the quickest way to turn an existing instruction or AI response into a reusable Skill
1. Find the message in your conversation that contains the instructions or procedure you want to save
2. Click the **"Save message as skill"** action (available on any message)
3. A **"Choose a folder"** modal will appear - select the destination folder where you want to store the Skill
4. Complete the save action
> The Skill will only appear in your Skill library once the save has been **fully completed**.
#### Option 2: Create a Skill Directly from the Knowledge Management
1. Navigate to the **Knowledge Management section** from your top navigation bar
2. Click the **"Add Skill"** button
3. Click the "**Add new**" button
4. Give your Skill a **name** and a unique **handle** (e.g., `weekly-status-report`)
5. Write the instructions or procedure content in the editor
6. Choose a **folder** to organize it in
7. Save your Skill
***
### Organizing Skills into Folders
Skills can be stored in **folders** to help you keep them organised, especially as your library grows.
* When saving a Skill, you will be prompted to **choose a destination folder**
* You can create new folders or select existing ones
* Folders appear in the Skills management page for easy browsing
***
### Invoking a Skill - Using the Slash Command (`/`)
> You must connect the skill to a chat in order to use it with / command.
The fastest way to run a Skill in a conversation is via the **slash command**:
#### How to Use the `/` Command
| Action | What to Type | Result |
| ----------------------- | ------------ | ---------------------------------------- |
| Browse all skills | `/ skill` | Opens the full **Skills submenu** |
| Invoke a specific skill | `/ [handle]` | Directly runs the Skill with that handle |
#### Example
If you have a Skill with the handle `weekly-status-report`, you can invoke it by typing:
```
/weekly-status-report
```
This will immediately trigger that Skill in your current conversation.
***
### Managing Your Skills
#### Viewing All Skills
1. Navigate to the **Knowledge Management section**
2. All your saved Skills are listed here, organized by folder
#### Editing a Skill
1. Go to the **Knowledge Management section**
2. Navigate to **Skills** section
3. Find the Skill you want to edit and click on it
4. Update the name, handle, content, or folder
5. Save your changes
#### Deleting a Skill
1. Go to the **Skills page**
2. Select the Skill you wish to delete
3. Click **Delete** and confirm the action in the confirmation dialog
> Deletion is permanent. Make sure you no longer need the Skill before confirming.
***
### Tips & Best Practices
* **Use clear handles** - choose short, descriptive handles like `summarize-report` or `send-weekly-update` so they're easy to remember and type
* **Use folders** - organize Skills into logical categories (e.g., Marketing, Finance, HR) to make them easy to find
* **Be specific in your instructions** - the more precise the Skill content, the more reliably your agent will execute it
* **Review Skills regularly** - archive or delete outdated Skills to keep your library clean
* **Combine Skills with Prompts** - use the `/` command to mix Skills and Prompts for maximum flexibility in your conversations
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.en.theblockbrain.ai/for-users/skills-in-blockbrain.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.