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

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

#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 can be used, for example:

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