> ## 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 **Organisation Settings** → **AI** → **Skills**.

## 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 **Organisation Settings** → **AI** → **Skills** 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).