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

# Skills

> Reusable instructions that shape how an agent approaches a task.

A skill is a named, reusable set of instructions for a task you do more than once. Instead of writing the same context and steps into the composer every time, you save them once as a skill and bring them into any thread. This page covers running a skill, creating one, and managing it once it exists.

## Run a skill

Type `/` in any composer and pick a skill from the list. Its instructions become part of the thread, the same as if you'd typed them yourself.

## Create a skill

<Steps>
  <Step title="Start from scratch">
    Give the skill a name and write its instructions directly: what it's for and how it should approach the task.
  </Step>

  <Step title="Or import one you already have">
    Drag a folder or a `.zip` in instead of writing from scratch. Sidekick looks inside for a `SKILL.md` file and uses it to fill in the skill.
  </Step>

  <Step title="Paste it directly if import can't find one">
    If Sidekick can't find a `SKILL.md` in what you dropped, paste its contents in directly instead.
  </Step>
</Steps>

## Look inside a skill

Open a skill to see four tabs:

* **Instructions**: the text that runs when the skill is used.
* **Files**: supporting files bundled with the skill.
* **Runs**: the history of past runs of this skill.
* **Versions**: every saved edit to the skill, in order.

## Restore a version

<Steps>
  <Step title="Open the versions tab">
    Find the version you want to go back to.
  </Step>

  <Step title="Restore it">
    Restoring makes that version the current one. The versions in between aren't lost; they stay in the history.
  </Step>
</Steps>

## Share and pin

Share a skill so teammates can run it too, not just you. Pin the skills you use most so they sit at the top of the list instead of getting buried under everything else.

## Where to go next

<CardGroup cols={2}>
  <Card title="Govern skills" icon="wand-sparkles" href="/docs/sidekick/admin/govern-skills">
    How admins approve and manage the skills available across the workspace.
  </Card>

  <Card title="Thread and composer" icon="message-square" href="/docs/sidekick/use/thread-and-composer">
    The anatomy of a thread and how the composer sends work to it.
  </Card>
</CardGroup>