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

FieldDescription
skillIdUnique within the org
titleDisplay name
descriptionWhat the skill is about
instructionsDetailed guidance for the person recording (rich text)
statuscapturing · processing · ready · archived
prioritynone · low · medium · high · urgent
assigneesMember IDs responsible for recording
deadlineOptional due date
trackedObjectsObjects the app should track during captures for this skill
outputsGenerated training outputs (SOPs, courses, policies, etc.)
tagsFree-form labels
icon / iconColorVisual 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 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