# Use Analyst skills from your agent

Save your team’s approach to a repetitive task as an [Analyst skill](https://dev.nominal.io/platform/reference/glossary.md#analyst-skill "Your team's written approach to a standard task, which Analyst and connected agents follow. Everyone in a workspace shares its skills."), stored in Nominal and shared with everyone in your [workspace](https://dev.nominal.io/platform/reference/glossary.md#workspace "A shared space where your team stores and analyzes test data, with its own assets, data sources, runs, workbooks, and users."), with no shared repository to maintain.

[Analyst](https://dev.nominal.io/platform/reference/glossary.md#analyst "Nominal's AI assistant, which works inside a workbook to create visualizations, add variables, query data, and build and apply checklists.") and your connected agent read these skills and follow them to process or report on your data in Nominal.

A skill is a folder with a SKILL.md file that stores the skill’s name, description, and instructions. The skill folder can also store related content, like templates or notes. You can write skills in Nominal, as [🔒︎Create Analyst skills](https://docs.nominal.io/core/documentation/platform/analyst-skills) describes, or have your agent write them.

If you haven’t connected yet, start with [Connecting Your Agent](https://dev.nominal.io/quickstart/mcp.md#connect).

## Before you start

Your organization needs Analyst skills turned on. Otherwise your agent has no skill tools. Your agent works with the skills in your default workspace unless you name another.

Anyone in a workspace can create and edit its skills. If you get a permission error, ask a workspace administrator to add you to the workspace.

## Ask your agent

To use an Analyst skill, name the skill explicitly or describe the task and ask your agent to find a matching Analyst skill.

> **Note**
>
> Say “Analyst skill” rather than “skill”, since your agent may also have local skills of its own.

| To | Ask your agent |
| --- | --- |
| Find skills | *“What Analyst skills do we have for post-test review?”* |
| Use a skill | *“Use our post-test review Analyst skill on the S7 sine sweep run.”* |
| Save a skill | *“Save this workflow as an Analyst skill called ‘post-test-review’.”* |
| Change a skill | *“Add a limits table to the post-test review Analyst skill.”* |
| Turn a skill on | *“Turn on the post-test review Analyst skill.”* |
| Turn a skill off | *“Turn off the post-test review Analyst skill.”* |
| Archive a skill | *“Archive the post-test review Analyst skill.”* |
| Restore a skill | *“Restore the post-test review Analyst skill.”* |

## Changes are shared

Any Analyst skill your agent creates is turned on immediately. After a change, every Analyst user or connected agent will see the change the next time they use the skill.

> **Note**
>
> Restoring an Analyst skill leaves it turned off. Ask your agent to turn the skill on to use it.

## When something goes wrong

- **Someone else changed the skill first**, in Nominal, in Analyst, or in its folder in Drives: your agent’s save changes nothing. Ask your agent to read the skill again and reapply your change.
- **A skill can’t load**, for example because its SKILL.md is invalid or was moved: ask your agent to fix it.
- **Your agent’s save is refused**: check your permissions with your workspace administrator.

Stuck? See [Troubleshooting](https://dev.nominal.io/quickstart/mcp/troubleshooting.md).
