> For the complete documentation index, see [llms.txt](https://docs.datasentinel.io/manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datasentinel.io/manual/ai-connector/install-the-skill.md).

# Install the Skill

Download the Datasentinel Skill and install it in any assistant: extract it into a Skills folder, upload it, or pass it as a system prompt. Where each assistant reads it, how to check it, and how to u

The Datasentinel Skill tells your assistant how to use the MCP server: which tools to call, in what order, and how to present the results. It is installed separately from the MCP server: registering the server gives the assistant the tools, not the instructions.

One Skill serves every platform, because it discovers all the MCP servers named with the `datasentinel-` prefix. Adding a second platform needs no second install.

This page describes the install in general. For the exact commands and the other setup steps, follow your assistant's guide, linked in [Where the Skill goes](#where-the-skill-goes).

{% stepper %}
{% step %}

### Download the archive

Download [datasentinel-skill.zip](https://app.datasentinel.io/ds-api/download/datasentinel-skill.zip). The same archive serves every assistant. It holds a single `datasentinel/` folder, with the `SKILL.md` entrypoint and the supporting files.
{% endstep %}

{% step %}

### Install it the way your assistant expects

{% tabs %}
{% tab title="Skills folder" icon="folder-open" %}
CLI assistants, IDEs, and the ChatGPT desktop app read Skills from a folder on disk. Find the folder your assistant reads in [Where the Skill goes](#where-the-skill-goes), then extract the archive into it, replacing `<skills-folder>` with that path.

On Linux or macOS:

```bash
mkdir -p <skills-folder>
unzip datasentinel-skill.zip -d <skills-folder>
```

On Windows, in PowerShell:

```powershell
New-Item -ItemType Directory -Force "<skills-folder>" | Out-Null
Expand-Archive -Path datasentinel-skill.zip -DestinationPath "<skills-folder>"
```

You should end up with `<skills-folder>/datasentinel/SKILL.md`. A graphical extraction tool may add a folder of its own, such as `datasentinel-skill/datasentinel/SKILL.md`: use the commands above, or move the `datasentinel` folder up to the right level.
{% endtab %}

{% tab title="Upload" icon="upload" %}
The Claude desktop app, Microsoft Copilot, Microsoft Copilot Studio, and Google Gemini take the Skill as an upload. Open the Skills settings listed in [Where the Skill goes](#where-the-skill-goes) and upload `datasentinel-skill.zip` as you downloaded it, without extracting it or compressing it again. Then check that the Skill is switched on.

In the Claude desktop app, **Code execution and file creation** must be on under **Settings > Capabilities**.
{% endtab %}

{% tab title="System prompt" icon="comment-dots" %}
An assistant with no Skills support, or an agent you build yourself, can still use the instructions. Extract the archive, then pass the contents of `datasentinel/SKILL.md` as the system prompt. See [Connect a compatible assistant](https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/connect-a-compatible-assistant.md#the-datasentinel-skill).
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Check the install

Open a new session, since many assistants read Skills only when a session starts. Then send this:

```
datasentinel help
```

A loaded Skill answers with its usage guide: the command list, the report types, example prompts. This check needs no sign-in and no platform call. If you get a generic answer instead, see [The Skill did not load](https://docs.datasentinel.io/manual/ai-connector/troubleshooting/skill-not-loaded.md).
{% endstep %}
{% endstepper %}

## Where the Skill goes

| Assistant                  | List the Skills                 | Location of `datasentinel/SKILL.md`                                                                        | Guide                                                                                                                                             |
| -------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Code                | `/skills`                       | `~/.claude/skills/` or `.claude/skills/` in the project                                                    | [Configure Claude Code](https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/configure-claude-code.md)                        |
| GitHub Copilot CLI         | `/skills list`                  | `~/.copilot/skills/`, `.github/skills/`, or `.agents/skills/`                                              | [Configure GitHub Copilot CLI](https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/configure-copilot-cli.md)                 |
| Mistral Vibe CLI           | `/datasentinel` autocompletes   | `~/.vibe/skills/`, `~/.agents/skills/`, or `.agents/skills/`                                               | [Configure Mistral Vibe CLI](https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/configure-mistral-vibe-cli.md)              |
| Google Antigravity CLI     | `/skills`                       | `~/.gemini/config/skills/`, `~/.gemini/antigravity-cli/skills/`, `~/.gemini/skills/`, or `.agents/skills/` | [Configure Google Antigravity CLI](https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/configure-antigravity-cli.md)         |
| OpenAI Codex CLI           | `/skills`                       | `~/.agents/skills/` or `.agents/skills/`                                                                   | [Configure OpenAI Codex CLI](https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/configure-codex-cli.md)                     |
| Claude desktop app         | **Customize > Skills**          | Uploaded as `datasentinel-skill.zip`; the toggle must be on                                                | [Configure the Claude desktop app](https://docs.datasentinel.io/manual/ai-connector/connect-a-desktop-app/configure-claude-desktop-windows.md)    |
| ChatGPT desktop app        | **Skills** panel in the sidebar | `%USERPROFILE%\.agents\skills` on Windows, `$HOME/.agents/skills` on macOS                                 | [Configure the ChatGPT desktop app](https://docs.datasentinel.io/manual/ai-connector/connect-a-desktop-app/configure-chatgpt-desktop-app.md)      |
| Microsoft Copilot (Cowork) | **Customize > Skills**          | Uploaded as `datasentinel-skill.zip`                                                                       | [Configure the Microsoft Copilot app](https://docs.datasentinel.io/manual/ai-connector/connect-a-desktop-app/configure-microsoft-copilot-app.md)  |
| Microsoft Copilot Studio   | Skills panel of the agent       | Uploaded as `datasentinel-skill.zip`                                                                       | [Configure Microsoft Copilot Studio](https://docs.datasentinel.io/manual/ai-connector/connect-a-desktop-app/configure-copilot-studio.md)          |
| Google Gemini              | **Settings > Skills**           | Uploaded as `datasentinel-skill.zip`, or `SKILL.md` alone                                                  | [Configure the Google Gemini desktop app](https://docs.datasentinel.io/manual/ai-connector/connect-a-desktop-app/configure-gemini-desktop-app.md) |
| Visual Studio Code         | `/skills`                       | `~/.copilot/skills/`, `.github/skills/`, `~/.claude/skills/`, or `~/.agents/skills/`                       | [Configure Visual Studio Code](https://docs.datasentinel.io/manual/ai-connector/connect-an-ide/configure-vscode.md)                               |
| Cursor                     | `/` in the chat input           | `~/.cursor/skills/`, `.cursor/skills/`, or `.agents/skills/`                                               | [Configure Cursor](https://docs.datasentinel.io/manual/ai-connector/connect-an-ide/configure-cursor.md)                                           |
| Deep Agents Code           | `dcode skills list`             | `~/.agents/skills/` or `.agents/skills/`                                                                   | [Connect a compatible assistant](https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/connect-a-compatible-assistant.md)      |
| Hermes Agent               | `hermes skills list`            | `~/.hermes/skills/`                                                                                        | [Connect a compatible assistant](https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/connect-a-compatible-assistant.md)      |

A location under your home directory (`~/`) serves all your projects. A location relative to a project (`.claude/skills/`, `.agents/skills/`, `.github/skills/`) is seen only when the assistant runs in that project, and can be shared through Git.

## Update the Skill

`datasentinel version` prints the timestamp of the copy you are running, and where the latest one is published.

* **Skills folder.** Delete the old `datasentinel` folder, then extract the new archive in its place.
* **Upload.** The procedure depends on the assistant, and uploading again can leave two copies: follow your assistant's guide.

Keep one copy only. When two versions are installed in two locations, the assistant may read the older one. `datasentinel whoami` names the folder of the copy in use.

## Where to go next

{% content-ref url="/pages/wO1eq0rTY2OOkwRpABfh" %}
[Skill commands reference](https://docs.datasentinel.io/manual/ai-connector/use-the-assistant/skill-commands.md)
{% endcontent-ref %}

{% content-ref url="/pages/WOPggam0RhkApBZ9SOdY" %}
[The Skill did not load](https://docs.datasentinel.io/manual/ai-connector/troubleshooting/skill-not-loaded.md)
{% endcontent-ref %}


---

# 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.datasentinel.io/manual/ai-connector/install-the-skill.md?ask=<question>&goal=<user_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.
