# import_skill

## nominal.experimental.analyst.import_skill(client, path, *, enabled=True, workspace=None)

Create a skill from a folder with SKILL.md at its top level, or a .zip holding one such folder.

Files are read the way the app’s Import Skills reads them, skipping paths with a part that starts with “.”,
such as `.git`. Folder imports also skip symbolic links and files reached through them.
Every file is read before anything is saved.

Parameters:
:   - **client** ([*NominalClient*](https://dev.nominal.io/python/ref/generated/nominal.core.NominalClient.md#nominal.core.NominalClient "nominal.core.client.NominalClient"))

      Authenticated Nominal client.
    - **path** ([*Path*](https://docs.python.org/3/library/pathlib.html#pathlib.Path "(in Python v3.15)") *|* [*str*](https://docs.python.org/3/builtins/stdtypes.html#str "(in Python v3.15)"))

      The skill’s folder, or a .zip of it.
    - **enabled** ([*bool*](https://docs.python.org/3/builtins/functions.html#bool "(in Python v3.15)"))

      Whether the skill starts turned on. Defaults to True.
    - **workspace** ([*Workspace*](https://dev.nominal.io/python/ref/generated/nominal.core.Workspace.md#nominal.core.Workspace "nominal.core.workspace.Workspace") *|* [*str*](https://docs.python.org/3/builtins/stdtypes.html#str "(in Python v3.15)") *|* *None*)

      Workspace or workspace RID for the skill. Defaults to the client’s default workspace.

Return type:
:   [*Skill*](https://dev.nominal.io/python/ref/generated/nominal.experimental.analyst.Skill.md#nominal.experimental.analyst.Skill "nominal.experimental.analyst._skill.Skill")

The skill is created as [`create_skill()`](https://dev.nominal.io/python/ref/generated/nominal.experimental.analyst.create_skill.md#nominal.experimental.analyst.create_skill "nominal.experimental.analyst.create_skill") creates it.

Raises:
:   - [**ValueError**](https://docs.python.org/3/builtins/exceptions.html#ValueError "(in Python v3.15)") – If the folder or .zip has no SKILL.md, the .zip holds more than one skill folder, a file is
      not UTF-8 text, SKILL.md has no frontmatter with a valid name, or `enabled` is True and SKILL.md has
      no description of 1 to 1024 UTF-16 code units. Nothing is saved.
    - [**NominalPermissionDeniedError**](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalPermissionDeniedError.md#nominal.exceptions.NominalPermissionDeniedError "nominal.exceptions.NominalPermissionDeniedError") – If the user can’t edit the workspace’s configuration, which creating a
      skill needs. Nothing is saved.
    - [**NominalAlreadyExistsError**](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalAlreadyExistsError.md#nominal.exceptions.NominalAlreadyExistsError "nominal.exceptions.NominalAlreadyExistsError") – If the workspace already has a skill with this name. Nothing is saved.

Return type:
:   [*Skill*](https://dev.nominal.io/python/ref/generated/nominal.experimental.analyst.Skill.md#nominal.experimental.analyst.Skill "nominal.experimental.analyst._skill.Skill")
