Check a GitHub Actions workflow and pin every action to a commit SHA (live)
tack_check_workflowUse when the user asks to write, review, fix or harden a GitHub Actions workflow (.github/workflows/*.yml) or a composite action.yml, or when a workflow was just written or edited and is about to be committed (signals: "write a CI workflow", "why does my workflow fail", "Invalid workflow file", "Unexpected input", "pin actions to SHA", "is actions/checkout@v4 still current", "Node 20 deprecated", "upload-artifact v3", "runs-on ubuntu-20.04", "script injection", "pull_request_target"). Parses the YAML (errors with line and column, duplicate keys, anchors), checks the structure against GitHub's workflow syntax as documented on 2026-11-19 (including recent keys such as schedule timezone, cache-mode, background, wait, wait-all, cancel, parallel and $/ self-repository references), then resolves every uses: reference live on github.com: whether the repository, tag, branch or commit exists, which release a SHA is, the latest release, retired versions that make a job fail (upload/download-artifact v3 and older, actions/cache v1-v2 and old exact pins), runs.using node20-or-older runtimes, with: inputs the action does not declare (with a did-you-mean), missing required inputs, reusable-workflow inputs, and pinned-SHA comments that name the wrong version. Also flags retired runner labels (live runner-images list), script injection through ${{ github.event... }} in run:, pull_request_target checkouts of PR code, and a missing permissions key. Returns each finding with line, path, fix and doc link, per-action resolution, fix_message, and pinned_workflow: the same file with every action pinned to its full commit SHA and a # version comment (retired or missing refs move to the latest release; upgrade:true moves all). Example: {"workflow":"on: push\njobs:\n test:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - uses: actions/setup-node@v4\n with:\n node_version: 20"}. Does not run the workflow, evaluate expressions or see private repositories, secrets or repository settings. Up to 200000 characters.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workflow": "<workflow>"
},
"name": "tack_check_workflow"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | auto (default) detects a workflow (jobs:) or an action metadata file (runs:). | |
| live | No | Resolve actions, inputs and runner labels on github.com. Default true; false = offline YAML and syntax checks only. | |
| upgrade | No | Pin every action to its latest release instead of the version the file uses. Default false (retired or missing refs are moved to the latest release either way). | |
| workflow | Yes | The YAML text of a workflow file (.github/workflows/<name>.yml) or of an action.yml / action.yaml. |