Do I need to be authenticated?

Yes. The skill expects you to first assume identity via the identity skill so workspace credentials are available.

Can I automate without prompts?

Yes. Use --no-interactive to run in automation, and provide all required options.

How should long descriptions be provided?

Use --description-file to read Markdown content from a file, or provide -d inline for shorter descriptions.

linear-issue-create

npx machina-cli add skill bryanp/agent-skills/create --openclaw

Files (1)

SKILL.md

1.7 KB

Use the linear issue create command to create an issue.

Rule: Identity

First use the identity skill to assume the identity of the agent.

Usage

Usage:   linear issue create
Version: 1.10.0

Description:

  Create a linear issue

Options:

  -h, --help                                - Show this help.
  -w, --workspace            <slug>         - Target workspace (uses credentials)
  --start                                   - Start the issue after creation
  -a, --assignee             <assignee>     - Assign the issue to 'self' or someone (by username or name)
  --due-date                 <dueDate>      - Due date of the issue
  -p, --parent               <parent>       - Parent issue (if any) as a team_number code
  --priority                 <priority>     - Priority of the issue (1-4, descending priority)
  --estimate                 <estimate>     - Points estimate of the issue
  -d, --description          <description>  - Description of the issue
  --description-file         <path>         - Read description from a file (preferred for markdown content)
  -l, --label                <label>        - Issue label associated with the issue. May be repeated.
  --team                     <team>         - Team associated with the issue (if not your default team)
  --project                  <project>      - Name of the project with the issue
  -s, --state                <state>        - Workflow state for the issue (by name or type)
  --no-use-default-template                 - Do not use default template for the issue
  --no-interactive                          - Disable interactive prompts
  -t, --title                <title>        - Title of the issue

Source

git clone https://github.com/bryanp/agent-skills/blob/main/code/linear/issue/create/SKILL.mdView on GitHub

Overview

Use the linear-issue-create skill to add new issues to a Linear workspace from the command line. It supports title, description, assignee, due date, priority, estimate, labels, project, and state, including reading long content from a file or running non-interactively. It starts by assuming your identity via the identity skill.

How This Skill Works

The skill runs the linear issue create command with the chosen flags (for example, -t/--title, -d/--description, -a/--assignee, --due-date, --priority, --estimate, -l/--label, --project, -s/--state, --start). It uses your workspace credentials to create the issue and places it in the specified project and workspace.

When to Use It

When you need to quickly create a new Linear issue from chat as soon as a task is discussed.
When you want to assign the issue to a teammate and set priority and due date.
When the description is long or markdown-heavy and you want to read it from a file via --description-file.
When automating issue creation and you want to avoid prompts with --no-interactive.
When you want the issue to start in the workflow immediately after creation using --start.

Quick Start

Step 1: Use the identity skill to assume your agent's identity for the run.
Step 2: Run linear issue create with at least a --title and --workspace, adding other options as needed.
Step 3: Confirm the issue was created in the target project and workspace; adjust as needed.

Best Practices

Always include a clear, concise title with -t/--title.
Use --description-file for long Markdown content to keep descriptions readable.
Specify --workspace and --project to ensure the issue lands in the correct place.
Use --start when you want the issue to move into the workflow right away.
In automation, pass --no-interactive to prevent prompts and failures.

Example Use Cases

linear issue create -t 'Bug: crash on launch' -w acme -p 'Mobile' -s 'Backlog' -a 'jane' --description-file ./issues/launch-crash.md --priority 2 --estimate 3 --start
linear issue create -t 'Implement OAuth2 login' -w acme -p 'Auth' -s 'Todo' -a 'devs' --description 'Implement OAuth2 flow with PKCE' --priority 1 --due-date 2026-03-20
linear issue create -t 'Refactor payment module' -w acme -p 'Backend' -s 'In Progress' -a 'backend-team' --description-file ./docs/payment-refactor.md --team 'Payments' --estimate 8
linear issue create -t 'Create release notes for v2.3' -w acme -p 'Website' -s 'Planning' --description-file ./RELEASE_NOTES_v2.3.md --start
linear issue create -t 'Accessibility audit' -w acme -p 'Frontend' -s 'Backlog' -l 'a11y' --no-interactive

Frequently Asked Questions

Add this skill to your agents