From de214f568d335a76ef9d6a267d4f0afea841fa14 Mon Sep 17 00:00:00 2001
From: Romain Cascino <romain@linear.app>
Date: Wed, 25 Feb 2026 14:51:59 +0000
Subject: [PATCH] Proper inputs for GH action in skills and examples

---
 examples/github-actions-scheduled.yml | 16 ++++++++--------
 skills/linear-release-setup/SKILL.md  | 12 ++++++++++++
 2 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/examples/github-actions-scheduled.yml b/examples/github-actions-scheduled.yml
index 946d63a..1b08116 100644
--- a/examples/github-actions-scheduled.yml
+++ b/examples/github-actions-scheduled.yml
@@ -22,8 +22,8 @@ on:
       - "release/**"
   workflow_dispatch:
     inputs:
-      action:
-        description: "Release action"
+      command:
+        description: "Release command"
         required: true
         type: choice
         options:
@@ -33,7 +33,7 @@ on:
         description: "Release stage (for update, e.g. qa)"
         required: false
         type: string
-      release_version:
+      version:
         description: "Release version"
         required: true
         type: string
@@ -62,22 +62,22 @@ jobs:
         if: github.event_name == 'push' && startsWith(github.ref_name, 'release/')
         with:
           access_key: ${{ secrets.LINEAR_ACCESS_KEY }}
-          release_version: ${{ env.RELEASE_VERSION }}
+          version: ${{ env.RELEASE_VERSION }}
 
       # Branch creation: auto-promote to code freeze
       - uses: linear/linear-release-action@v0
         if: github.event_name == 'push' && startsWith(github.ref_name, 'release/') && github.event.created
         with:
           access_key: ${{ secrets.LINEAR_ACCESS_KEY }}
-          action: update
+          command: update
           stage: code freeze
-          release_version: ${{ env.RELEASE_VERSION }}
+          version: ${{ env.RELEASE_VERSION }}
 
       # Manual: run the specified action (later stages, completion)
       - uses: linear/linear-release-action@v0
         if: github.event_name == 'workflow_dispatch'
         with:
           access_key: ${{ secrets.LINEAR_ACCESS_KEY }}
-          action: ${{ inputs.action }}
+          command: ${{ inputs.command }}
           stage: ${{ inputs.stage }}
-          release_version: ${{ inputs.release_version }}
+          version: ${{ inputs.version }}
diff --git a/skills/linear-release-setup/SKILL.md b/skills/linear-release-setup/SKILL.md
index 904e14b..47b597c 100644
--- a/skills/linear-release-setup/SKILL.md
+++ b/skills/linear-release-setup/SKILL.md
@@ -96,6 +96,18 @@ Stages can be **frozen** in Linear. A frozen stage makes `sync` (without `--rele
 | `update`   | Move release to a stage            | `--stage` (required), `--release-version`        |
 | `complete` | Mark release as complete           | `--release-version`                              |
 
+### GitHub Action Inputs
+
+When using `linear/linear-release-action@v0`, inputs map to CLI flags as follows:
+
+| CLI flag             | Action input                         |
+| -------------------- | ------------------------------------ |
+| (command positional) | `command`                            |
+| `--name`             | `name`                               |
+| `--release-version`  | `version` (alias: `release_version`) |
+| `--stage`            | `stage`                              |
+| `--include-paths`    | `include_paths`                      |
+
 ### Path Filtering (Monorepos)
 
 Path filters can be configured in Linear's pipeline settings or via the CLI's `--include-paths` flag (CLI takes precedence if both are set). If the user has already configured paths in Linear, the CLI flag is optional.