Workflow, runner, and YAML errors - diagnosed and fixed.

"Error: missing webhook"Fix 8398a7/action-slack failing because the SLACK_WEBHOOK_URL secret was not provided in the step env. "This action can only be run on pull_request events"Fix actions/dependency-review-action failing because it was triggered on a non-pull_request event. "Error: not found label"Fix actions/labeler "not found label" when the config references a label that does not exist in the repo. "Could not load credentials... Region is not set"Fix aws-actions/configure-aws-credentials failing because no aws-region was provided. "could not find a release for the requested version"Fix azure/setup-helm failing to resolve a pinned Helm version that does not exist or is unreachable. skip a scheduled run conditionallyConditionally skip a GitHub Actions scheduled run - because cron only runs on the default branch, use event n… cron day-of-week vs day-of-monthWrite a GitHub Actions cron that runs on a specific weekday or day of month - understand how the day-of-month… "tag is needed when pushing to registry"Fix docker/build-push-action failing because the tags input is empty while push is true. schedule fires twice or not at allFix GitHub Actions scheduled workflows that occasionally run twice or skip a slot - schedule delivery is best… nightly failures flood your inboxReduce email spam from a failing GitHub Actions scheduled workflow - a broken nightly job emails you every da… every-minute schedule does not runFix a GitHub Actions high-frequency schedule that does not run every minute - the shortest reliable interval… "mapping where sequence expected"Fix "A mapping was found where a sequence is expected" - a list-typed key like steps or jobs.<id>.needs was w… "Step cannot have both uses and run"Fix GitHub Actions "a step cannot have both the uses and run keys" - a single step mixed an action reference… "add-path is deprecated"Fix the GitHub Actions error where the legacy "::add-path::" workflow command no longer updates PATH and must… "Action could not be found at the URI"Fix GitHub Actions "An action could not be found at the URI" - the uses reference points at a repo, ref, or p… "Anchors are not currently supported"Fix the GitHub Actions error "Anchors are not currently supported" caused by using YAML anchors and aliases,… "Argument list too long"Fix the GitHub Actions "Argument list too long" failure - a command was invoked with more arguments than the… "Heredoc delimiter appears in the value"Fix GitHub Actions "matching delimiter not found" / heredoc delimiter collision when writing a multiline valu… "Can't find 'action.yml'"Fix GitHub Actions "Can't find 'action.yml', 'action.yaml' or 'Dockerfile' under X" in CI - a local `uses:` p… "Can't find action.yml"Fix the GitHub Actions error where uses: points to a reference that has no action.yml, a missing repo, or a m… "higher priority waiting request exists"Fix the GitHub Actions message where a run is canceled by a concurrency group because a newer request in the… "main not found"Fix GitHub Actions JavaScript action errors where the runner cannot find the main entrypoint - an unbuilt dis… "workflow_dispatch not available"Fix a missing Run workflow button or dispatch error caused by the workflow_dispatch trigger not existing on t… "Context access might be invalid"Fix the actionlint warning "Context access might be invalid" for GitHub Actions caused by referencing a secre… "could not find expected ':'"Fix GitHub Actions "could not find expected ':'" in CI - the YAML scanner reached the end of a key without th… "Unrecognized named-value: env"Fix "the env context is not available" when calling a reusable workflow in CI - job-level uses, with, and sec… "environment must be a string"Fix the GitHub Actions error where the job environment value is given as a mapping or list instead of a strin… "error parsing called workflow"Fix "error parsing called workflow ... invalid value ... uses" in CI - the uses value that calls a reusable w… "secret ... is not defined"Fix GitHub Actions "error parsing called workflow ... secret 'X' is not defined" in CI - the caller passed a… "Error when evaluating 'strategy'"Fix "Error when evaluating 'strategy' for job X" in CI - an expression inside strategy (often fromJSON) faile… "step needs uses or run"Fix GitHub Actions "every step must define a `uses` or `run` key" - a step with only name/if/env but no actio… "every step must define a uses or run key"Fix the GitHub Actions "every step must define a uses or run key" validation error caused by a step that has… "fatal: detached HEAD"Fix GitHub Actions git operations failing because actions/checkout leaves the repo on a detached HEAD at a sp… "not in a git directory"Fix GitHub Actions "fatal: not in a git directory" - git commands ran before actions/checkout, or in a workin… "found character that cannot start any token"Fix GitHub Actions "found character '\t' that cannot start any token" in CI - a tab was used for indentation,… "fromJson: Unable to parse"Fix GitHub Actions "Unable to parse" from fromJSON in CI - the string handed to fromJSON was not valid JSON,… "is not defined in the ... reusable workflow"Fix "invalid input, X is not defined in the referenced reusable workflow" in CI - the caller passed a with: k… "Input required and not supplied: github-token"Fix GitHub Actions "Input required and not supplied: github-token" - an action needs a github-token input tha… "Unrecognized named-value: inputs"Fix "Unrecognized named-value: inputs" in a job-level if that guards a reusable-workflow call in CI - the cal… "Invalid cron"Fix the GitHub Actions invalid cron error on an on: schedule trigger caused by a malformed five-field POSIX c… "Invalid format" for timeout-minutesFix the GitHub Actions invalid format error for timeout-minutes caused by a non-numeric value or an expressio… "options for container not valid"Fix the GitHub Actions error where container.options contains a flag the runner rejects, such as a reserved o… "Invalid pattern"Fix GitHub Actions "Invalid pattern `x`" - a malformed glob in a paths, paths-ignore, branches, or tags filte… "Invalid pattern" (paths)Fix "Invalid pattern" in GitHub Actions paths/paths-ignore filters - an unsupported glob or character broke t… "Invalid type" for env / withFix the GitHub Actions "Invalid type" error for env or with values caused by passing a list or mapping where… "called workflow ... not found"Fix "Invalid workflow file ... the workflow ... was not found" in CI - the path or ref in a reusable-workflow… "error in your yaml syntax"Fix the GitHub Actions "Invalid workflow file: You have an error in your yaml syntax" message caused by tabs,… "Invalid workflow file"Fix GitHub Actions "Invalid workflow file" errors - bad indentation, tabs, missing keys, or malformed YAML th… job "uses" and "steps" togetherFix "a job that calls a reusable workflow cannot have steps" in CI - a job may either call a reusable workflo… "depends on unknown job"Fix GitHub Actions "Job 'x' depends on unknown job 'y'" - a needs: entry naming a job that was renamed, remov… "depends on unknown job"Fix the GitHub Actions "Job X depends on unknown job Y" error caused by a needs reference that points to a jo… "needs unknown job"Fix GitHub Actions "Job X depends on unknown job Y" and skipped-dependency errors - a misspelled needs target… "matrix" exceeds 256Fix the GitHub Actions error where a single job matrix expands to more than 256 entries. "Job has been skipped"Fix a GitHub Actions job that is skipped because a job in its needs was skipped or failed - downstream jobs s… "steps must be a sequence"Fix "Invalid workflow file: jobs.X.steps must be a sequence" - steps was written as a mapping instead of a YA… "mapping values are not allowed in this context"Fix the GitHub Actions YAML error "mapping values are not allowed in this context" caused by a stray colon or… "mapping values are not allowed in this context"Fix GitHub Actions "while scanning ... mapping values are not allowed in this context" in CI - a stray colon… "must define at least one vector"Fix GitHub Actions "Matrix strategy must define at least one vector" in CI - the matrix has only include/excl… "matrix cannot expand from secrets"Fix a matrix that fails to build because it references the secrets context, which is not available where the… "Matrix included an invalid combination"Fix a GitHub Actions matrix job that fails because an include row produced a combination that does not work (… Matrix configuration errorFix GitHub Actions matrix errors - empty matrix, bad include/exclude shape, or referencing a matrix key that… "Matrix must define at least one vector"Fix GitHub Actions "matrix must define at least one vector" - a strategy.matrix was declared with no dimensio… "Matrix must define at least one vector"Fix "Matrix must define at least one vector" in CI - the strategy.matrix block resolved to no vectors, so Git… "vector contains no values"Fix GitHub Actions "Matrix vector `x` does not contain any values" - a matrix dimension set to null, an empty… "Matrix ... has no values"Fix the GitHub Actions error where a matrix dimension expands to no values, producing a skipped job or a vali… "Missing environment 'production'"Fix the GitHub Actions missing-environment error - a job references an environment that does not exist in the… "name is required for environment"Fix GitHub Actions "name is required for environment" - a job's environment: block omitted the required name… "Job needs ... but it is not defined"Fix the GitHub Actions error where a job needs another job that is not defined, usually a typo in the job id… "needs that creates a cycle"Fix the GitHub Actions error "You cannot use needs that creates a cycle" caused by two or more jobs depending… nested matrix not supportedFix the validation error from trying to declare a matrix within another matrix value, which GitHub Actions do… Reusable nesting limitFix GitHub Actions reusable workflow nesting errors - calling reusable workflows more than the allowed levels… "No event triggers in on"Fix GitHub Actions "No event triggers defined in `on`" - an empty, null, or malformed on: block means the wor… "No event triggers defined in 'on'"Fix GitHub Actions "No event triggers defined in 'on'" in CI - the `on` key is present but empty or unparseab… on: has no triggersFix the GitHub Actions error where the on key is missing or empty, so the workflow has no events to trigger i… exit code 1 (set -e)Fix a GitHub Actions run step that fails with exit code 1 due to the default bash set -e - any failing comman… "Exit code 127 (composite action)"Fix GitHub Actions "Process completed with exit code 127" inside a composite action - a command was not found… paths filter skipped the runFix a GitHub Actions workflow that never runs because its pull_request paths or paths-ignore filter excluded… "shell: pwsh" not availableFix the GitHub Actions error where a step with "shell: pwsh" fails on an Ubuntu runner because PowerShell Cor… "recursive reusable workflow"Fix GitHub Actions "recursive reusable workflows are not allowed" - a reusable workflow that calls itself, or… "Recursive workflow call detected"Fix GitHub Actions "Recursive workflow call detected" - a reusable workflow ends up calling itself directly o… app cannot update workflowFix "refusing to allow a GitHub App to create or update workflow" - the token lacks the workflows permission… "required and must be provided"Fix "input X is required and must be provided" when calling a reusable workflow in CI - the callee marks an i… "Required input is not set"Fix the GitHub Actions "Required input is not set" error caused by calling an action without supplying a with… "Required property is missing: jobs"Fix GitHub Actions "Required property is missing: jobs" in CI - the workflow has no top-level `jobs` mapping,… "nesting limit" exceededFix the GitHub Actions error where reusable workflows are nested more than four levels deep. "Reusable workflow was not found"Fix GitHub Actions "reusable workflow was not found" - a uses: to a called workflow points at a path or ref t… "can not be nested more than 4 levels"Fix "reusable workflows can not be nested more than 4 levels deep" in CI - a chain of workflow_call invocatio… "save-state deprecated"Fix GitHub Actions "The save-state command is deprecated" - migrate ::save-state to the GITHUB_STATE environm… "secret" exceeds 64KBFix the GitHub Actions error where a secret value exceeds the 64KB size limit. "set-output is deprecated and disabled"Fix the GitHub Actions error where the legacy "::set-output::" workflow command no longer sets step outputs a… "set-output deprecated"Fix GitHub Actions "The set-output command is deprecated" - migrate from ::set-output and ::save-state to the… "workflow file is invalid on this ref"Fix a required check that is silently skipped because the workflow file is invalid on the PR base or head ref. "startsWith()" wrong argument typeFix GitHub Actions startsWith/endsWith argument errors in CI - the function was passed a non-string (null, ob… "startup_failure"Fix GitHub Actions runs that end in startup_failure - an invalid workflow file, a bad reference, or a config… Step output too largeFix the GitHub Actions error where a step writes an output to GITHUB_OUTPUT that exceeds the allowed size. "contains invalid characters"Fix GitHub Actions expression "contains invalid characters" in CI - a character such as a curly quote or stra… "The expression is too long"Fix the GitHub Actions "expression is too long (max 21000 chars)" error - a single \${{ }} template exceeds t… "Head commit is not ahead of the base"Fix the GitHub Actions pull_request error "The head commit for this pull_request event is not ahead of the ba… "The identifier 'X' is invalid"Fix the GitHub Actions "The identifier is invalid" error caused by a job id that starts with a number or cont… "Canceled because a dependent job failed"Understand and fix GitHub Actions jobs canceled because a job they need failed, cascading the cancellation do… "requested workflow was not found at ref"Fix "The requested workflow was not found" when dispatching or referencing a workflow that does not exist on… "save-state/set-output are deprecated"Migrate off the deprecated ::save-state:: and ::set-output:: workflow commands to the $GITHUB_STATE and $GITH… "Template is not valid: invalid construct"Fix GitHub Actions "The template is not valid ... invalid programming construct" - an expression used a const… "The template is not valid"Fix the GitHub Actions "The template is not valid" runtime expression evaluation error caused by a function o… "The workflow is not valid ... matrix"Fix "The workflow is not valid ... Unexpected value" for jobs.<id>.strategy.matrix in CI - the matrix block h… "At least one job with no dependencies"Fix GitHub Actions "The workflow must contain at least one job with no dependencies" - every job has a needs,… Deprecated action versionFix GitHub Actions deprecation warnings/failures from old action majors - actions/checkout@v1, setup-node@v2,… "This check was cancelled"Fix a required status check that blocks merge after being cancelled by a job timeout or concurrency cancellat… depends on a skipped jobFix a GitHub Actions job that will not run because a job it depends on was skipped - skips propagate through… Reusable workflow run failedFix GitHub Actions runs that fail pointing at a called reusable workflow - a syntax error or invalid ref in t… "Likely failed because of a workflow file issue"Fix the GitHub Actions startup failure "This run likely failed because of a workflow file issue" - the workfl… "too many annotations (10 limit shown)"Fix the GitHub Actions situation where a step produces more annotations than the UI shows, so only the first… "too many jobs" (256)Fix the GitHub Actions error where a single workflow run produces more than the 256-job limit. "jobs section required"Fix GitHub Actions "The top level `jobs` section is required" - a missing, empty, or misindented jobs: block,… "Unable to interpret as boolean"Fix GitHub Actions "Unable to interpret 'X' as a boolean" - a key expecting true/false received a non-boolean… "Unable to interpret value as a 'boolean'"Fix the GitHub Actions error "Unable to interpret value as a boolean" caused by passing a string expression w… "env Invalid format"Fix GitHub Actions "Unable to process file command 'env' successfully ... Invalid format" - a multiline value… "Unable to process file command 'output'"Fix GitHub Actions "Unable to process file command 'output' successfully ... Invalid format" in CI - a multil… "Unable to process file command env"Fix GitHub Actions "Unable to process file command 'env'" - a multiline value (often a secret) was written to… "unable to find version" for usesFix GitHub Actions "Unable to resolve action X, unable to find version Y" in CI - a `uses:` references a tag,… "Unable to resolve action, repository not found"Fix GitHub Actions "Unable to resolve action, repository not found" - the action repo in uses does not exist… "Unable to resolve action"Fix GitHub Actions "Unable to resolve action" / "repository not found" - a wrong uses: path, a non-existent t… "Unexpected end of expression"Fix GitHub Actions "Unexpected end of expression" in CI - a `${{ }}` expression is missing a closing brace, p… "Unexpected input(s), valid inputs are"Fix GitHub Actions "Unexpected input(s) ..., valid inputs are ..." - the with: block passed an input the acti… "Unexpected symbol"Fix the GitHub Actions "Unexpected symbol" expression error caused by invalid operators, stray characters, or… "Unexpected symbol"Fix GitHub Actions "The workflow is not valid ... Unexpected symbol" - a malformed expression: unquoted strin… "Unexpected value 'runs-on'"Fix GitHub Actions "Unexpected value 'runs-on'" in CI - `runs-on` was placed outside a job, where the workflo… "Unexpected value 'steps'"Fix GitHub Actions "Unexpected value 'steps'" in CI - a `steps` block was placed at the workflow or job-mappi… "Unexpected value X"Fix GitHub Actions "Unexpected value `X`" - a scalar supplied where a mapping or list is expected, or a value… "Unexpected value"Fix GitHub Actions "Unexpected value" and "did not expect" workflow validation errors - a key in the wrong pl… "Unexpected value"Fix the GitHub Actions "The workflow is not valid ... (Line: N): Unexpected value" error caused by a key in t… "Unexpected value" in strategy.matrixFix "Unexpected value 'X'" under jobs.<id>.strategy.matrix in CI - a key or structure inside the matrix is no… "Unrecognized function"Fix the GitHub Actions expression error "Unrecognized function" caused by calling a function that does not ex… "Unrecognized named-value: 'env'"Fix GitHub Actions "Unrecognized named-value: 'env'" in CI - an expression referenced the `env` context where… "Unrecognized named-value: 'matrix'"Fix "Unrecognized named-value: 'matrix'" in GitHub Actions - the matrix context was referenced where it is no… "named-value: secrets"Fix GitHub Actions "Unrecognized named-value: `secrets`" - using the secrets context in runs-on, a service im… "named-value: inputs"Fix GitHub Actions "Unrecognized named-value: inputs" - using the inputs context in a workflow that has no wo… "Unrecognized named-value: 'secrets'"Fix the GitHub Actions expression error "Unrecognized named-value: secrets" caused by using a context where i… "Unrecognized named-value"Fix GitHub Actions "Unrecognized named-value" and expression errors - referencing a context that is not avail… "Workflow does not exist"Fix "Workflow does not exist" when dispatching - workflow_dispatch is only available once the workflow file e… workflow changed during runFix a GitHub Actions run that fails because the workflow file changed while it was executing - runs are pinne… workflow_run not triggeringFix a GitHub Actions workflow_run that never fires because the triggered workflow file only exists/runs on th… "working-directory does not exist"Fix the GitHub Actions error where a step fails because its working-directory path does not exist on the runn… working-directory errorFix GitHub Actions working-directory errors - the path does not exist yet, is relative to the wrong base, or… YAML syntax error (tabs)Fix "You have an error in your YAML syntax on line N" caused by tab characters - YAML forbids tabs for indent… "error in your yaml syntax"Fix "You have an error in your yaml syntax" when a dynamic matrix output is malformed in CI - the JSON genera… ${{ }} in run: stepFix GitHub Actions where a literal ${{ }} or $VAR in a run: script is consumed by expression interpolation or… action.yml mapping/scalar errorFix an action.yml metadata error where a scalar key received a mapping - common in runs.steps and inputs defi… "ReferenceError: require is not defined"Fix actions/github-script "ReferenceError: require is not defined" - ESM-style imports or top-level await wer… github-script paginationFix actions/github-script only returning ~30 results - list endpoints are paginated, so use octokit.paginate… labeler applies nothingFix actions/labeler not applying labels - a v5 config-format change, a missing labeler.yml path, or no pull-r… actions/stale misfiresFix actions/stale processing no issues or the wrong ones - a missing issues/pull-requests permission, days se… cancel-in-progress kills deployFix a deployment that gets cancelled partway through because a newer run in the same concurrency group preemp… cannot use needs in reusable inputFix a reusable workflow call that references the needs context inside a with input, which is not available th… Checkout detached HEADFix actions/checkout leaving a detached HEAD so git branch --show-current is empty and git push fails - check… Submodule checkout failsFix actions/checkout submodule failures - submodules: true needs a token with access to private submodule rep… "Input required and not supplied"Fix GitHub Actions composite action "Input required and not supplied: X" in CI - the action declares a requir… "composite action cannot use jobs"Fix a composite action.yml that incorrectly defines jobs - composite actions use runs.steps, not jobs. github.action_pathFix composite actions that cannot find their own bundled scripts - run steps resolve relative to the workspac… "Required property is missing: shell"Fix GitHub Actions composite action "Required property is missing: shell" in CI - a `run` step inside a compo… "shell is required (composite)"Fix GitHub Actions composite-action error where a run step is missing the required shell field. Composite action inputFix composite action input errors - undeclared inputs, the shell missing from a run step, or referencing inpu… "using" must be set",Fix the GitHub Actions error where an action.yml runs section is missing or has an invalid using value such a… Composite working-directoryFix GitHub Actions composite action run steps ignoring working-directory - each composite step needs its own… composite inputs not passedFix a GitHub Actions composite action whose inputs are empty - composite steps must reference inputs via the… Composite nested usesFix GitHub Actions composite action errors when a nested uses: step cannot be resolved - a relative local pat… Composite outputs emptyFix GitHub Actions composite action outputs that arrive empty - outputs must be mapped in action.yml from a s… "cancel-in-progress without group"Fix GitHub Actions concurrency that does nothing because cancel-in-progress was set without a concurrency gro… Concurrency deadlockFix GitHub Actions jobs stuck "pending" forever in a concurrency group - a job that needs another job sharing… concurrency group expression errorFix the GitHub Actions concurrency group expression error caused by an invalid or unevaluatable expression in… concurrency group errorFix GitHub Actions concurrency group errors - referencing a context not available at workflow level, or an em… concurrency group emptyFix a concurrency group built from a context value that resolves empty, collapsing all runs into one global g… concurrency pending canceledFix a GitHub Actions concurrency group that cancels a pending run - cancel-in-progress and group collisions c… skipped job blocks mergeFix a PR that cannot merge because a skipped conditional job leaves its required status check unfulfilled. matrix leg not skipping on ifFix a GitHub Actions matrix leg that runs when you expected it to skip in CI - you cannot conditionally drop… container action requires DockerfileFix a GitHub Actions Docker container action that fails because runs.using is docker but no image or Dockerfi… "HOME not set in container job"Fix the GitHub Actions error where tools fail inside a container job because the HOME environment variable is… "workdir not found in container"Fix the GitHub Actions error where a container job sets an --workdir option pointing at a path that does not… contains() wrong typeFix GitHub Actions contains() that never matches - passing a string where an array is expected, or comparing… contains() type mismatchFix an if condition where contains() compares mismatched types (number vs string, array vs scalar) and evalua… "continue-on-error did not propagate outcome"Fix the GitHub Actions confusion where continue-on-error hides a failure so downstream conditions on conclusi… continue-on-error masks failureFix a matrix job that reports success because continue-on-error swallowed a genuinely failed combination. continue-on-error maskingFix GitHub Actions continue-on-error hiding real failures - a step that should fail the job is marked green,… defaults.run.shell ignoredFix a composite action where each run step still needs an explicit shell because defaults.run.shell does not… Deploy canceledStop GitHub Actions deploys being canceled mid-run - a shared concurrency group with cancel-in-progress abort… Environment URL not shownFix a GitHub Actions deployment where the environment URL is blank - the url value resolved to empty because… "paths-filter: invalid predicate-quantifier"Fix dorny/paths-filter predicate-quantifier errors - an invalid value, or list-style filters combined with pr… paths-filter falseFix dorny/paths-filter outputs always coming back false - a shallow checkout with no base ref, a missing id,… Duplicate step idFix GitHub Actions step id collisions - reusing the same id on two steps makes steps.<id>.outputs resolve to… fromJSON matrix errorFix GitHub Actions dynamic matrix errors - a matrix built from fromJSON of a job output that is empty, not va… Dynamic matrix empty, no jobs runFix a dynamic matrix that expands to nothing in CI - when fromJSON over a needs output yields an empty array,… "add-and-commit: nothing to commit"Fix EndBug/add-and-commit "nothing to commit" failures - the working tree had no changes, and the step is tre… env scope precedenceFix GitHub Actions env variable scoping - workflow, job, and step env blocks override each other, and step-le… env not available in some keysFix GitHub Actions where the env context is empty in job-level if - env is not available in jobs.<id>.if and… env on uses ignoredFix GitHub Actions env set on a uses: step not reaching the action - actions read declared inputs (with:), no… "env var with newline breaks parsing"Fix the GitHub Actions error where writing a multiline value to GITHUB_ENV with a single-line syntax corrupts… env special chars not escapedFix a GitHub Actions env value containing special characters that breaks the shell - quoting and escaping are… "environment file is too large"Fix a step that fails because it wrote too much data to $GITHUB_ENV, $GITHUB_OUTPUT, or $GITHUB_STATE. Env var not expandingFix GitHub Actions env vars that come through empty or literal - mixing ${{ }} and shell $VAR syntax, or sett… format() errorFix GitHub Actions format() expression errors - a placeholder index with no matching argument, or literal bra… format() index out of rangeFix a format() expression that references a {N} placeholder with no matching argument supplied. "Unexpected end of JSON input"Fix GitHub Actions fromJSON "Unexpected end of JSON input" - fromJSON received an empty or truncated string. "fromJSON" parse errorFix GitHub Actions fromJSON failures - passing a non-JSON string, an empty output, or unquoted output to from… fromJSON parse errorFix the GitHub Actions fromJSON parse error caused by passing a non-JSON or malformed string into the fromJSO… "delimiter found in GITHUB_ENV value"Fix the GitHub Actions error where the heredoc delimiter you chose for GITHUB_ENV also appears inside the val… GITHUB_OUTPUT / set-outputFix GitHub Actions step outputs after set-output was removed - write to the GITHUB_OUTPUT file instead of the… GITHUB_REF_NAME has slashFix downstream tagging or naming that breaks because github.ref_name contains a slash from a hierarchical ref. Secondary rate limitFix actions/github-script hitting a secondary rate limit - too many rapid API writes trigger 403 abuse detect… Heredoc in run: stepFix GitHub Actions heredocs in run: steps - a quoted vs unquoted delimiter changes variable expansion, and in… GITHUB_ENV multiline heredocFix a GitHub Actions multiline value written to GITHUB_ENV - a missing or value-colliding heredoc delimiter b… if condition always runsFix a GitHub Actions if condition that always runs - a bare string in if is truthy, so the step never skips. if always runsFix GitHub Actions if conditions that always run or never run - wrapping the expression in ${{ }} incorrectly… if: always() misuseFix GitHub Actions if: conditions using always(), success(), failure(), and cancelled() - always() runs even… if: always() runs on cancelFix GitHub Actions `if: always()` misuse in CI - always() also runs when the job is cancelled, which can mask… always() skipped on cancelFix a GitHub Actions step using if: always() that still skips - a canceled workflow short-circuits most steps… too many steps in a jobFix a job that fails to load because it declares more steps than GitHub Actions allows. Job outputs emptyFix GitHub Actions job outputs that arrive empty downstream - you must map step outputs to jobs.<id>.outputs… job outputs emptyFix empty job outputs caused by the step that writes them failing before it reaches the GITHUB_OUTPUT write. Job outputs truncatedFix GitHub Actions job outputs that come through truncated or empty - job and step outputs have a size cap, s… needs a matrix waits for every legFix a downstream job that needs a matrix job in CI - it waits for every matrix combination to finish, and ski… join() bad inputFix GitHub Actions join() and toJSON misuse - calling join() on a scalar, or expecting join() to walk object… join() on non-arrayFix a join() expression that errors because its first argument is a scalar or null instead of an array. matrix exclude emptied the matrixFix a GitHub Actions matrix where exclude removes every combination in CI - overly broad or mis-keyed exclude… matrix include not appliedFix a GitHub Actions matrix where include adds a new job instead of extending a combination in CI - include b… "max-parallel" not appliedFix a GitHub Actions matrix where max-parallel does not limit how many legs run at once in CI - usually a mis… artifact name already exists (v4)Fix "an artifact with this name already exists" across matrix legs with upload-artifact v4 in CI - v4 artifac… matrix not available in environmentFix a GitHub Actions job where ${{ matrix.x }} in the environment field does not resolve in CI - matrix is av… matrix context unavailable in nameFix a GitHub Actions job name that shows literal ${{ matrix.x }} in CI - or the run-name field, where the mat… continue-on-error per matrix legFix per-leg continue-on-error in a GitHub Actions matrix in CI - use a matrix-driven expression so only speci… "Matrix ... too large" (256 jobs)Fix "A strategy matrix cannot contain more than 256 jobs" in CI - the product of all matrix vectors and inclu… exclude removed all combinationsFix a matrix where overbroad exclude entries eliminate every combination, leaving a job with nothing to run. fail-fast cancels siblingsFix matrix jobs that get cancelled the moment one matrix leg fails because strategy.fail-fast defaults to tru… fail-fast cancels siblingsFix GitHub Actions matrix legs cancelled when one fails - fail-fast defaults to true, cancelling all in-progr… fail-fast cancelled other legsFix a GitHub Actions matrix where one failed leg cancels all others in CI - fail-fast defaults to true and ca… Matrix from JSONFix a GitHub Actions dynamic matrix built from a JSON file that expands to zero jobs - an empty output, unpar… "Unexpected end of JSON input"Fix "Unexpected end of JSON input" from fromJSON in a dynamic matrix in CI - the previous job emitted empty o… "matrix include adds undeclared key"Fix the GitHub Actions confusion where a matrix include entry adds a new combination instead of extending exi… matrix include unexpected comboFix a GitHub Actions matrix where include adds or alters combinations unexpectedly - include both extends and… Matrix include overrideFix GitHub Actions matrix include unexpectedly overriding values - an include entry that matches an existing… Matrix include/excludeFix GitHub Actions matrix include/exclude surprises - include adding extra jobs, expanding existing combinati… Invalid characters in job nameFix the GitHub Actions error where a matrix job name uses reserved or invalid characters that break run-name… max-parallel ignoredFix GitHub Actions strategy.max-parallel not limiting jobs - wrong placement, a value above your account conc… "matrix produced duplicate combinations"Fix a matrix that errors or wastes jobs because include/exclude rules produce duplicate combinations. duplicate matrix combinationsFix a GitHub Actions matrix that runs the same combination twice in CI - usually an include entry that re-add… setup version not found in one legFix a GitHub Actions matrix where one combination fails because setup cannot find its version in CI - a versi… "matrix not available in container image"Fix the GitHub Actions issue where a matrix variable interpolated into a container image tag resolves to empt… matrix not interpolating in nameFix a GitHub Actions job name showing the literal expression instead of the matrix value - the name field nee… matrix var shadowed by envFix a step reading the wrong value because an env var and a matrix.<name> share a name and the env wins in a… matrix + reusable workflow limitsFix errors using a matrix with a reusable-workflow call in CI - a matrixed calling job cannot also define ste… matrix + reusable workflow usesFix matrix issues when calling a reusable workflow in CI - a matrix job that uses a reusable workflow cannot… Multiline output brokenFix GitHub Actions "Invalid format" writing multiline values to GITHUB_OUTPUT or GITHUB_ENV - multiline conte… GITHUB_OUTPUT multiline brokenFix a GitHub Actions multiline step output that is truncated - multiline GITHUB_OUTPUT values need a heredoc… "multiline output without delimiter"Fix the GitHub Actions error where a multiline step output written to GITHUB_OUTPUT with NAME=value syntax fa… multiline run script failsFix a GitHub Actions multiline run that breaks - the YAML block scalar indicator or indentation mangled the s… multiple crons, only first runsFix the impression that only one of several on.schedule cron entries fires, usually a YAML or default-branch… "needs context outputs undefined"Fix the GitHub Actions error where a downstream job reads needs.<job>.outputs.<name> and gets undefined becau… needs output null (skipped)Fix a downstream job reading an empty needs output because the producing job was skipped, not run. needs.<job>.outputs emptyFix GitHub Actions needs.<job>.outputs returning empty - the upstream job never mapped its step output to a j… needs output undefinedFix GitHub Actions where needs.<job>.outputs.* is empty - a skipped or failed upstream job produces no output… nested matrix not supportedFix an attempt to nest one matrix inside another in CI - GitHub Actions supports one strategy.matrix per job;… on.push.tags not matchingFix a tag-triggered workflow that does not run because the on.push.tags pattern does not match the tag name. paths filter confusionFix GitHub Actions paths and paths-ignore confusion - they are mutually exclusive per event, use glob rules,… paths and paths-ignore conflictFix a push/pull_request trigger that never fires (or always fires) because paths and paths-ignore are combine… "actions-gh-pages: publish dir not found"Fix peaceiris/actions-gh-pages "publish_dir does not exist" - the directory to publish was never built or is… Per-step timeoutFix GitHub Actions per-step timeout-minutes not firing - it must sit on the step, not the job, and a job-leve… missing pipefail in pipeFix a GitHub Actions run where a failing command in a pipe is ignored - a custom shell without pipefail only… pipefail masks failuresFix GitHub Actions steps that pass despite a failing command in a pipe - bash run steps set pipefail by defau… "workflow skipped on draft PR"Understand why a pull_request workflow does not run (or runs unexpectedly) on draft pull requests and how to… repository_dispatch missFix GitHub Actions repository_dispatch events that never trigger a run - wrong event_type filter, a token wit… Required check stuckFix a GitHub Actions required status check stuck as "Expected" - a skipped job or path filter means the check… "Invalid input, X is not defined"Fix GitHub Actions "invalid input, X is not defined in the referenced workflow" in CI - the caller passed an… Reusable workflow errorFix GitHub Actions reusable workflow errors - bad uses: reference format, missing required inputs, or secrets… "Required input ... not provided"Fix GitHub Actions "the workflow ... requires input 'X' but ... not provided" in CI - a reusable workflow dec… "secret not defined"Fix GitHub Actions reusable workflow secret errors - passing a secret the called workflow never declared unde… "reusable workflow input type mismatch"Fix the GitHub Actions error where a reusable workflow rejects a "with:" input because the value type does no… Input type mismatchFix GitHub Actions reusable workflow input type errors - passing a string where boolean or number is declared… reusable input "does not match" typeFix a reusable-workflow input type error in CI - the value passed in with: does not match the declared type (… reusable workflow nesting too deepFix GitHub Actions reusable-workflow nesting errors in CI - a chain of workflow_call workflows exceeds the ma… "reusable workflow output not defined"Fix a caller reading an output from a reusable workflow that the called workflow never declared in its on.wor… reusable "needs ... outputs" emptyFix a reusable-workflow output that reads empty from needs.*.outputs in CI - the called workflow must declare… Reusable outputs emptyFix GitHub Actions reusable workflow outputs that arrive empty - workflow_call must declare outputs mapped fr… ref must be full-length SHAFix a blocked reusable-workflow call when org policy requires pinning uses to a 40-character commit SHA, not… required input not providedFix a workflow_call validation error when the caller omits an input declared required: true by the reusable w… "reusable workflow uses must be ..."Fix the GitHub Actions error where a reusable workflow uses value is not a valid owner/repo/.github/workflows… reusable workflow "not found" (no workflow_call)Fix a reusable-workflow call that fails because the called workflow has no on: workflow_call trigger in CI -… "syntax error near unexpected token"Fix the GitHub Actions run-step error "syntax error near unexpected token" in a multiline run block - usually… save-state deprecatedFix the GitHub Actions save-state deprecation - write state to the GITHUB_STATE file instead of the ::save-st… schedule cron not triggeringFix a GitHub Actions schedule trigger that never fires - scheduled workflows run only from the file on the de… schedule cron not firingFix GitHub Actions on.schedule cron jobs that run late, skip, or never fire - bad cron syntax, UTC confusion,… "Secret empty/undefined in if"Fix GitHub Actions steps that wrongly skip or fail because a secret referenced in an if condition is empty or… "setup-python could not find a version"Fix GitHub Actions setup-python failing to resolve a Python version from a python-version-file (.python-versi… Shallow clone historyFix tools that fail under actions/checkout because of its shallow clone - git describe, tag detection, and ba… startsWith expects string got nullFix a startsWith() expression error when its argument resolves to null because the referenced context value i… "step debug logs truncated"Fix the GitHub Actions issue where verbose step debug logs are truncated in the UI, hiding the line you need. step id with dashFix steps.<id>.outputs returning nothing because the step id uses a character that breaks property-access syn… "timeout-minutes exceeded killed step"Fix the GitHub Actions error where a step or job is forcibly terminated because it ran past its timeout-minut… steps.<id> emptyFix GitHub Actions steps.<id>.outputs coming back empty - a step with no id, a typo in the id, or reading the… max-parallel ignoredFix matrix jobs that all start simultaneously even though strategy.max-parallel was set to throttle them. success() and failure() both falseFix a cleanup step that never runs because both success() and failure() are false during a cancellation. toJSON / fromJSON misuseFix GitHub Actions where an object renders as a useless string - interpolating a context object without toJSO… toJSON output too largeFix a dynamic matrix built from fromJSON(toJSON(...)) that fails because the generated JSON exceeds size limi… two jobs with the same idFix the GitHub Actions error caused by two jobs sharing the same id, which YAML treats as a duplicate mapping… uses with ref and pathFix a GitHub Actions uses value that mixes a local path with a ref - local actions cannot be pinned to a ref. "Workflow does not contain permissions"Fix the GitHub Actions warning that a workflow does not specify permissions and falls back to the repository… env not inheritedFix GitHub Actions env vars that are empty inside a called reusable workflow - env does not cross the workflo… workflow file too largeFix a workflow that fails to load because the YAML file is larger than the allowed maximum. workflow must contain a jobFix the GitHub Actions error where the jobs section is missing or empty, leaving the workflow with nothing to… Workflow not triggeringFix a GitHub Actions workflow that never runs - wrong on: events, path or branch filters that exclude your ch… "Run skipped due to path filter"Fix GitHub Actions runs that unexpectedly do not trigger because the on.push/pull_request paths filter exclud… call vs run chainingFix GitHub Actions chaining confusion - workflow_call is a synchronous reusable call inside one run, workflow… workflow_dispatch inputsFix GitHub Actions workflow_dispatch inputs - wrong context, boolean inputs read as strings, or undeclared in… dispatch button missingFix a missing GitHub Actions "Run workflow" button - workflow_dispatch must exist on the default branch first… workflow_run not firingFix a GitHub Actions workflow_run trigger that never fires - the triggering workflow must live on the default… env not visible in run-nameFix a run-name that renders blank or literal because it references env, which is not available in the run-nam… working-directory ignored (uses)Fix a step where working-directory has no effect because it only applies to run steps, not uses steps. "did not find expected key"Fix the GitHub Actions YAML error "did not find expected key" caused by broken indentation that leaves the pa… YAML anchors unsupportedUnderstand why GitHub Actions does not expand YAML anchors/aliases (&, *, <<) for reuse - and the supported a… GitLab scheduled pipeline is silentFix a GitLab CI pipeline schedule that does not run - the schedule can be inactive, owned by a user who lost… GitLab schedule cron and timezoneFix a GitLab CI pipeline schedule that runs at the wrong time - GitLab schedules use a cron plus a configurab… "Invalid cron"Fix "Invalid workflow file" caused by a bad POSIX cron expression in a GitHub Actions schedule - five space-s… Jenkins H spreads scheduled loadUse Jenkins cron correctly for scheduled builds - the H (hash) symbol spreads load so every job does not fire… "No test report files were found"Fix mikepenz/action-junit-report finding no test results because the report path glob did not match. multiple cron lines under scheduleSet up and debug multiple cron schedules in one GitHub Actions workflow - list several cron entries under sch… re-enable a paused scheduleRe-enable a GitHub Actions scheduled workflow that was disabled by inactivity or manually - use the Actions U… "release_created=false"Fix release-please silently creating no release because no Conventional Commits (feat/fix) landed since the l… "reviewdog: exit status 1"Fix reviewdog failing the job with exit 1 despite reporting no findings, caused by reporter/level/fail-level… concurrency cancels the cron runFix a GitHub Actions scheduled workflow that gets cancelled by a concurrency group - a shared group with canc… cron time is UTC, not localFix a GitHub Actions scheduled workflow that runs at the wrong local time - cron is always evaluated in UTC.… schedule delayed under loadUnderstand why a GitHub Actions scheduled workflow starts minutes late - the schedule event is best-effort an… scheduled deploy waits on approvalSet up a GitHub Actions scheduled deploy that gates on an environment approval - and understand why a require… missed slots are not backfilledUnderstand why GitHub Actions does not backfill missed scheduled runs - if the schedule was disabled or deliv… deprecation warning on a scheduleFix a GitHub Actions annotation warning that a scheduled workflow uses a deprecated action or runner image ve… schedule disabled after 60 daysFix a GitHub Actions scheduled workflow that stopped running - GitHub automatically disables scheduled workfl… schedule never fires on a branchFix a GitHub Actions scheduled workflow that never runs - the schedule event only triggers when the workflow… forks do not run scheduled workflowsUnderstand why a forked repository does not run scheduled GitHub Actions workflows - schedules are disabled o… edits on a branch do not affect the scheduleUnderstand why editing a scheduled GitHub Actions workflow on a feature branch has no effect - the schedule a… "Assertion failed... did not meet budget"Understand treosh/lighthouse-ci-action failing the job when a Lighthouse assertion/budget is not met. "BASE and HEAD are the same commit"Fix trufflesecurity/trufflehog scanning nothing because BASE and HEAD resolve to the same commit. "subject may not be empty [subject-empty]"Fix wagoid/commitlint-github-action "subject may not be empty" caused by commit messages that violate Convent… run a scheduled workflow on demandAdd a workflow_dispatch fallback so a GitHub Actions scheduled workflow can be run manually - essential for t…

"actions/checkout" fails under actFix actions/checkout failures under act - by default act binds your working tree into the container, so a rea… "Cannot connect to the Docker daemon"Fix act "Cannot connect to the Docker daemon at unix:///var/run/docker.sock" - act runs every job inside a co… "exec format error" (wrong arch)Fix act "OCI runtime create failed: ... exec format error" - a binary in the container was built for a differ… "permission denied /var/run/docker.sock"Fix act "dial unix /var/run/docker.sock: connect: permission denied" - your user cannot access the Docker soc… "Platform 'ubuntu-latest' not found"Fix act "Error: Platform 'ubuntu-latest' not found" - act needs a runner label to container image mapping via… service containers limited under actFix act service container problems - act support for job "services" is limited, so a step may fail to reach a… "pull access denied" for runner imageFix act "unable to find image ... locally" and "pull access denied" for catthehacker/ubuntu - the mapped runn… "image platform ... does not match" on M1/M2Fix act arm64 image mismatch warnings and step failures on Apple Silicon - pass --container-architecture linu… "bind mount ... no such file or directory"Fix act bind mount errors - Docker cannot mount a host path into the job container because the path does not… "exited with code 137"Fix act job container "exited with code 137" - the container was killed (SIGKILL), usually because Docker Des… job skipped due to needs/ifFix act jobs that are skipped - a job with needs: or an if: condition may not run under act when the upstream… matrix expansion differs under actUnderstand act matrix behavior - act expands strategy.matrix but runs all combinations on the same container… reusable workflow support is partialFix act reusable workflow errors - support for workflow_call and remote uses: is partial, so a called workflo… "command not found" for a preinstalled toolFix act "command not found" for tools that exist on GitHub-hosted runners - act images (medium size) omit man… workflow_dispatch inputs are emptyFix act workflow_dispatch inputs reading empty - act needs the workflow_dispatch event and --input (or an eve… "Cannot connect to the Docker daemon"Fix act_runner "Cannot connect to the Docker daemon at unix:///var/run/docker.sock" in CI - docker-mode runne… "failed to connect to ... instance"Fix act_runner "failed to connect to Gitea instance" in CI - the runner cannot reach the configured instance… "permission denied ... docker.sock"Fix act_runner "permission denied while trying to connect to the Docker daemon socket" in CI - the runner use… registration token expiredFix act_runner registration failing because the token expired in CI - registration tokens are short-lived and… "certificate signed by unknown authority"Fix act_runner failing on a self-signed Gitea instance certificate in CI - the runner rejects an untrusted TL… "fatal: no submodule mapping found / path not initialized"Fix actions/checkout "Submodule path not initialized" when submodules are not requested or are inaccessible. "failed to properly upload report"Fix codecov/codecov-action "failed to properly upload report" from a transient upload failure or a missing to… "Cypress failed to verify that the binary is valid"Fix cypress-io/github-action failing to verify the Cypress binary, often a transient download/cache issue. "ERROR: failed to solve: buildkit not found"Fix docker/build-push-action "failed to solve" when docker/setup-buildx-action was not run first. "Author identity unknown"Fix EndBug/add-and-commit "Author identity unknown" by configuring a commit author name and email. jobs waiting on capacityFix Forgejo and Gitea Actions jobs sitting queued in CI - the runner capacity (concurrent tasks) is exhausted… runner vs instance versionFix Forgejo Runner failing against a Forgejo instance in CI - a runner too old or too new for the instance Ac… "actions ... disabled"Fix Gitea Actions doing nothing because Actions is disabled in CI - the feature must be enabled globally in a… "no runner available"Fix Gitea Actions jobs stuck with no runner available in CI - no act_runner is registered against the instanc… "node: not found"Fix Gitea Actions "node: not found" in CI - JavaScript actions run with node inside the job container, and a… "labels do not match"Fix Gitea Actions jobs that never start because the workflow runs-on label is not offered by any registered a… "task ... failed"Fix Gitea Actions reporting a task failed in CI - the runner executed the job but a step exited non-zero or t… "unable to resolve action ... uses"Fix Gitea Actions "unable to resolve action" in CI - the instance cannot fetch the action named in uses becau… "workflow ... invalid"Fix Gitea Actions "workflow is not valid" in CI - the YAML parses but violates the workflow schema, so no job… "404" downloading actionFix Gitea Actions action download failing with 404 in CI - the uses reference does not exist at the configure… artifacts upload failsFix upload-artifact failing on Gitea Actions in CI - the instance artifacts storage must be enabled in app.in… cache server not configuredFix actions/cache failing on Gitea Actions in CI - the act_runner cache server must be enabled and reachable… "cannot find ... container image"Fix Gitea Actions failing to pull the job container image in CI - docker-mode jobs pull the label image, and… GITHUB_TOKEN / GITEA_TOKENFix Gitea Actions where GITHUB_TOKEN or GITEA_TOKEN is empty or unauthorized in CI - the automatic token is s… label maps to host vs dockerFix Gitea Actions running on the host when you meant docker (or vice versa) in CI - the label mapping suffix… secrets empty in workflowFix Gitea Actions where secrets.X is empty in CI - the secret was not defined at the right scope or not refer… ".gitea/workflows" vs ".github/workflows"Fix Gitea Actions not running any workflow in CI - Gitea reads workflows from .gitea/workflows and .github/wo… "runs-on is required"Fix "'runs-on' is required" - every GitHub Actions job must declare a runner with runs-on (unless it only cal… "/usr/bin/bash: line N: command not found"Fix the GitHub Actions run-step error "/usr/bin/bash: line N: command not found" - the tool is not installed… "runner with the same name already exists"Fix self-hosted runner registration failing because a runner with the same name is already registered. "Failed to create deployment" (Pages)Fix the actions/deploy-pages error "Failed to create deployment" - a permissions gap or a transient Pages API… "Argument list too long"Fix GitHub Actions "Argument list too long" (E2BIG) - a step passing a huge expanded matrix value or file lis… Runner clock skewFix GitHub Actions auth failures on self-hosted runners caused by clock skew - a wrong system time makes sign… "spending limit reached for Actions"Fix "spending limit reached for Actions" when the configured Actions spending limit blocks further metered us… "Can't find action.yml"Fix "Can't find 'action.yml'" or "Missing download info" for a composite action in CI - the uses path does no… Concurrency cancelUnderstand GitHub Actions jobs canceled by concurrency with cancel-in-progress - a newer run superseded the o… "Container action only supported on Linux"Fix GitHub Actions "Container action is only supported on Linux" - a Docker container action was scheduled on… "Container action Linux only"Fix GitHub Actions "Container action is only supported on Linux" - a Docker-based action used on a Windows or… "only supported on Linux"Fix GitHub Actions "Container action is only supported on Linux" in CI - a Docker-based action was used on a… "container only supported on Linux runners"Fix the GitHub Actions error where a job using "container:" runs on a Windows or macOS runner that does not s… "deployment protection rule timed out"Fix the GitHub Actions error where a custom deployment protection rule timed out waiting for an external appr… "docker login rate limited"Fix the GitHub Actions error where an image pull or docker login is throttled by the registry rate limit duri… "Docker pull failed for job container"Fix the GitHub Actions error where the job container image cannot be pulled - bad tag, private registry, or a… Dockerfile action buildFix GitHub Actions Dockerfile-based action build failures - the action's own image build errors at "Build con… "EACCES permission denied (container)"Fix GitHub Actions "EACCES: permission denied" inside a container job - the container user cannot write to th… "Exit code 1"Understand GitHub Actions "Error: Process completed with exit code 1" - a command in a run step failed and re… "Exit code 137 (OOM)"Fix GitHub Actions "Error: Process completed with exit code 137" - the process was SIGKILL'd, almost always b… "Exit code 143 (SIGTERM)"Fix GitHub Actions "Error: Process completed with exit code 143" - the process got SIGTERM (128 + 15), usuall… "Failed to download action"Fix "Failed to download action" caused by rate limiting when the runner fetches an action archive. "could not be found at the URI"Fix GitHub Actions Docker-action image/URI failures in CI - a `docker://` image reference is malformed or the… "fatal: not a git repository"Fix git "fatal: not a git repository" in GitHub Actions - a step runs git in a directory that checkout never… "encountered an internal error"Handle "GitHub Actions has encountered an internal error while running your job" - a transient server-side fa… "Job about to start but no steps"Fix a GitHub Actions job that is acquired by a runner but has no steps to execute, so it completes instantly… Runner idle disconnectFix self-hosted runners that drop mid-job after the host sleeps, suspends, or its laptop lid closes - power m… "Matrix exceeds 256 jobs"Fix GitHub Actions "Matrix vector ... exceeds the maximum number of 256 jobs" - a matrix expanded past the ha… "No runner matching labels"Fix GitHub Actions "No runner matching the specified labels was found: self-hosted" - the runs-on labels do n… No matching labelsFix GitHub Actions "No runner matching the specified labels" - a typo in runs-on, a label the runner never re… "disk usage exceeded (no space)"Fix the GitHub Actions error where a job runs out of disk space mid-run, failing with "No space left on devic… Runner out of diskFix GitHub Actions "No space left on device" - the hosted runner disk filled with Docker images, caches, or b… "Node.js 12 actions are not supported"Fix "Node.js 12 actions are not supported" hard failures by upgrading any action still using the removed node… "Node16 actions are deprecated"Resolve "Node16 actions are deprecated" warnings by upgrading actions whose runtime is node16 to node20. "exit code 1"Understand GitHub Actions "Process completed with exit code 1" - a generic non-zero exit from a run step. Fin… "Process completed with exit code 1"Fix GitHub Actions "Process completed with exit code 1" in a Docker build step in CI - the shell command (her… "exit code 127"Fix GitHub Actions "Process completed with exit code 127" - the shell could not find the command, usually a m… "exit code 2"Fix GitHub Actions "Process completed with exit code 2" - a tool exited 2, usually a misuse/usage error, a ma… "the run is too old to re-run"Understand why re-running a workflow fails when the run is older than the re-run retention window. "Listener exited null"Fix the self-hosted GitHub Actions "Runner listener exited with error code null" crash that drops the runner… "Runner not found"Fix GitHub Actions "Runner not found" when a job is dispatched to a runner that deregistered, was reclaimed,… "Runner registration failed: 404"Fix self-hosted runner registration failing with HTTP 404, caused by a wrong repo/org URL or an invalid regis… "runner.temp not writable"Fix the GitHub Actions error where steps or actions fail because the RUNNER_TEMP directory is read-only or ow… Scheduled workflow disabledFix a GitHub Actions scheduled workflow that stopped firing because it was auto-disabled after 60 days of rep… "container ... is not healthy"Fix the GitHub Actions error where a service container never reports healthy, so the job is aborted before st… "required property is missing: shell"Fix "required property is missing: shell" in a composite action in CI - every run: step in a composite action… "Hosted runner encountered an error"Fix the GitHub Actions "The hosted runner encountered an error while running your job" failure - a transient… "Runner lost communication"Fix GitHub Actions "The hosted runner lost communication with the server" - a network or backend drop severed… Hosted runner lost commsFix GitHub Actions "The hosted runner lost communication with the server" - an infrastructure blip that drops… "runner system version is being upgraded"Understand "The hosted runner system version is being upgraded" - a transient GitHub-hosted runner maintenanc… Job timeout exceededFix GitHub Actions jobs canceled for exceeding the maximum execution time - a hung step, the 360-minute defau… "Job exceeded max time"Fix GitHub Actions "has exceeded the maximum execution time of 360 minutes" - a job ran past the 6-hour hard… "Job not acquired by runner"Fix GitHub Actions "The job was not acquired by Runner of type X" / "waiting for a runner" - the job matched… "insufficient minutes"Fix "The job was not started because your account has insufficient minutes" when your GitHub-hosted Actions m… "The operation was canceled"Understand GitHub Actions "The operation was canceled" - a job stopped early by a cancel request, concurrency… "git exit code 128"Fix GitHub Actions "The process '/usr/bin/git' failed with exit code 128" during checkout - auth, ref, or sub… "runner has not received logs"Fix the GitHub Actions "runner has not received any logs" condition - a step buffered output and the runner a… "Runner shutdown signal"Fix GitHub Actions "The runner has received a shutdown signal" - the runner host was stopped or preempted mid… "received a shutdown signal"Fix GitHub Actions jobs killed by "The runner has received a shutdown signal" on spot/preemptible runners - t… Runner lost connectionFix GitHub Actions "The operation was canceled" from a runner that lost communication - host crash, OOM, spot… "Unsupported runner OS"Fix the GitHub Actions self-hosted error "The runner is using an unsupported operating system" so it can regi… "Runner version deprecated"Fix the GitHub Actions self-hosted "runner version is deprecated and will stop receiving updates" warning bef… "Runner unable to update labels"Fix GitHub Actions "The runner was unable to update the labels" - a self-hosted runner failed to register or… "self-hosted runner is offline"Fix jobs that never start because the targeted self-hosted runner is offline or disconnected. "Self-hosted lost connection"Fix a self-hosted GitHub Actions runner that lost connection mid-job, failing the run and dropping the runner… "Runner never comes online"Fix a GitHub Actions job that waits for a self-hosted runner that never registers or connects, leaving the ru… "timeout waiting for all conclusions"Fix a deployment or gate job that times out waiting for all required check conclusions to report. "Too many requests to GitHub API"Fix GitHub Actions jobs that hit GitHub API rate limits mid-run - too many requests from gh, github-script, o… "Queued forever"Fix a GitHub Actions job stuck on "Waiting for a runner to pick up this job..." that never starts and stays q… Larger runner waitingFix GitHub Actions jobs queued forever on a larger or custom runner label - the runner group is out of capaci… Workflow disabled for inactivityFix a GitHub Actions workflow that was disabled because the repository was inactive, and learn how to re-enab… "startup_failure"Fix a workflow run that fails with conclusion startup_failure before any job runs - usually an invalid workfl… "Concurrency limit reached"Fix GitHub Actions "You have exceeded the maximum number of concurrent jobs for your plan" - queued jobs are… github-script errorsFix actions/github-script failures - an unhandled promise without await, a ReferenceError for an undefined he… setup-dotnet versionFix actions/setup-dotnet failing to install a .NET SDK - a version not in the release index, a global.json pi… "setup-dotnet SDK not found"Fix actions/setup-dotnet "Could not find dotnet-install scripts" / SDK version not found - the requested .NET… setup-go versionFix actions/setup-go failing to resolve a Go version - a too-specific or non-existent go-version, a missing g… ecr-login failsFix aws-actions/amazon-ecr-login errors - missing AWS credentials in the job, no ecr:GetAuthorizationToken pe… "checkout: couldn't find remote ref"Fix actions/checkout "couldn't find remote ref" - the ref input points at a branch, tag, or SHA that does not… "Codecov token required"Fix codecov/codecov-action "Token required" / tokenless rate limit - tokenless uploads are rate-limited, so a… "Input required and not supplied"Fix "Input required and not supplied: X" in a composite action in CI - the action declares a required input t… composite "jobs" not allowedFix a composite action that fails because it declares jobs or a job-level uses in CI - a composite action def… composite "outputs" emptyFix a composite action output that reads empty in the caller in CI - the action must declare outputs and map… Deploy concurrency deadlockFix a GitHub Actions deploy that hangs because two jobs share a concurrency group and wait on each other. "concurrency limit reached"Fix jobs queuing because the account/plan concurrent-jobs limit for GitHub-hosted runners is reached. container options errorFix GitHub Actions container job options errors - unsupported docker flags in jobs.<id>.container.options, or… Container job failedFix GitHub Actions container job failures - a missing image, registry auth, an entrypoint that exits, or volu… "container ran out of memory (OOMKilled)"Fix the GitHub Actions error where a container job process is OOMKilled because it exceeded the memory availa… container volume deniedFix GitHub Actions container job "permission denied" on volumes - the container user UID differs from the run… defaults.run ignoredFix GitHub Actions defaults.run not taking effect - defaults only apply to run steps, are overridden per step… Docker action platformFix GitHub Actions Docker-based action platform errors - an arm64 action image on an amd64 runner (or vice ve… "toomanyrequests" pullFix GitHub Actions Docker-action failures from the Docker Hub pull rate limit - anonymous pulls hit "toomanyr… "failed to initialize builder"Fix docker/setup-buildx-action "failed to initialize builder" - buildx could not create the builder instance,… setup-buildx driverFix docker/setup-buildx-action failing to bootstrap a builder - a missing QEMU step for cross-arch, an unavai… rust-toolchain installFix dtolnay/rust-toolchain errors - an unknown toolchain channel, a missing component for that channel, or a… Step summary missingFix GitHub Actions job summaries that do not render - writing to the wrong target, exceeding the per-step sum… "GITHUB_TOKEN expired (long job)"Fix GitHub Actions auth failures late in a long-running job - the GITHUB_TOKEN has a limited lifetime and exp… "HttpError: Not Found"Fix actions/github-script "HttpError: Not Found" - a 404 from wrong owner/repo/number parameters, a private r… "CodeQL out of disk / killed (OOM)"Fix github/codeql-action failures from running out of disk or memory - large codebases exhaust the runner dur… setup-gradle downloadFix gradle/actions/setup-gradle failing to fetch the Gradle distribution - a transient services.gradle.org ou… setup-terraform installFix hashicorp/setup-terraform failing - a non-existent terraform_version, a transient releases.hashicorp.com… "setup-terraform wrapper output not captured"Fix hashicorp/setup-terraform wrapper conflicts - the action wraps the terraform binary, and steps that call… Wrong runner picked jobFix GitHub Actions jobs running on an unintended self-hosted runner - overlapping labels let a different runn… Job stuck queuedFix a GitHub Actions job stuck on "Waiting for a runner" - no runner matches the labels, the self-hosted runn… Runner label routingFix GitHub Actions label-based runner routing - overlapping labels across runner fleets route jobs to an unin… Larger runner labelFix GitHub Actions larger runner labels that queue forever - the runner group is not granted to the repo, or… "macOS runner queue"Fix slow GitHub Actions macOS runner provisioning where jobs sit queued for minutes waiting for scarce macOS… "No pnpm version is specified"Fix pnpm/action-setup "No pnpm version is specified" - neither the version input nor packageManager in packag… "Cannot find Ruby version"Fix ruby/setup-ruby "unknown Ruby version" - the requested Ruby is not prebuilt for the runner OS or the .rub… setup-ruby bundler-cacheFix ruby/setup-ruby with bundler-cache: true failing - a missing Gemfile.lock, an uncommitted lockfile, or bu… "./script.sh: Permission denied"Fix the GitHub Actions run-step error "Permission denied" when executing a checked-in script - the file lacks… connection lost mid-stepFix a GitHub Actions job that fails when the runner loses its connection to the service partway through a ste… "No space left on device"Fix GitHub Actions "No space left on device" - the runner filled its disk during a job, breaking writes, chec… Runner group no accessFix GitHub Actions jobs that never pick up on org runners - the runner group does not grant the repository ac… Runner OOM (137)Fix GitHub Actions runner out-of-memory failures - a step exits 137 (OOM-killed) because the build or test ex… runs-on array/groupFix GitHub Actions runs-on confusion - a label array ANDs all labels, while group/labels selection uses an ob… runs-on expressionFix GitHub Actions runs-on built from a matrix or expression that does not resolve - quoting, fromJSON for ar… "runs-on label typo"Fix a GitHub Actions job that never starts because of a runs-on label typo like "ubntu-latest" that matches n… Runner version too oldFix self-hosted runners that fail or loop because the agent is too old - GitHub requires a recent version, an… Runner offlineFix a GitHub Actions self-hosted runner showing Offline - the runner service stopped, lost network, or its to… Registration failedFix self-hosted runner registration failures with config.sh - an expired registration token, a wrong URL/scop… "could not connect on mapped port"Fix the GitHub Actions error where a job step cannot connect to a service container on its mapped port - wron… container health-cmd invalidFix a service container that never becomes healthy because the health-cmd passed through options is malformed. service port not exposedFix steps that cannot reach a service container because the port mapping was not declared or the wrong host i… Service port unreachableFix GitHub Actions service containers you cannot connect to - using localhost from a container job, or not ma… Service container unhealthyFix GitHub Actions service containers (Postgres, Redis, MySQL) that never become healthy - missing health che… "setup-* failed to download"Fix the GitHub Actions error where a setup-* action fails to download a toolchain because of a transient netw… "driver-opts" invalidFix the GitHub Actions docker/setup-buildx-action error caused by invalid driver-opts input. "Unable to find Go version"Fix actions/setup-go "Unable to find Go version" - the requested Go version is not published for the runner p… "Could not find satisfied version for SemVer"Fix actions/setup-java "Could not find satisfied version" - no JDK from the chosen distribution matches the r… setup-java versionFix actions/setup-java "Could not find satisfied version" - a distribution that lacks the requested JDK, or a… "Unable to find Node version for platform"Fix actions/setup-node "Unable to find Node version for platform" - the requested Node version is not publish… setup-node versionFix actions/setup-node "Unable to find a version that satisfied" - a node-version range with no match, a miss… "Python version not found"Fix actions/setup-python "Version X was not found" - the requested Python version is not in the runner tool c… setup-python versionFix actions/setup-python "Version X not found" - a patch with no prebuilt binary, the wrong runner architectu… setup-php versionFix setup-php failing to install a PHP version - a non-existent php-version, an unsupported version on the ch… "fatal: ambiguous argument (changed-files)"Fix tj-actions/changed-files "fatal: ambiguous argument" - a shallow checkout lacks the history needed to dif… "fatal: ambiguous argument main^...HEAD"Fix github/super-linter failing to diff because the default branch was not fetched with full history. "401 Unauthorized from releases.hashicorp.com"Fix hashicorp/setup-terraform failing with a 401/network error while downloading the Terraform binary. "bad CPU type in executable"Fix "bad CPU type in executable" on a macos-latest runner - an x86_64-only binary runs on Apple silicon witho… brew update "not in a git directory"Fix "fatal: not in a git directory" during brew update on a macos-latest runner - Homebrew core or a tap lost… dyld "Library not loaded ... image not found"Fix "dyld: Library not loaded: ... Reason: image not found" on a macos-latest runner - a binary links against… "Failed to load CoreSimulator framework"Fix "Failed to load CoreSimulator framework" on a macos-latest runner - the simctl service and the framework… ld "library not found for -lSystem"Fix "ld: library not found for -lSystem" on a macos-latest runner - the linker cannot find the base system li… "No such file or directory @ rb_sysopen"Fix Ruby "Errno::ENOENT: No such file or directory @ rb_sysopen" on a macos-latest runner - a gem or script t… "Operation not permitted"Fix "Operation not permitted" on a macos-latest runner - System Integrity Protection or Gatekeeper blocked wr… security "parameters passed ... not valid"Fix "security: SecKeychainItemImport: One or more parameters passed to a function were not valid" on a macos-… "could not be found in the keychain"Fix "The specified item could not be found in the keychain" on a macos-latest runner - codesign or security c… "Too many open files"Fix "Too many open files" / EMFILE on a macos-latest runner - the default file descriptor limit is low, so fi… "Unable to boot device ... cannot be located on disk"Fix "Unable to boot device because it cannot be located on disk" on a macos-latest runner - the simulator UDI… xcrun "invalid active developer path"Fix "xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools)" on a macos-latest run… codesign "not signed at all"Fix codesign "code object is not signed at all" on a macos-latest runner - a verify or notarize step found an… codesign "errSecInternalComponent"Fix codesign "errSecInternalComponent" on a macos-latest runner - signing failed because the keychain holding… codesign "User interaction is not allowed"Fix codesign "errSecInteractionNotAllowed: User interaction is not allowed" on a macos-latest runner - the ke… brew link "already exists"Fix Homebrew "Could not symlink ... Target ... already exists" / "brew link" conflicts on a macos-latest runn… brew "cannot be installed as a binary package"Fix Homebrew "Error: <formula>: no bottle available!" / "cannot be installed as a binary package" on a macos-… brew "already installed"Fix Homebrew "Error: <formula> is already installed" on a macos-latest GitHub Actions runner - the image pre-… brew "Permission denied @ apply2files"Fix Homebrew "Error: Permission denied @ apply2files - /usr/local/..." on a macos-latest runner - Homebrew ca… "simulator runtime ... not available"Fix "Unable to find a destination" / "iOS X.Y is not installed" / runtime download prompts on a macos-latest… notarytool "401 Unable to authenticate"Fix notarytool "Error: HTTP status code: 401. Unable to authenticate" / "Invalid credentials" on a macos-late… notarytool status "Invalid"Fix notarytool returning status "Invalid" on a macos-latest runner - the upload authenticated but the notary… scheduled job queues for a runnerFix scheduled GitHub Actions jobs that queue waiting for a runner - self-hosted or concurrency-limited pools… matrix under a scheduleRun a matrix build on a schedule in GitHub Actions and avoid pitfalls - matrix expands the same on cron as on… "nothing to commit, working tree clean"Understand stefanzweifel/git-auto-commit reporting "nothing to commit" when no files changed in the working t…

"secret ... is empty" under actFix act secrets that read as empty - act loads secrets from a .secrets file or -s/--secret-file flags, and a… "GITHUB_TOKEN ... not set"Fix act steps that need GITHUB_TOKEN - act does not mint a token like GitHub does, so you must supply one wit… environment protection not enforcedUnderstand act and GitHub environments - act does not enforce environment protection rules or required review… "Unable to get ACTIONS_ID_TOKEN"Fix act OIDC failures - act has no GitHub OIDC provider, so id-token requests and cloud OIDC logins that work… "Context access might be invalid"Fix the "Context access might be invalid: SECRET_NAME" warning in CI - the editor/linter cannot confirm the s… "Input required and not supplied: token"Fix "Error: Input required and not supplied: token" in CI - an action requires a token input but the secret e… "Unrecognized named-value: 'secrets'"Fix "Unrecognized named-value: 'secrets'" in CI - the secrets context was used where it is not available, suc… "Error: HttpError: Not Found"Fix actions/github-script "HttpError: Not Found" when the script targets the wrong owner/repo or a resource t… "Resource not accessible by integration"Fix actions/github-script "Resource not accessible by integration" caused by a missing contents: write (or ot… "You have exceeded a secondary rate limit"Fix actions/stale hitting GitHub's secondary rate limit when processing many issues/PRs in one run. "! [remote rejected] (protected branch hook declined)"Fix ad-m/github-push-action "remote rejected" caused by branch protection rules blocking the push. "no basic auth credentials"Fix aws-actions/amazon-ecr-login "no basic auth credentials" caused by missing or unconfigured AWS credential… Branch not allowed to deploy to environmentFix "Branch is not allowed to deploy to <environment>" in CI - the environment deployment branch policy restr… Environment "Required reviewers"Fix a deployment job waiting on environment "Required reviewers" in CI - the environment protection rule hold… Environment secret emptyFix environment secrets being empty in CI - a secret defined on an environment is only available to jobs that… "Branch is not allowed to deploy"Fix the GitHub Actions error where a branch is not allowed to deploy to a protected environment due to deploy… "secrets context ... not allowed" in withFix "you cannot use the secrets context in with" in CI - a reusable-workflow with: input value must not refer… "could not read Username"Fix the GitHub Actions "could not read Username for https://github.com" error caused by a git operation runni… GHCR push deniedFix GitHub Actions "denied: permission_denied" pushing images to ghcr.io - the GITHUB_TOKEN needs packages: w… Deployment status write deniedFix the GitHub Actions error where updating a deployment status is denied because the token lacks deployments… "Deployment was rejected"Understand and resolve GitHub Actions deployments that are rejected by required environment reviewers under p… "Failed to create deployment"Fix the GitHub Actions "Failed to create deployment" error - the deployments API call failed due to permissio… "denied" pushing to ghcr.ioFix the GitHub Actions error pushing an image to ghcr.io - the job is missing packages: write or the login to… "GITHUB_TOKEN" read-only on fork PRFix the GitHub Actions error where GITHUB_TOKEN has no write access on a forked-PR workflow run. "422 Reference does not exist"Fix "HTTP 422 Reference does not exist" creating a release - the target tag or commit ref is not present in t… "Bad credentials"Fix GitHub Actions "HttpError: Bad credentials" - an expired, malformed, or wrong token passed to the GitHub… "id-token: write" not propagatedFix OIDC failures when calling a reusable workflow - id-token: write must be granted on the calling job, not… "id-token: write" not grantedFix a reusable-workflow OIDC failure in CI - id-token: write must be granted by the caller for the called wor… "Input required and not supplied: token"Fix the GitHub Actions error "Input required and not supplied: token" caused by an action that needs a token… "token not supplied"Fix GitHub Actions "Input required and not supplied: token" - an action that needs a token input but received… "requires approval"Fix GitHub Actions runs stuck "requires approval" on first-time-contributor pull requests - a maintainer must… "403" publishing to GitHub PackagesFix the GitHub Actions npm publish 403 to GitHub Packages - wrong scope, registry, or missing packages: write. Push permission deniedFix GitHub Actions "Permission denied to github-actions[bot]" / 403 when pushing - the token lacks contents:… permission denied packages: writeFix the GitHub Actions denied error pushing to GitHub Container Registry caused by the GITHUB_TOKEN missing t… "Permission to X denied to github-actions[bot]"Fix the GitHub Actions error where a push is denied to github-actions[bot] because the GITHUB_TOKEN lacks con… "permissions" invalid scopeFix the GitHub Actions invalid workflow error where a permissions block lists an unknown scope or value. "Pull request not mergeable"Fix a GitHub Actions auto-merge step that fails with "Pull request is not mergeable" - branch protection, con… "protected branch" push rejectedFix the GitHub Actions error pushing to a protected branch with GITHUB_TOKEN - branch protection blocks the d… "refusing to allow a GitHub App ..."Fix the GitHub Actions error refusing to let a GitHub App create or update workflow files because the token l… "App cannot update workflow"Fix GitHub Actions "refusing to allow a GitHub App ... to create or update workflow" - pushing changes to .gi… "cannot approve your own deployment"Fix the GitHub Actions environment gate where required reviewers cannot approve their own deployment, leaving… "Resource not accessible by integration"Fix the GitHub Actions "Resource not accessible by integration" 403 caused by the GITHUB_TOKEN lacking the pe… "Resource not accessible"Fix GitHub Actions "Resource not accessible by integration" - the GITHUB_TOKEN lacks the permission for the A… "Resource not accessible"Fix "Resource not accessible by integration" when commenting on issues/PRs - the GITHUB_TOKEN lacks issues: w… "Resource not accessible by integration (fork PR)"Fix GitHub Actions "Resource not accessible by integration" when a workflow triggered by a pull_request from… "not accessible by PAT"Fix GitHub Actions "Resource not accessible by personal access token" - a PAT missing the required scope, or… "Resource not accessible by personal access token"Fix "Resource not accessible by personal access token" when a fine-grained PAT lacks the required repository… checks write deniedFix GitHub Actions check-run / annotation failures - the GITHUB_TOKEN lacks checks: write, so actions that pu… Deployment write deniedFix GitHub Actions deployment / deployment-status API failures - the default GITHUB_TOKEN lacks the deploymen… statuses write deniedFix GitHub Actions commit-status failures - setting a commit status via the statuses API needs statuses: writ… "Secret ... not found" in reusableFix "Secret X not found" inside a reusable workflow in CI - secrets do not flow automatically; the caller mus… "::set-env:: disabled (security)"Fix the GitHub Actions error where the legacy "::set-env::" workflow command is disabled for security and mus… "The deployment branch is not allowed"Fix the deployments-API error "The deployment branch is not allowed" when creating a deployment via the API f… "awaiting approval from required reviewers"Resolve a deployment job that is waiting on an environment protection rule requiring reviewer approval. "top-level permissions must be a mapping"Fix GitHub Actions "permissions must be a mapping" - the permissions key was given a value that is not a scop… "Unable to get ACTIONS_ID_TOKEN_REQUEST_URL"Fix the GitHub Actions OIDC error "Unable to get ACTIONS_ID_TOKEN_REQUEST_URL" - the job is missing id-token:… "Unexpected value permissions"Fix "Unexpected value permissions" in GitHub Actions - the permissions key was placed at the wrong level or w… "Unexpected value 'secrets'"Fix "Unexpected value 'secrets'" in CI - secrets: was placed where it is not allowed, such as on a non-callin… "Waiting for approval to run workflows"Resolve a PR stuck at "Waiting for approval to run workflows" by having a maintainer approve the queued run. "is requesting ... but is only allowed"Fix "the workflow is requesting X, but is only allowed Y" in CI - GITHUB_TOKEN permissions in a called workfl… "requires approval to run workflows"Understand why a first-time contributor PR shows "This workflow requires approval" and how a maintainer appro… "exceeded a secondary rate limit"Fix "You have exceeded a secondary rate limit" from the GitHub API when a workflow makes too many requests to… 403 pushing with GITHUB_TOKENFix the GitHub Actions 403 error when pushing with the GITHUB_TOKEN, caused by a missing contents write scope… "attest: id-token permission required"Fix actions/attest-build-provenance failures - the job lacks id-token: write or attestations: write needed to… "Get Pages site failed (not enabled)"Fix actions/configure-pages "Get Pages site failed" - GitHub Pages is not enabled for the repository or not s… "deploy-pages: deployment failed"Fix actions/deploy-pages deployment failures - a missing github-pages environment, branch protection rules, o… "actions/stale: API rate limit exceeded"Fix actions/stale "API rate limit exceeded" - the stale bot processed too many issues/PRs in one run and hit… "artifact retention exceeds org policy"Fix the GitHub Actions error where an artifact retention-days value is higher than the maximum allowed by org… Attestation permissionFix actions/attest-build-provenance failures - the job needs attestations: write and id-token: write to sign… "Az CLI Login failed"Fix azure/login "Error: Az CLI Login failed" - the service principal credentials or OIDC federation could not… azure/login federatedFix azure/login OIDC federated errors - missing id-token: write, a federated credential subject that does not… Deployments permissionFix GitHub Actions 403 creating a Deployment or deployment status - the GITHUB_TOKEN needs deployments: write… GHCR pull deniedFix GitHub Actions failing to pull a private ghcr.io image - the GITHUB_TOKEN needs packages: read and the pa… permissions in composite actionFix a composite action that tries to declare permissions, which is only valid at the workflow or job level. "could not read Username (submodule)"Fix actions/checkout "fatal: could not read Username for https://github.com" on submodules - the default toke… Submodule auth failedFix the actions/checkout error fetching recursive submodules - the default token cannot authenticate to priva… checkout persisted credentials 403Fix the GitHub Actions 403 when pushing after actions/checkout, caused by the persisted GITHUB_TOKEN lacking… codecov tokenFix codecov/codecov-action upload failures - a missing CODECOV_TOKEN on private repos, a transient upload end… "composite action cannot access secrets"Fix the GitHub Actions error where a composite action references the secrets context directly, which is not a… reusable concurrency conflictsFix concurrency problems with a reusable workflow in CI - a concurrency group inside the called workflow can… "Could not load credentials (OIDC)"Fix aws-actions/configure-aws-credentials "Could not load credentials" with OIDC - the job lacks id-token: wr… "no provider in chain"Fix aws-actions/configure-aws-credentials "Credentials could not be loaded" with no provider - neither static… GITHUB_TOKEN read-only pushFix a GitHub Actions push that is denied - the default GITHUB_TOKEN is read-only and needs contents: write to… default token permissions 403Fix the GitHub Actions 403 caused by the repository or org default GITHUB_TOKEN being read-only, so write API… Environment URL missingFix a GitHub Actions deployment environment with no clickable URL - the job needs environment: name + url, an… "secret id not provided"Fix the GitHub Actions docker build error where a Dockerfile RUN --mount=type=secret references a secret id t… "buildx failed with: ERROR: denied"Fix docker/build-push-action "ERROR: denied" - buildx could not push the image because the registry rejected… "Username and password required"Fix docker/login-action "Error: Username and password required" - the action got an empty username or passwor… deployment branch policy invalidFix deployments blocked because the environment’s deployment branch policy pattern does not match the deployi… environment protection rules blockedFix the GitHub Actions situation where a deployment is blocked or waiting because environment protection rule… "environment secret not available (fork PR)"Fix the GitHub Actions error where an environment secret is empty because the workflow runs from a forked pul… Environment secrets emptyFix GitHub Actions environment secrets that come through empty - a job must declare environment: to receive t… Env secret emptyFix GitHub Actions environment secrets coming through empty - environment-scoped secrets only load when the j… environment URL invalidFix GitHub Actions deployment environment_url problems - a missing or non-HTTP(S) URL, or expecting the URL t… Environment gate blocksFix GitHub Actions deploy jobs stuck on environment protection - a required reviewer, a wait timer, or a bran… Fork PR read-only tokenFix GitHub Actions fork pull-request runs that cannot comment, label, or push - pull_request from a fork alwa… "GITHUB_PATH append not taking effect"Fix the GitHub Actions issue where appending to GITHUB_PATH does not update PATH in the current step. "GITHUB_TOKEN cannot access another repository"Fix cross-repository calls failing because the automatic GITHUB_TOKEN is scoped only to the workflow reposito… GITHUB_TOKEN does not trigger workflowsFix the GitHub Actions behavior where events created with the default GITHUB_TOKEN do not trigger further wor… token permissions reset to readFix write operations failing with 403 because the org/repo default GITHUB_TOKEN permission is read-only. Token read-only defaultFix GitHub Actions 403s when the repo default GITHUB_TOKEN permission is read-only - set workflow permissions… GITHUB_TOKEN "Resource not accessible"Fix "Resource not accessible by integration" inside a reusable workflow in CI - the GITHUB_TOKEN was restrict… "Bad credentials" (github-script)Fix actions/github-script "Bad credentials" - the Octokit client is using a missing, empty, or wrong token. "github-script: Resource not accessible by integration"Fix actions/github-script failing with "HttpError: Resource not accessible by integration" - the default toke… "not accessible by integration"Fix actions/github-script "Resource not accessible by integration" - the default GITHUB_TOKEN lacks the write… google-auth WIFFix google-github-actions/auth Workload Identity Federation errors - missing id-token: write, a wrong provide… "workload identity audience mismatch"Fix google-github-actions/auth workload identity failures - the OIDC token audience, provider, or subject doe… "github-pages-deploy permission denied"Fix JamesIves/github-pages-deploy-action permission-denied push errors - the token cannot push to the deploy… "failed to pull container: invalid credentials"Fix a job-level container failing to pull because the registry credentials provided under container.credentia… Environment protectionUnderstand GitHub Actions jobs blocked by environment protection rules - required reviewers, wait timers, or… concurrency scopeFix GitHub Actions concurrency applied at the wrong level - a workflow-level group serializes the whole run,… "Release/tag already exists"Fix ncipollo/release-action failures when a release or tag already exists - without allowUpdates the action e… "Incorrect token audience"Fix the GitHub Actions OIDC audience mismatch - the aud claim requested by the workflow does not match the cl… "Failed to get ID token"Fix GitHub Actions OIDC "Failed to get ID token" - a missing id-token permission, an unset request URL, or a… "No OpenIDConnect provider found"Fix the AWS OIDC error "No OpenIDConnect provider found" - the GitHub IAM identity provider is missing or has… OIDC aud mismatchFix GitHub Actions OIDC AssumeRole failures - the token audience (aud) or subject (sub) does not match the cl… "Not authorized to perform sts:AssumeRoleWithWebIdentity"Fix the AWS OIDC error "Not authorized to perform sts:AssumeRoleWithWebIdentity" - the IAM role trust policy… "Unable to get ACTIONS_ID_TOKEN_REQUEST_URL"Fix the GitHub Actions OIDC error "Unable to get ACTIONS_ID_TOKEN_REQUEST_URL" caused by the workflow missing… OIDC id-token errorFix GitHub Actions OIDC "Unable to get ACTIONS_ID_TOKEN_REQUEST_URL" - the job is missing id-token: write, ne… id-token not grantedFix GitHub Actions OIDC failures in reusable workflows - id-token: write must be granted by the caller and no… OIDC environment subjectFix GitHub Actions OIDC failures on environment jobs - the cloud trust policy expects an environment-scoped s… allowlist blocks third-party actionFix a uses step rejected because the organization actions policy allowlist does not permit that third-party a… Pages "Resource not accessible"Fix the GitHub Actions Pages permission error where the deploy job is denied because pages: write is not gran… Pages deploy deniedFix GitHub Actions Pages deployment failures - the job needs pages: write and id-token: write, plus Pages set… create-pull-request 403Fix peter-evans/create-pull-request failing to push or open a PR - missing pull-requests/contents write, or t… "pull_request_target untrusted checkout"Fix the dangerous GitHub Actions pattern where pull_request_target checks out the PR head, exposing secrets t… pull_request_target untrusted checkoutFix the GitHub Actions security pitfall where pull_request_target runs with secrets but checking out the PR h… pull_request_target riskFix the GitHub Actions pull_request_target security pitfall - it runs with write permissions and secrets, so… reusable "was not found" (access)Fix a cross-repo reusable-workflow call that fails to resolve in CI - the source repo must be public or in th… reusable secret not inheritedFix a GitHub Actions reusable workflow whose secrets are empty - secrets must be passed explicitly or with se… secrets: inherit missingFix GitHub Actions reusable-workflow secrets arriving empty - the caller must forward each secret explicitly… SARIF upload deniedFix GitHub Actions code-scanning SARIF upload failures - the upload step needs security-events: write, which… Secret empty/undefinedFix a GitHub Actions secret that resolves to empty - wrong name, repo vs environment vs org scope, or a secre… secret unavailable on fork PRFix the GitHub Actions issue where secrets are empty for workflows triggered by pull_request from a fork, by… env secret printed maskedFix readable text rendering as *** because the surrounding string happens to contain a secret value via an en… secret masked in matrix nameFix matrix leg names rendering as *** because an env var built from a secret was used to construct the matrix… secret env in run-nameFix a run-name that cannot include a secret-derived value because both env and secrets contexts are unavailab… secrets in if conditionsFix GitHub Actions where secrets in an if condition do not work - the secrets context is not available in job… Dependabot secrets emptyFix GitHub Actions secrets coming through empty on Dependabot pull requests - Dependabot-triggered runs use a… Secrets empty in fork PRsUnderstand why GitHub Actions secrets are empty in pull requests from forks - pull_request runs from forks ge… secrets: inherit not nestedFix secrets going missing two levels deep when the middle reusable workflow does not forward them onward. secrets: inherit + nestingFix secrets that go missing in a deeply nested reusable workflow in CI - secrets: inherit only passes from th… "slack-github-action: invalid_auth"Fix slackapi/slack-github-action "invalid_auth" - the bot token is missing, malformed, or lacks the scope for… slack-action webhookFix slackapi/slack-github-action errors - a missing/invalid webhook URL or bot token, the wrong technique for… "Resource not accessible by integration"Fix softprops/action-gh-release "Resource not accessible by integration" - the workflow token lacks contents:… action-gh-release 403Fix softprops/action-gh-release failing to publish a release - missing contents: write permission, or a non-t… "Get Pages site failed"Fix the github-pages error "Get Pages site failed" - Pages is not enabled or not set to GitHub Actions as the… "Permission to ... denied to github-actions[bot]"Fix "remote: Permission to OWNER/REPO.git denied to github-actions[bot]" in CI - GITHUB_TOKEN lacks contents… "refusing to allow a GitHub App to create or update workflow"Fix "refusing to allow a GitHub App to create or update workflow .github/workflows/... without workflows perm… "Resource not accessible by integration"Fix "Resource not accessible by integration" (HTTP 403) in CI - GITHUB_TOKEN lacks the write scope for the AP… scheduled runs use default-branch contextUnderstand the GITHUB_TOKEN and ref context on GitHub Actions scheduled runs - schedules run against the defa… Read-only default GITHUB_TOKENFix write failures caused by a read-only default GITHUB_TOKEN in CI - the org or repo sets default permission… GHCR push "denied"Fix GHCR "denied: permission_denied" / "installation not allowed" pushes in CI - pushing an image with GITHUB… Protected branch push rejectedFix protected-branch push rejections from GITHUB_TOKEN in CI - branch protection requires reviews or status c… Read-only token on fork PRFix write failures on fork pull_request events in CI - GITHUB_TOKEN is read-only for PRs from forks, so comme… "storage: bucket doesn't exist"Fix google-github-actions/upload-cloud-storage "bucket not found" caused by a wrong bucket name or missing ac… "Cache write is not permitted in this context"Understand gradle/gradle-build-action skipping cache writes on fork pull requests where the token is read-onl… "fatal: couldn't find remote ref"Fix JamesIves/github-pages-deploy-action "couldn't find remote ref" when the target deploy branch does not ex… "Error: missing token"Fix ncipollo/release-action failing with a missing token error when no GITHUB_TOKEN is supplied to the releas… "No OpenID Connect token request URL"Fix "No OpenID Connect token request URL or token request token" in CI - the runner has no ACTIONS_ID_TOKEN_R… "Not authorized to perform sts:AssumeRoleWithWebIdentity"Fix "Could not assume role with OIDC: Not authorized to perform sts:AssumeRoleWithWebIdentity" in CI - the AW… "An error occurred (InvalidIdentityToken)"Fix "An error occurred (InvalidIdentityToken)" during AWS OIDC login in CI - STS rejected the web identity to… AWS trust policy sub/aud mismatchFix AWS OIDC failures from a sub or aud condition mismatch in CI - the IAM trust policy StringEquals/StringLi… "AADSTS70021: No matching federated identity record"Fix Azure "AADSTS70021: No matching federated identity record found for presented assertion" in CI - the fede… Missing "permissions: id-token: write"Fix OIDC login failures caused by a missing "permissions: id-token: write" in CI - cloud auth actions cannot… "Unable to acquire impersonated credentials"Fix GCP Workload Identity "Unable to acquire impersonated credentials" in CI - the WIF pool/provider attribut… Reusable workflow missing id-tokenFix OIDC failures when a reusable workflow cannot get a token in CI - id-token: write must be granted on the… OIDC sub includes environmentFix OIDC failures where the token sub includes an environment claim in CI - jobs targeting an environment pro… "not permitted to create or approve pull requests"Fix peter-evans/create-pull-request failing because the org/repo setting blocks GitHub Actions from creating… Reusable workflow "secrets: inherit" missingFix reusable workflow secrets being empty in CI - the caller must pass secrets explicitly or use secrets: inh… Secret empty on fork PRFix secrets being empty on fork pull_request events in CI - GitHub withholds secrets from workflows triggered… "ENOGHTOKEN"Fix semantic-release "ENOGHTOKEN No GitHub token specified" by exposing GITHUB_TOKEN to the release step. "Validation Failed: already_exists"Fix softprops/action-gh-release "Validation Failed already_exists" when the tag or release already exists on…

actions/cache does nothing under actUnderstand act and actions/cache - the GitHub cache service does not exist locally, so actions/cache saves an… upload-artifact has no server under actFix act upload-artifact / download-artifact failures - these actions need the GitHub artifact service, so act… "Cache not found for input keys"Fix actions/cache "Cache not found for input keys: ..." in CI - no saved cache matched the exact key or any r… "Cache service responded with 429"Fix actions/cache "Cache service responded with 429" in CI - the cache backend rate-limited the request when… "Cache service responded with 503"Fix actions/cache "Cache service responded with 503" in CI - the cache backend was temporarily unavailable, u… "Cache size of X exceeds the ... limit"Fix actions/cache "Cache size of X B is over the 10GB limit, not saving cache" in CI - the cached paths grew… "Path Validation Error"Fix actions/cache "Path Validation Error: Path(s) specified ... do not exist" in CI - a cached path was not c… "reserveCache failed: Cache already exists"Fix actions/cache "Failed to save: reserveCache failed: Cache already exists. Scope: ..., Key: ..." in CI - a… "tar: Cannot open: No such file or directory"Fix actions/cache restore "tar: <path>: Cannot open: No such file or directory" in CI - tar failed to extract… "Unable to reserve cache"Fix actions/cache "Failed to save: Unable to reserve cache with key X, another job may be creating this cache… cache-hit output not checkedFix actions/cache rebuilds in CI - the cache restores but an install/build step runs unconditionally because… Cross-OS cache restore mismatchFix actions/cache cross-OS restore problems in CI - a cache saved on one runner OS is restored on another, pr… Cache save skipped on job failure/cancelFix actions/cache never saving in CI - the cache is written in a post step, so a job that fails before that s… restore-keys partial hit, cache-hit falseFix actions/cache restore-keys confusion in CI - a restore-keys prefix match restores an older cache but leav… Cache v1 brownout / 410 GoneFix actions/cache failures after the legacy cache service v1 shutdown in CI - old actions/cache versions hit… Cache version mismatch on restoreFix actions/cache "not restored" due to a version mismatch in CI - the cache version is derived from path and… "Cache service responded with 502 Bad gateway"Fix actions/cache@v4 cache restore failing with a 502 Bad gateway from the cache service (transient). "Artifact not found" for github-pagesFix actions/deploy-pages "Error: No artifact found for the deployment" in CI - the deploy job ran without a g… "Unable to download artifact(s): Artifact not found"Fix actions/download-artifact "Unable to download artifact(s): Artifact not found for name: X" in CI - the re… Cross-run download requires github-tokenFix actions/download-artifact failures when downloading from another workflow run in CI - v4 cross-run/cross-… v4 download cannot read v3 artifactsFix actions/download-artifact failures when mixing v3 and v4 in CI - artifacts uploaded with v3 cannot be dow… "Could not resolve a version... from node-version-file"Fix actions/setup-node failing to resolve a Node version from node-version-file due to a missing or malformed… "No file matched / could not determine version"Fix actions/setup-python caching errors when python-version-file points at a pyproject.toml without a resolva… "an artifact with this name already exists"Fix actions/upload-artifact v4 "Conflict: an artifact with this name already exists on the workflow run" in C… "Failed to CreateArtifact" (429)Fix actions/upload-artifact "Failed to CreateArtifact" with a 429 in CI - the artifact backend rate-limited t… "No files were found with the provided path"Fix actions/upload-artifact "No files were found with the provided path" in CI - the path glob matched nothin… "The artifact name is not valid"Fix actions/upload-artifact "The artifact name is not valid" in CI - the name contains characters GitHub forb… "This version of actions/upload-artifact is deprecated"Fix actions/upload-artifact v3 "This version of actions/upload-artifact is deprecated" in CI - the v3 artifac… Artifact upload size and file-count limitsFix actions/upload-artifact size and file-count problems in CI - very large uploads or huge file counts are s… "upload-artifact@v3 is deprecated"Resolve GitHub Actions "actions/upload-artifact@v3 is deprecated" - the v3 artifact backend is retired and wo… "name already exists"Fix GitHub Actions v4 upload "an artifact with this name already exists" - names are unique per run, so re-up… "artifact name exists"Fix GitHub Actions "Failed to CreateArtifact: an artifact with this name already exists" - v4 artifacts are i… "Artifact name is not valid"Fix GitHub Actions "Artifact name is not valid" - the upload-artifact name contains characters that are not a… "Artifact quota exceeded"Fix GitHub Actions "Artifact storage quota has been hit" - the account or org exceeded its Actions storage al… "artifact upload failed with status 500"Handle actions/upload-artifact failing with HTTP 500 - a transient backend error that usually clears on retry. "Cache already exists"Understand GitHub Actions cache immutability - once a key is saved you cannot overwrite it, so updated conten… "cache key contains invalid characters"Fix actions/cache failing because the key contains commas, or other characters that are not allowed. "Cache not found"Understand GitHub Actions "Cache not found for input keys" from actions/cache - no entry matched the primary… "Cache not found"Fix actions/cache "Cache not found for input keys" - a key that changes every run, missing restore-keys, or a… "cache service 429"Fix GitHub Actions "cache service responded with 429" - the cache backend rate-limited the request. It is tra… "Cache service error"Fix transient actions/cache "Cache service responded with 500/503" errors - backend blips that should not fai… "Cache upload failed 400"Fix GitHub Actions "Cache upload failed because the cache service responded with 400" - a transient save erro… "Cannot find any run with the given ID"Fix GitHub Actions "Cannot find any run with the given ID" when downloading an artifact from another workflow… Artifact not found across runsFix the GitHub Actions download-artifact error when pulling an artifact produced by a different workflow run. "Artifact name conflict"Fix GitHub Actions v4 "Conflict: an artifact with this name already exists on the workflow run" - v4 artifact… "Dependencies lock file is not found"Fix GitHub Actions "Dependencies lock file is not found" from setup-node caching - the action could not locat… "Failed to create step summary"Fix GitHub Actions "Failed to create step summary" - content written to GITHUB_STEP_SUMMARY exceeded the per-… "Artifact not found"Fix GitHub Actions "Failed to download artifact" - download-artifact could not find an artifact, usually a na… "Cache service 503/429"Fix GitHub Actions "Warning: Failed to restore: Cache service responded with 503" (or 429) - the cache backen… "cache service 503"Fix GitHub Actions "Warning: Failed to restore: Cache service responded with 503" - the cache backend was tem… "Cache already exists"Fix GitHub Actions "Failed to save cache: reserveCache failed: Cache already exists" - two jobs raced to save… "missing download info for actions/cache"Fix "Failed to restore: Cache service is not available / missing download info" caused by the actions/cache v… "No files found"Fix GitHub Actions upload-artifact "No files were found with the provided path" - the path glob matched nothi… "No files were found with the provided path"Fix the upload-artifact warning "No files were found with the provided path" - the path glob matched nothing,… Artifact upload failedFix actions/upload-artifact@v4 failures - "No files were found with the provided path", a wrong working direc… Cache path not foundFix actions/cache path errors - a path missing at save time, or a mismatch between save and restore paths, so… "post-job cleanup failed"Fix the GitHub Actions error where an action's post step (cache save, checkout cleanup) fails after the job's… "artifact name empty"Fix GitHub Actions "Provided artifact name input during validation is empty" - an upload/download-artifact na… "reserveCache failed"Fix actions/cache reserveCache failing because the cache entry is too large or the repo cache quota is exhaus… "Specified paths were not resolved"Fix the setup-* cache warning "Some specified paths were not resolved, unable to cache dependencies" - the ca… Artifact download failedFix actions/download-artifact@v4 "Unable to find an artifact" - wrong name, cross-run download without run-id… "Unable to reserve cache"Understand GitHub Actions "Unable to reserve cache" - two concurrent jobs raced to save the same cache key; t… "Cache Service Url not found"Fix actions/cache "Cache Service Url not found" - the cache backend environment variable is absent, often on… "cache No URL provided"Fix the GitHub Actions actions/cache "No URL provided" failure caused by missing cache-service configuration… "tar exited with error code 2"Fix actions/cache restore "tar exited with error code 2" - extraction of a cached archive failed, often a cor… "cache@v3 deprecated"Fix the GitHub Actions actions/cache@v3 deprecation warning by migrating to actions/cache@v4 before the old c… configure-pages failedFix actions/configure-pages failing - GitHub Pages not enabled with the Actions source, or a missing pages: w… deploy-pages artifactFix actions/deploy-pages failing to find the Pages artifact - a missing upload-pages-artifact step, a wrong a… "Unable to download artifact(s)"Fix actions/download-artifact "Unable to download" - the named artifact does not exist for the run, or a cros… "No files were found with the provided path"Fix actions/upload-artifact@v4 "No files were found with the provided path" - the path glob matched nothing,… "upload-artifact@v3 deprecated"Fix the GitHub Actions actions/upload-artifact@v3 (and download-artifact@v3) deprecation by migrating to v4. "No Pages artifact found"Fix deploy-pages "No artifact named github-pages-artifact found" - upload-pages-artifact did not run or point… compression-level errorFix GitHub Actions upload-artifact compression-level issues - an out-of-range value, or setting it on already… Artifact expiredFix GitHub Actions downloads failing because the artifact expired - artifacts have a retention period (defaul… Artifact path structureFix GitHub Actions artifacts with a wrong directory structure - the common parent is stripped or multiple glo… Artifact merge failedFix GitHub Actions artifact merge failures - combining matrix-produced artifacts with upload-artifact/merge w… "v3/v4 incompatible"Fix GitHub Actions artifact failures caused by mixing upload-artifact and download-artifact across v3 and v4,… "failed to export" gha cacheFix the GitHub Actions buildx error exporting the gha cache backend during a Docker build. buildx gha cacheFix docker/build-push-action type=gha cache export errors - a transient cache service blip, a missing scope,… "already creating this cache"Fix the GitHub Actions cache warning where another job is already creating the same cache key concurrently. "Cannot open: File exists"Fix actions/cache restore failing with tar "Cannot open: File exists" - files already present at the restore… Cache path no filesFix actions/cache "There is no matching files" - the path glob matched nothing at save time, so nothing is ca… "cache size exceeds 10GB"Fix the GitHub Actions cache error where a single cache entry exceeds the 10GB per-cache size limit. "tar Cannot open"Fix GitHub Actions cache "tar: <path>: Cannot open: No such file or directory" - the configured cache path do… "tar: Cannot mkdir: Permission denied"Fix the GitHub Actions cache error where tar cannot create the cache directory due to a permission denied. Cache evictedFix actions/cache entries that keep disappearing - the 10 GB per-repo cache limit evicts least-recently-used… fail-on-cache-missFix GitHub Actions jobs failing on a cache miss - fail-on-cache-miss: true makes a restore that finds no entr… Cache across runsFix GitHub Actions caches that miss across runs/branches - cache scope is keyed by branch, and feature-branch… "cache hit but restore incomplete"Fix the GitHub Actions issue where actions/cache reports a hit but the build still rebuilds because not all c… "Key changes every run"Fix a GitHub Actions cache that never hits because the key includes a value that changes on every run, such a… "Cache not updating"Fix a GitHub Actions cache that never reflects new content because the key is reused and cache entries are im… Cache key collisionFix GitHub Actions caches bleeding across branches - a key without a branch or lockfile component lets one br… lookup-only no filesUnderstand GitHub Actions actions/cache lookup-only - it checks for a cache entry without restoring files, so… Cache version mismatchFix GitHub Actions cache misses caused by a cache "version" mismatch - the same key restores nothing because… Cross-OS cache mismatchFix actions/cache misses or corruption across runners - a cache key without runner.os/arch lets a Linux cache… Cache key unstableFix an actions/cache that never restores because the key is non-deterministic - hashing a generated file, the… Cache not savedUnderstand why actions/cache does not save when the exact key already exists - caches are immutable, so a sta… "Slow / cold cache"Fix slow GitHub Actions cache restores and cold caches that make dependency-heavy jobs spend minutes download… "restore-keys not matching"Fix GitHub Actions cache restore-keys that never produce a partial hit because the prefixes do not actually m… restore-keys stale matchFix GitHub Actions caches that restore an old archive via restore-keys - a too-broad prefix matches a stale c… "Cache 10GB limit"Fix GitHub Actions cache misses caused by the 10 GB per-repository cache limit evicting older entries. cache-hit not checkedFix GitHub Actions workflows that rebuild on a cache hit - gate expensive steps on steps.<id>.outputs.cache-h… fail-on-cache-missFix GitHub Actions actions/cache/restore failing the job on a miss - fail-on-cache-miss: true makes an absent… restore without saveFix GitHub Actions caches that never persist - using actions/cache/restore alone skips the automatic save; yo… save/restore misuseFix GitHub Actions cache misses when using actions/cache/restore and actions/cache/save separately - mismatch… node_modules cacheFix caching node_modules that gives no speedup - npm ci wipes node_modules, postinstall steps differ, or you… metadata-action tagsFix docker/metadata-action emitting no tags - a missing images input, tag rules that match no event, or readi… Artifact from another runFix GitHub Actions downloading an artifact created by another run - actions/download-artifact needs run-id an… "Unable to find artifacts"Fix GitHub Actions download-artifact "Unable to find any artifacts for the associated workflow" when no artif… hashFiles empty keyFix a cache key that becomes empty because the hashFiles glob matched no files, collapsing the key and breaki… "hashFiles returned empty (no match)"Fix the GitHub Actions issue where hashFiles returns an empty string because its glob matched nothing, produc… hashFiles emptyFix GitHub Actions hashFiles() returning an empty string - the glob matched no files, so the cache key collap… "tool cache restore failed checksum"Fix a setup-* action failing because the downloaded toolchain failed checksum verification on restore. "setup-node cache lockfile not found"Fix actions/setup-node cache failures - with cache: npm/yarn/pnpm enabled, no lockfile matched the expected p… "paths not resolved"Fix the GitHub Actions setup-node cache warning "Some specified paths were not resolved, unable to cache depe… setup-* cache missFix setup-node / setup-python built-in caching that never restores - a missing lockfile, wrong cache-dependen… "path traversal" rejectedFix the GitHub Actions upload-artifact error where a path traversal outside the workspace is rejected. Artifact v3/v4 mismatchFix GitHub Actions artifact failures from mixing upload-artifact v3 with download-artifact v4 - the two major… "Deployment request failed" (no artifact)Fix the github-pages error where the deployment request failed because no github-pages artifact was uploaded…