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

# AI Skills

> Teach Ankra's AI your conventions with organisation-scoped skills - reusable markdown instructions that override the platform defaults.

Skills are reusable markdown instructions the AI draws on during conversations - runbooks, add-on configuration templates, CI/CD pipeline conventions. Ankra ships a set of platform skills, and organisation admins can add their own or override the built-ins under **AI** → **Settings** → **Capabilities**.

## How Skills Resolve

Skills come in two tiers:

* **Platform skills** - built-in, read-only, maintained by Ankra.
* **Organisation skills** - created by your admins, scoped to your organisation.

An organisation skill with the **same name** as a platform skill shadows it - the AI uses your version instead. The skills page shows an **Override** badge on shadowing skills and a line-level diff against the platform original, with a one-click **Discard override** to restore the built-in.

## Creating a Skill

<Steps>
  <Step title="Open the editor">
    Go to **AI** → **Settings** → **Capabilities** and click **New skill** - or select a platform skill and click **Override** to start from its content.
  </Step>

  <Step title="Fill in the fields">
    * **Name** - lowercase letters, digits, hyphens/underscores (max 100 chars); matching a platform skill's name overrides it
    * **Description** - what the skill teaches (max 500 chars)
    * **Content** - the markdown instructions (max 200,000 chars); YAML frontmatter at the top marks add-on and CI/CD skills
    * **Kind** - `core`, `cicd`, or `addon`
    * **Add-on charts** - for `addon` skills, the chart names the skill applies to
    * **Always active** - inject the skill into every conversation instead of on demand
  </Step>

  <Step title="Save">
    The skill takes effect immediately - the AI's skill cache is refreshed on every change.
  </Step>
</Steps>

## Permissions

All members can browse skills; creating, editing, and deleting requires organisation **admin**. Platform skills cannot be edited or deleted - only overridden.

## Skills in the CLI and Editors

Separate from organisation skills, `ankra skills install` installs Ankra's curated Agent Skills into Cursor or Claude Code so your local AI agent follows Ankra's practices. See the [CLI reference](/reference/cli/skills).