> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qontext.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills distribution

> Create, publish, and install reusable AI instructions across your workspace

## Overview

A **skill** is a reusable package of instructions that an AI agent loads on demand. You can define a skill once with a name, description, and instructions body. The agent can activate it whenever a relevant task comes up.

In Qontext, skills are centrally managed in your workspace so they stay consistent across teams and machines. Team members install it once and keep everything up to date with a single command: `qontext skills sync`. Skills managed in Qontext are interoperable, so you can use them on any client that supports the open Agent Skills format.

***

## Anatomy of a skill

<div className="qontext-cards">
  <CardGroup cols={2}>
    <Card title="Name" icon="tag">
      A machine-readable identifier, lowercase with hyphens (e.g. `competitor-analysis`).
    </Card>

    <Card title="Description" icon="align-left">
      What the skill does and when to use it. The agent reads this at startup to decide when to activate the skill.
    </Card>

    <Card title="Instructions" icon="list-check">
      The full task instructions. Define what the agent should do, what data to draw on (data scope), and what format to produce (output format).
    </Card>

    <Card title="Supporting files" icon="folder-open">
      Optional scripts, reference documents, and templates, bundled in the skill folder and loaded only when needed.
    </Card>
  </CardGroup>
</div>

<Info>
  **Open format.**

  Qontext skills follow the open [Agent Skills specification](https://agentskills.io/specification). Skills work with any compatible AI tool and can be imported from a context repository.
</Info>

***

## Importing skills to Qontext

Use the [import-repo](https://github.com/qontext-ai/examples/blob/main/skills/import-repo) skill to migrate existing skills from GitHub or a local folder into your context repository.

<Info>
  **The import-repo skill is designed for initial imports.**

  After a successful import it removes itself from `~/.claude/skills/import-repo/`. To import again later, reinstall it from the [Qontext examples repository](https://github.com/qontext-ai/examples/tree/main/skills/import-repo).
</Info>

<Steps>
  <Step title="Install client">
    Make sure Claude Code or another client is installed. The import-repo skill detects and sets up the [Qontext MCP](/interfaces/MCP) automatically if it is not already configured. You will be prompted to complete an OAuth flow on first run.
  </Step>

  <Step title="Download import-repo skill">
    Download the [import-repo skill](https://github.com/qontext-ai/examples/tree/main/skills/import-repo) from the Qontext examples repository and place it in your Claude Code skills folder (`~/.claude/skills/import-repo/`).
  </Step>

  <Step title="Import skills">
    In Claude Code, ask it to import your skills:

    > "Import my skills from \[GitHub URL or local path] to Qontext."

    The skill guides you through scope, file handling, and target path, then bulk-imports everything into your workspace.
  </Step>

  <Step title="Go to Qontext">
    Once complete, the imported skills appear as files in the context repository, visible under **Context** in your workspace.
  </Step>
</Steps>

***

## Distributing skills

Once a skill is stored in Qontext, teammates can install it into compatible clients using the Qontext CLI (see [CLI](/interfaces/cli) and [GitHub](https://github.com/qontext-ai/cli)).

<Steps>
  <Step>
    Install the CLI:

    ```bash theme={null}
    curl -fsSL https://cli.qontext.ai | sh
    ```
  </Step>

  <Step>
    Log in to your workspace and approve the access request to your workspace:

    ```bash theme={null}
    qontext login
    ```

    <img src="https://mintcdn.com/qontext/j_mvy1O5QjlwxH-k/features/images/skills/cli_auth.png?fit=max&auto=format&n=j_mvy1O5QjlwxH-k&q=85&s=9884ea5318b119903700142620de5860" alt="CLI authentication" className="rounded-lg mt-4" style={{ maxWidth: '100%', height: 'auto' }} width="1262" height="686" data-path="features/images/skills/cli_auth.png" />
  </Step>

  <Step>
    Install a skill by passing its link to the CLI:

    ```bash theme={null}
    qontext skills add <link>
    ```

    To get the link, open the **Context** tab in the app, select a skill, and click **Install skill**. You can then copy either the full install command or the short link.

    <img src="https://mintcdn.com/qontext/j_mvy1O5QjlwxH-k/features/images/skills/install_skill.png?fit=max&auto=format&n=j_mvy1O5QjlwxH-k&q=85&s=715d149824c896c56b0170e8f7a1b3a0" alt="Install skill button showing copy install command and copy short link options" className="rounded-lg mt-4" style={{ maxWidth: '100%', height: 'auto' }} width="1477" height="1242" data-path="features/images/skills/install_skill.png" />
  </Step>

  <Step>
    To keep skills up to date, use:

    ```bash theme={null}
    qontext skills sync
    ```
  </Step>
</Steps>