ci-workflow-linter

Identify security flaws and misconfigurations in CI pipelines.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/FrogAi/Xenopus --skill ci-workflow-linter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ci-workflow-linter
Source: https://github.com/FrogAi/Xenopus/tree/main/Gemini/Skills/Gemini%203.1%20Pro/ci-workflow-linter
Command: npx skills add https://github.com/FrogAi/Xenopus --skill ci-workflow-linter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Production-grade CI workflow security + hygiene linter for GitHub Actions / GitLab CI / CircleCI / Buildkite / Azure Pipelines / Jenkins. Scans for secret-leak risk (token echo, env print), third-party action pinning (SHA vs. mutable tag), GITHUB_TOKEN permissions (least-priv), timeout discipline, concurrent-run handling, cache-key staleness, expression injection via PR titles / bodies, untrusted-input handling, workflow-dispatch validation, OIDC federation setup, self-hosted runner config. Pulls GitHub Actions security-hardening + OWASP CI/CD Top 10 + OpenSSF Scorecard + StepSecurity catalog live. Read-only.

Core Features & Use Cases

  • Live guidance fetch from security docs (GitHub Actions security-hardening, OWASP CI/CD Top 10, OpenSSF Scorecard, StepSecurity catalog).
  • Each finding includes source citations and explicit remediation guidance.
  • Read-only analysis with structured, reproducible output and strict permission model.

Quick Start

Run the linter against your repository's CI workflows to generate a comprehensive security audit.

Frequently Asked Questions about ci-workflow-linter

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

FAQPage Schema
How do I audit GitHub Actions workflows for security flaws and misconfigurations?

To audit GitHub Actions workflows for security flaws, you can run a CI workflow linter that scans for secret-leak risks, third-party action pinning, and GITHUB_TOKEN permissions. It generates a read-only, structured report with citations and remediation guidance.

What CI pipeline security risks should I check for in GitLab CI and Jenkins?

When checking CI pipeline security risks in GitLab CI and Jenkins, look for untrusted-input handling, expression injection via PR titles, OIDC federation setup, and self-hosted runner config. A dedicated linter can identify these misconfigurations and provide live guidance from OpenSSF Scorecard and OWASP CI/CD Top 10.

Does this CI workflow linter support CircleCI, Buildkite, and Azure Pipelines?

Yes, this CI workflow linter supports CircleCI, Buildkite, and Azure Pipelines. It is applicable to these platforms alongside GitHub Actions, GitLab CI, and Jenkins workflows across both public and private repos to enforce security hygiene and timeout discipline.

How do I enforce least-privilege permissions and action pinning in my CI pipelines?

To enforce least-privilege GITHUB_TOKEN permissions and third-party action pinning (SHA vs mutable tag) in your CI pipelines, run a read-only security linter. It evaluates your workflow configurations against the StepSecurity catalog and outputs explicit remediation steps.

Why does my CI workflow have expression injection vulnerabilities from PR titles?

CI workflow expression injection vulnerabilities from PR titles occur when untrusted input is improperly evaluated in workflow scripts. A pipeline security linter detects this risk by checking untrusted-input handling and provides citations from GitHub Actions security-hardening docs for remediation.

What is the best way to check for secret-leak risks and cache-key staleness in CI pipelines?

The best way to check for secret-leak risks (like token echo or env print) and cache-key staleness in CI pipelines is using an automated linter. It performs read-only analysis to identify these hygiene issues and concurrent-run handling flaws, producing a reproducible structured report.