github-actions-workflow-authoring

Audits GitHub Actions paths filters so gated workflows never skip silently.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/VilnaCRM-Org/claude-plugins --skill github-actions-workflow-authoring-vilnacrm-org
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-actions-workflow-authoring
Source: https://github.com/VilnaCRM-Org/claude-plugins/tree/main/plugins/react-frontend-sdlc/skills/github-actions-workflow-authoring
Command: npx skills add https://github.com/VilnaCRM-Org/claude-plugins --skill github-actions-workflow-authoring-vilnacrm-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A paths: filter on a GitHub Actions workflow decides whether the workflow runs at all. When the filter omits the workflow file itself, the Dockerfile, the Makefile, or the lockfile, a change to how the gate runs can skip the gate entirely — producing a green required check with zero jobs executed. This Skill audits and authors paths-gated workflows so every input that can change the result is listed. ## Core Features & Use Cases - Paths-filter authoring: Provides a core YAML pattern and per-workflow checklist covering the workflow file itself, threshold configs, report scripts, Dockerfile, .dockerignore, compose files, Makefile, test trees, bundler config, lockfile, and package manifest. - Silent-skip diagnosis: Detects required checks that report success with zero jobs executed, stale path entries pointing at renamed scripts, and filters that omit the workflow's own build inputs. - Repository-shape guidance: Applies the pattern across React SPA, Next.js, and component-library shapes, with the matching verification target (make lint-actionlint or make lint-workflows). - Use Case: After renaming a bundle-size report script, a pull request shows the bundle-size check green but no jobs ran. Use this Skill to find the stale path entry, add the workflow file and toolchain inputs to the filter, and re-verify with actionlint. ## Quick Start Audit the paths filters in my GitHub Actions workflows and add any missing inputs such as the workflow file itself, Dockerfile, Makefile, and lockfile.

Frequently Asked Questions about github-actions-workflow-authoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a GitHub Actions paths filter for a pull request workflow?▼

List every input that can change the job result under on.pull_request.paths: the source root, package manifest and lockfile, Dockerfile, .dockerignore, compose files, Makefile, gate configs and scripts, and the workflow file itself. Omitting the workflow file lets filter edits merge unvalidated.

Why does my required GitHub Actions check pass with no jobs executed?▼

A paths filter that matches nothing skips the workflow entirely, and GitHub may still report the required check as successful. Open the run summary to confirm jobs actually executed, then broaden the filter so the gate fires on relevant changes.

Should the workflow file itself be included in its own paths filter?▼

Yes. Without the workflow's own path in the filter, edits to the gate — a filter typo or a weakened step — merge without the gate ever running on them. List the exact file path, for example .github/workflows/bundle-size.yml.

How do I validate GitHub Actions workflow syntax after editing paths filters?▼

Run the repository's workflow lint target after every filter edit. React SPA shapes use actionlint via make lint-actionlint, while Next.js shapes run a zizmor-backed audit via make lint-workflows.

When should I not add a paths filter to a GitHub Actions workflow?▼

Skip paths filters when the workflow must run on every matching event, since unfiltered workflows already do that. Also avoid adding a gate to branch protection while its filter can skip it, because a skipped required check may block or pass unpredictably.