> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/for-users/all-about-knowledge-management/skills-in-blockbrain.md).
# Skills in Blockbrain
Skills are designed to save you time, ensure consistency, and make your AI agent smarter by giving it reusable procedures it can call upon whenever needed.
### 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 and Managing Skills
#### Adding New Skills and Folders
To add a new skill or create a folder:
1. Click the **Add new ▼** dropdown button in your Skills panel
2. Select one of the following options:
* **Skill** — Create a new skill
* **New Folder** — Create a new folder to organize your skills
The dropdown menu consolidates both actions in a single control for a streamlined interface.
#### Creating a Skill
When you select **Skill** from the **Add new ▼** dropdown:
1. Choose the location where you want to save the skill (default folder or a specific folder)
2. Enter the skill name and description
3. Add the skill content (prompt, instructions, or commands)
4. Click **Save** to create the skill
#### Creating a Folder
When you select **New Folder** from the **Add new ▼** dropdown:
1. Enter a folder name
2. Click **Create** to add the folder
You can then organize your skills by moving them into folders.
### Using Skills in Conversations
#### Accessing Skills with Slash Command
To use a skill in a conversation, you can access skills through the slash menu:
1. Type `/` in your message input
2. A menu will appear with two options:
* **Prompt Library** — Search and use saved prompts
* **Skills** — Search and use connected skills
3. Click **Skills** to open the Skills search popup
4. The popup displays all available skills connected to this conversation
5. Type to search for a specific skill by name or handle
6. Click on a skill to insert it into your message
#### Skill Handles
Each skill has a unique **handle** (shown in the Skills list with a `/` prefix, e.g., `/my-skill`). Some skills and folders don’t have handles and will show as `-` in the handle column.
#### Empty States
When using the Skills search popup:
* **No skills connected** — You haven’t connected any skills to this conversation yet. Add skills from your Skills panel to use them here.
* **No results found** — Your search query didn’t match any connected skills. Try a different search term.
### Managing Your Skills
#### Viewing All Skills
1. Navigate to the **Knowledge Management section**
2. All your saved Skills are listed here, organized by folder
#### Skill List Columns
The Skills panel displays the following information:
* **Name** — The skill or folder name
* **Handle** — The unique identifier for the skill (prefixed with `/`). Folders and skills without handles show `-`.
* **Modified** — When the skill was last updated
* **More options** — Menu with additional actions for each skill
#### Moving and Managing Skills
You can organize skills by:
* Moving skills into different folders
* Renaming skills and folders
* Deleting skills or folders
* Sharing skills with other users (if enabled)
#### 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
{% hint style="info" %}
Deletion is permanent. Make sure you no longer need the Skill before confirming.
{% endhint %}
***
### 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
### Troubleshooting
I can’t find my skill in the Skills search popup
* Make sure the skill is connected to your current conversation
* Check your search query — try searching by a different part of the skill name
* Verify the skill exists in your Skills list and hasn’t been deleted
The “Add new ▼” button isn’t showing
* Make sure you have the required permissions to create skills
* Check that your account is active and not restricted
I can’t see all my skills
* Skills displayed depend on which bot or conversation you’re using
* Some skills may be private or shared only with specific people
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.blockbrain.ai/for-users/all-about-knowledge-management/skills-in-blockbrain.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
