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

# AI Skills

> Browse, configure, create, import, and export specialized AI assistant skills for your organization.

The AI Skills screen manages AI assistant skill definitions at the route `/settings/ai-skills`.

## Overview

The screen displays all AI skills (system-provided and custom) in a categorized tab layout covering All, Compliance, Housing, HR, Finance, Operations, and General. A search input filters by name, description, or skill code. Users with `pf.ai_skills.manage` can configure, edit, create (via wizard), import (SKILL.md format), and export skills. System and custom skills are grouped into separate sections within each tab.

<Frame caption="The AI Skills admin list at `/settings/ai-skills`. The **System Skills** section lists the seeded standard catalog (e.g. “Incident Report Writer”) above your organization's custom skills; the “Search skills…” box and the category tabs (All, Compliance, Housing, HR, Finance, Operations, General) filter the grid.">
  <img src="https://mintcdn.com/encoreos/FHgwdEuPbyKq-W7P/images/pf/pf-62-ai-skills-list.png?fit=max&auto=format&n=FHgwdEuPbyKq-W7P&q=85&s=817e7b54e475f8b1498a839eb213f677" alt="AI Skills admin list showing the System Skills standard catalog above organization custom skills" width="1503" height="5955" data-path="images/pf/pf-62-ai-skills-list.png" />
</Frame>

## Who it's for

Required permission: `pf.ai_skills.view` (view); `pf.ai_skills.manage` (create/edit/import/export)

## Before you start

* You must hold the `pf.ai_skills.view` permission to access this screen.
* Management actions (Create, Import, Edit, Export) require `pf.ai_skills.manage`.
* Organization admins are granted both `pf.ai_skills.view` and `pf.ai_skills.manage` by default. If your admin account does not see AI Skills, ask a platform admin to re-sync your organization's permissions.

## Steps

<Steps>
  <Step title="Open AI Skills">Navigate to Settings → AI Skills.</Step>
  <Step title="Browse or search">Use the category tabs or search box to find a skill by name, description, or code.</Step>
  <Step title="Configure a skill">Click a skill card's configure action to open the configuration dialog and adjust settings.</Step>
  <Step title="Create a custom skill">Click "Create Skill" to open the creation wizard and define a new custom skill.</Step>
  <Step title="Import a skill">Click "Import" and upload a SKILL.md file to add an externally authored skill.</Step>
  <Step title="Export a skill">Use the export action on a skill card to download it as a `<skill_code>.SKILL.md` file.</Step>
</Steps>

## Configure a standard skill

From a standard skill's card, open **Configure** to apply an organization-specific override — enable/disable, custom instructions, model, and a knowledge-base RAG toggle — **without mutating the shared platform catalog**. The override is saved to `pf_ai_skill_overrides` and merged onto the base skill at runtime.

<Frame caption="The **Configure Skill** dialog (`SkillConfigurationDialog`), opened from a standard skill card. It applies an organization override — the **Enable skill** toggle plus custom instructions, model, and knowledge-base RAG settings — customizing a platform skill for your org without editing the shared catalog.">
  <img src="https://mintcdn.com/encoreos/FHgwdEuPbyKq-W7P/images/pf/pf-62-skill-configuration.png?fit=max&auto=format&n=FHgwdEuPbyKq-W7P&q=85&s=9b22c2f2d6532cb7f164d8936aec0f82" alt="Configure Skill dialog showing the Enable skill toggle and org-override fields for a standard catalog skill" width="1503" height="5955" data-path="images/pf/pf-62-skill-configuration.png" />
</Frame>

## Key concepts

* `skill_code` — unique identifier for each skill
* `is_system` — distinguishes platform-provided skills from organization-custom skills
* SKILL.md — serialized skill format for import/export

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/platform.tsx
  * src/platform/ai/pages/AISkillsListPage.tsx
</Accordion>