Skip to main content
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

1

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.
2

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
3

Save

The skill takes effect immediately — the AI’s skill cache is refreshed on every change.

​
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.