Skip to main content
Skills are procedural playbooks (SKILL.md files) loaded by the agent to give it reusable, named instructions for a task. The Skills page lets you browse every skill registered in your workspace, upload new ones, and share an existing skill with more datasets. Open it from the sidebar, where it is nested under Datasets — the entry unfolds while you are inside the Datasets subtree or on the page itself. Skills are scoped to datasets — a skill is attached to one or more datasets, and the same skill can be copied into additional datasets.

​
Browse skills

The page is a two-column browser:
  • Datasets (left) — every dataset that has at least one skill registered. Datasets without skills are hidden. Select a dataset to see its skills.
  • Skills (right) — the skills registered in the selected dataset, grouped by their maintainer.
Use the search box to filter by skill name, maintainer, description, or tag. A green dot marks an active skill; a grey dot marks an inactive one.

​
Skill detail

Click a skill row to expand it. The detail view shows:
  • Description and metadata — maintainer (linked to its homepage or repository when a URL is provided), version, license, source repository, and the number of datasets the skill is attached to.
  • Declared tools — the tools the skill is allowed to invoke.
  • Procedure — the full skill instruction body, fetched on demand when you expand the row.

​
Add a skill

Click Add skill (enabled once you have at least one dataset) to open the upload dialog:
  1. Enter a name for the skill. The name is slugified into the ingestion path (for example, Weather lookup becomes weather-lookup/SKILL.md).
  2. Provide the content — either upload a .md file or paste the skill markdown directly.
  3. Select one or more datasets to attach the skill to.
  4. Submit. The result is reported per dataset, so you can see which datasets the skill was added to successfully.
Adding a skill is idempotent per dataset and name: if you add a skill with a name that already exists in the selected dataset, the existing skill is updated with the new content instead of a second copy appearing in the list. That makes the dialog the way to edit a skill — re-add it with the same name and the revised markdown. Adding the same name to a different dataset still creates a separate skill, which is what the share flow below relies on.

​
Share a skill with more datasets

Each skill row has a share control (“Add this skill to more datasets”). It opens a dialog listing the datasets the skill is not yet attached to. Select one or more destination datasets to copy the skill into them; the outcome is reported per dataset.
Skills are ingested through the same path as the content_type: "skills" option of the ingestion API — see Data Ingestion.