<!-- # hard line break macro for HTML -->

# fiftyone.plugins.skills

FiftyOne plugin skills.

Copyright 2017-2026, Voxel51, Inc.
<br/>
[voxel51.com](https://voxel51.com/)
<br/>
<br/>

**Classes:**

| [`SkillDefinition`](#fiftyone.plugins.skills.SkillDefinition)(path, metadata, plugin_name)   | A skill definition.   |
|----------------------------------------------------------------------------------------------|-----------------------|

**Functions:**

| [`list_skills`](#fiftyone.plugins.skills.list_skills)([enabled, plugin, category])   | Lists available skills from installed plugins.   |
|--------------------------------------------------------------------------------------|--------------------------------------------------|

### *class* fiftyone.plugins.skills.SkillDefinition(path, metadata, plugin_name)

Bases: `object`

A skill definition.

* **Parameters:**
  * **path** – the absolute path to the skill’s Markdown file
  * **metadata** – a skill metadata dict parsed from the file’s YAML
    frontmatter
  * **plugin_name** – the name of the plugin that provides this skill

**Attributes:**

| [`name`](#fiftyone.plugins.skills.SkillDefinition.name)               | The name of the skill.                           |
|-----------------------------------------------------------------------|--------------------------------------------------|
| [`description`](#fiftyone.plugins.skills.SkillDefinition.description) | The description of the skill.                    |
| [`category`](#fiftyone.plugins.skills.SkillDefinition.category)       | The category of the skill.                       |
| [`path`](#fiftyone.plugins.skills.SkillDefinition.path)               | The absolute path to the skill file.             |
| [`plugin_name`](#fiftyone.plugins.skills.SkillDefinition.plugin_name) | The name of the plugin that provides this skill. |
| [`content`](#fiftyone.plugins.skills.SkillDefinition.content)         | The full raw content of the skill file.          |

**Methods:**

| [`to_dict`](#fiftyone.plugins.skills.SkillDefinition.to_dict)()   | Returns a JSON dict representation of the skill.   |
|-------------------------------------------------------------------|----------------------------------------------------|

#### *property* name

The name of the skill.

#### *property* description

The description of the skill.

#### *property* category

The category of the skill.

#### *property* path

The absolute path to the skill file.

#### *property* plugin_name

The name of the plugin that provides this skill.

#### *property* content

The full raw content of the skill file.

#### to_dict()

Returns a JSON dict representation of the skill.

* **Returns:**
  a JSON dict

### fiftyone.plugins.skills.list_skills(enabled=True, plugin=None, category=None)

Lists available skills from installed plugins.

* **Parameters:**
  * **enabled** (*True*) – whether to include only enabled plugins (True),
    only disabled plugins (False), or all plugins (`"all"`)
  * **plugin** (*None*) – a plugin name or list of plugin names to include.
    By default, skills from all plugins are included
  * **category** (*None*) – a category or list of categories to filter by.
    By default, skills of all categories are included
* **Returns:**
  a list of [`SkillDefinition`](#fiftyone.plugins.skills.SkillDefinition) instances