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

# Getting Started with Agent Skills

> Install the Skills Manager Toolkit, create your first custom skill, or add a pre-built skill.

Give your agents an instant upgrade. Agent Skills let you drop specialized knowledge and workflows directly into any agent — no rebuilding, no reprompting. In just a few steps, you can equip your agents with pre-built skills from the library or craft your own to match exactly how your team works.

## Install the Skills Manager Toolkit

There are two ways to install the **Skills Manager Toolkit**:

<Tabs>
  <Tab title="Skills Tab">
    <Steps>
      <Step title="Open your agent's configuration">
        Navigate to the **Skills** tab.
      </Step>

      <Step title="Install the Skills Manager Toolkit">
        Tick the checkbox to install the **Skills Manager Toolkit**. A toast notification will confirm that the toolkit has been added to your agent.<br /><img src="https://mintlify.s3.us-west-1.amazonaws.com/odinai/img/agents/agent-skills/add-skill-manager-skill-tab.png" alt="Install Skills Manager Toolkit from Skills Tab" />
      </Step>
    </Steps>
  </Tab>

  <Tab title="Toolkits Tab">
    <Steps>
      <Step title="Open your agent's configuration">
        Navigate to the **Toolkits** tab.
      </Step>

      <Step title="Search for the Skills Manager Toolkit">
        Use the search bar to find the **Skills Manager Toolkit**.
      </Step>

      <Step title="Add to agent">
        Click **Add to agent**.<br /><img src="https://mintlify.s3.us-west-1.amazonaws.com/odinai/img/agents/agent-skills/toolkit-skills-manager.png" alt="Install Skills Manager Toolkit from Toolkits Tab" />
        <Info>A toast notification will confirm that the toolkit has been added.</Info>
      </Step>
    </Steps>
  </Tab>
</Tabs>

Once installed, click **Browse Library** to discover pre-built skills, or click **+ Add Skill** to create your own.

<Warning>
  Agent Skills is a toolkit and is charged at 1 credit per tool call invoked. For more details, see our [credits documentation](/general/credits).
</Warning>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/odinai/img/agents/agent-skills/skills-tab.png" alt="Skills Tab" />

## Browse Pre-Built Skills in the Library

<Card title="Skills Library" icon="books" href="agent-skills-library">
  Browse all pre-built skills available out of the box, organized by category.
</Card>

## Create a Custom Skill

To create a new skill, open the **Skills** section and click **Create Skill**. Fill in the following fields:

<Steps>
  <Step title="Name">
    Enter a unique identifier for your skill using lowercase letters, numbers, and hyphens only (1–64 characters). Leading, trailing, or consecutive hyphens are not allowed.

    ```
    e.g. github-ops
    ```

    <Tip>
      See [Agent Skills name rules](https://agentskills.io/specification#name-field) for the full naming specification.
    </Tip>
  </Step>

  <Step title="Description">
    Write a clear explanation of what the skill does and when to use it. Include keywords that agents can match on — this text is what the agent reads during the Discovery stage to decide whether to activate the skill.
    Description must be between 1–1024 characters and cannot be empty.

    <Tip>
      See [Agent Skills description rules](https://agentskills.io/specification#description-field) for guidance on writing effective descriptions.
    </Tip>
  </Step>

  <Step title="Triggers">
    Add one or more keywords or `/regex/` patterns that will activate this skill. Press **Enter** or **comma** after each trigger to add it.
    Triggers are optional — if left empty, the skill will only activate via the **Always On** setting (see below).

    ```
    e.g. code review, review my code, /review\s+PR/i
    ```
  </Step>

  <Step title="Content">
    Write the skill instructions in markdown. This is the full `SKILL` content loaded into the agent's context when the skill is activated. Be specific — step-by-step instructions with clear formatting produce the most reliable agent behavior.

    ```md theme={null}
    # My Skill
    When asked to do X:
    1. First, do Y
    2. Then, do Z
    ```
  </Step>

  <Step title="Allowed Tools">
    Click **Select tools** to choose which agent toolkits this skill is permitted to use (e.g. `knowledge base`, `web search`, `database`). If no tools are selected, the skill runs on the agent's context alone.
  </Step>

  <Step title="Category">
    Select a category from the dropdown to organize the skill in the library. Defaults to **None** if left unset.
  </Step>

  <Step title="Always On (optional)">
    Toggle **Always On** to inject this skill's instructions into every conversation turn, regardless of whether a trigger keyword is matched. Use this for skills that should apply globally, such as tone guidelines or compliance rules.
  </Step>

  <Step title="Create">
    Once all required fields are filled in, click **Create** to save the skill and make it available to your agents.
  </Step>
</Steps>