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

# Skills

> Org-scoped tasks that captures are recorded against.

A **Skill** is the central organizing unit of a Holos workflow. It represents a real-world procedure or task that an organization wants to capture and eventually train on. Skills have assignees, deadlines, status tracking, and a list of tracked objects, which makes them the coordination layer between managers who define what to capture and field operators who go record it.

## Key fields

| Field                | Description                                                 |
| -------------------- | ----------------------------------------------------------- |
| `skillId`            | Unique within the org                                       |
| `title`              | Display name                                                |
| `description`        | What the skill is about                                     |
| `instructions`       | Detailed guidance for the person recording (rich text)      |
| `status`             | `capturing` · `processing` · `ready` · `archived`           |
| `priority`           | `none` · `low` · `medium` · `high` · `urgent`               |
| `assignees`          | Member IDs responsible for recording                        |
| `deadline`           | Optional due date                                           |
| `trackedObjects`     | Objects the app should track during captures for this skill |
| `outputs`            | Generated training outputs (SOPs, courses, policies, etc.)  |
| `tags`               | Free-form labels                                            |
| `icon` / `iconColor` | Visual identity in the dashboard                            |

## Lifecycle

Skills start in `capturing` status. As captures are recorded and reviewed, the skill progresses to `processing` and eventually `ready` when outputs have been generated. Skills can be `archived` to remove them from active views without deletion.

## Tracked objects

The `trackedObjects` array links `HolosObject` records to the skill. When a capture session is started under a skill, the Holos Capture app downloads the `.referenceobject` file for each linked object so that the app can track them.

See [Objects](/domains/objects) for detail on what makes an object trackable.

## Endpoints

Full endpoint reference is available in the OpenAPI spec. Key operations:

* `GET /api/org/:orgId/skills` — list skills, filterable by status
* `POST /api/org/:orgId/skills` — create a skill
* `GET /api/org/:orgId/skills/:skillId` — get a skill
* `PATCH /api/org/:orgId/skills/:skillId` — update a skill
* `DELETE /api/org/:orgId/skills/:skillId` — archive a skill