# Skill libraries
### **1. What is a skill library?**
**Skill Libraries** are where [**skills**](/skills/what-is-a-skill.md) are organized, labeled and structured into category trees. Think of this as a virtual bookcase.
This tree structure of groups is used within many places in AG5. It allows the user to select or filter by a group of skills (also known as qualifications).
Your skills library is located within the Skills page:
Your library is located within the skills page:
{% hint style="info" %}
**Most importantly**, if your skill do not live in a library, they will **not** be visible in any matrix.
{% endhint %}
### **2. How to create library sub-categories**
In a **library**, [**skills**](/skills/what-is-a-skill.md) can be categorized based on anything, such as content, type, or use.
The way your libraries are structured directly affects how your skills appear on a matrix. When you change something in a library, your matrices are automatically updated.
There is no limit to the number of library categories that can be created. Having separate library categories for skills can sometimes be useful.
**Steps**:
1. Go to the **Skills** page.
2. Select the library: .
3. Add a name for your new skills library.
4. Select thebutton.
5. Your library is created.
{% hint style="info" %}
The title of your library is determined by what you choose to name the top category. If you have more than one "top" category, this effectively gives you more than one library.
{% endhint %}
### **3. How to structure skills in libraries**
1. Open your **library.**
2. Drag theelement from the right side and drop it into the white area of your library.
3. Select the newly created **category.**
4. Change the name of your category.
5. Change the code of the category.
6. .Click in the white area to deselect the category.
7. On the right-hand side, select "Add a skill:
8. Search for the skill you want to add to a category.
9. Drag and drop the skill into the correct category.
10. If you wish to delete a skill from a category, click on the skill and then the symbol.
{% hint style="info" %}
Categories are ordered based on category codes - first numerically and then alphabetically.
{% endhint %}
{% hint style="info" %}
To double check which categories you've placed your skills into, you can see each category they belong to on the skills tab. You'll also see if a skill is missing from a library - when that's the case, no category will be listed.
{% endhint %}
**In this example, "90 Day Review" is missing from the library because no category is listed**
### 4. How to delete categories and libraries
Libraries must be completely empty before they can be deleted. This is to reduce the chances of accidental deletion.
{% hint style="info" %}
Deleting skills only removes them from libraries and does not remove the skill entirely from the skills menu.
{% endhint %}
1. Remove all skills by selecting them and then clicking on the trashcan icon that appears on the right.
2. Remove all categories by doing the same.
3. Finally, select the top category and delete.
> If the below menu is missing from the library screen, this means you have selected an item in the tree and the details of that item are displayed. Simply click anywhere in the white area on your screen to deselect that item.
### 5. Some best practices for building libraries
**Each category creates a header on a matrix.**
See how these categories are nested under "Skills"
 And how that is mirrored here, on the matrix
 When a new subcategory is added and 5 skills moved into it...
 It is reflected on the matrix
Categories which contain only a small number of skills will often be too small to read on a matrix, unless clicked or collapsed.
 After moving all but 2 skills out of "New category"
 "New category" becomes unreadable unless it's clicked on or collapsed
 \
This pattern continues when adding more subcategories underneath "Soft Skills"
 As seen, these subcategories also show up on a matrix
**Skills can live in more than one category.**
It is possible to add skills to more than one category. As shown below, **moving a skill** (in this case, "Test") **from one category to another does not add multiple instances of a skill (also known as qualification).**
However, if dragged over from the right, a skill can be added to more than one category.
While beneficial in certain circumstances, skills living under more than one category will create duplication on a matrix, so bear this in mind.
### **6. Next steps in your AG5 setup**
Once you have finished building your first **library** with all of your [**skills**](/skills/what-is-a-skill.md), it's time to use them to add [**requirements**](/skills/skill-requirements.md) to AG5.
---
# 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.ag5.com/skills/skill-libraries.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.
button.
5. Your library is created.
{% hint style="info" %}
The title of your library is determined by what you choose to name the top category. If you have more than one "top" category, this effectively gives you more than one library.
{% endhint %}
