# linear_agent_skill (Resource)

Manages a Linear agent skill — a named instruction agents can be asked to follow.

Scope it to a team via `team_id`, or leave that unset to make it available across the workspace.

## Example Usage

```terraform
resource "linear_agent_skill" "conventional_commits" {
  team_id = linear_team.engineering.id
  title   = "Conventional Commits"

  body = <<-EOT
    Write every commit message as a Conventional Commit.

    - `feat(scope): …` for a new capability
    - `fix(scope): …` for a bug fix
    - Breaking changes carry a `!` after the scope
  EOT
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `body` (String) Instructions the skill carries, as Markdown.

### Optional

- `color` (String) Colour of the skill icon as a hex string.
- `icon` (String) Icon of the skill.
- `team_id` (String) UUID of the team the skill belongs to. Leave unset for a workspace-wide skill.
- `title` (String) Title of the skill.

### Read-Only

- `description` (String) Short description of what the skill does, as Linear derives it.
- `id` (String) UUID of the skill.
- `shared` (Boolean) Whether the skill is shared beyond its owner.
- `slug_id` (String) URL slug of the skill.

## Import

Import is supported using the following syntax:

The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:

```shell
# Import by UUID.
terraform import linear_agent_skill.example a1b2c3d4-0000-0000-0000-000000000000
```