Automates and debugs GitHub Actions CI workflows and PR gate policies for Prowler.

Install

mkdir -p .claude/skills/prowler-ci && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/7400" && unzip -o skill.zip -d .claude/skills/prowler-ci && rm skill.zip

Installs to .claude/skills/prowler-ci

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Helps with Prowler repository CI and PR gates (GitHub Actions workflows). Trigger: When investigating CI checks failing on a PR, PR title validation, changelog gate/no-changelog label, conflict marker checks, secret scanning, CODEOWNERS/labeler automation, or anything under .github/workflows.
293 chars · catalog description✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Intermediate

Key capabilities

  • →Read or change GitHub Actions workflows
  • →Explain why a PR fails checks
  • →Figure out which workflows run for UI/API/SDK changes
  • →Diagnose path-filtering behavior
  • →Check PR title validation against Conventional Commits
  • →Verify changelog fragments or `no-changelog` label

How it works

This skill analyzes GitHub Actions workflows and PR details to explain CI check failures, diagnose path-filtering, and validate PR titles and changelog requirements.

Inputs & outputs

You give it
GitHub Actions workflow files, PR details (title, labels, changed files), or failing CI check information
You get back
Explanation for CI check failures, workflow execution logic, or guidance on resolving PR gate issues

When to use prowler-ci

  • →Debug failing GitHub Actions CI jobs
  • →Validate PR titles against conventional commits
  • →Enforce changelog requirements on pull requests
  • →Configure CODEOWNERS and labeler automation

About this skill

What this skill covers

  • Explaining why a PR check fails and how to reproduce it locally
  • Which workflows run for SDK/API/UI/MCP/docs changes and why (path filters)
  • Reading or changing GitHub Actions workflows under .github/workflows/

Use prowler-pr for creating PRs and filling the template; gh-aw for the agentic issue-triage workflow.

Workflow Naming

Workflow files are prefixed by area and the name: matches: sdk-* (SDK: ...), api-* (API: ...), ui-* (UI: ...), mcp-* (MCP: ...), helm-*, ci-* (CI: ...), docs-*/markdown-lint (Docs: ...), and repo tooling (Tools: ...: changelog, conventional commit, conflicts, labeler, backport, TruffleHog, release freeze). Component workflows use tj-actions/changed-files (or paths:) so they only do real work when their folder changes.

PR Gates: what fails and how to fix it

Check (workflow)Fails whenFix / reproduce locally
PR title (conventional-commit.yml)Title does not match ^(feat|fix|docs|style|refactor|perf|test|chore|build|ci|revert)(\([^)]+\))?!?: .+Edit the PR title
Changelog (pr-check-changelog.yml)Missing/invalid fragment, PR link in a fragment, or direct CHANGELOG.md editAdd <component>/changelog.d/<slug>.<type>.md (see prowler-changelog) or the no-changelog label
Conflicts (pr-conflict-checker.yml)Conflict markers (<<<<<<<, =======, >>>>>>>) in changed files; also labels has-conflictsRemove markers / rebase on master
Secrets (find-secrets.yml, TruffleHog)Verified or unknown secret in the PR diffSee TruffleHog below
Release freeze (release-freeze-gate.yml)Repo variable RELEASE_FREEZE is true (PRs to master)Wait for the release; not a code problem
Test __init__.py (check-test-init-files.yml)__init__.py inside tests/Delete it; python3 scripts/check_test_init_files.py .
Duplicate test names (sdk-check-duplicate-test-names.yml)Same *_test.py filename in two providers under tests/providers/Rename the test file with a provider prefix
Provider cards (docs-check-provider-cards.yml)docs/snippets/provider-cards.mdx out of syncpython3 docs/scripts/generate_provider_cards.py and commit
Compliance mapping (pr-check-compliance-mapping.yml)Never fails: comments and adds needs-compliance-review for new checks not mapped in a compliance JSONMap the check or add no-compliance-check

Component Checks (reproduce locally)

WorkflowRuns
sdk-code-quality.ymluv lock --check; uv run flake8 . --ignore=E266,W503,E203,E501,W605,E128 --exclude .venv,contrib,ui,api,skills,mcp_server; uv run black --exclude "\.venv|api|ui|skills|mcp_server" --check .; uv run pylint --disable=W,C,R,E -j 0 -rn -sn prowler/
sdk-tests.ymluv run pytest -n auto --cov=./prowler/providers/<provider> tests/providers/<provider> per changed provider (AWS narrows to changed services)
sdk-security.ymluv run bandit -q -lll -x '*_test.py,./.venv/,./contrib/,./api/,./ui' -r .; uv run vulture --exclude ".venv,contrib,api,ui" --min-confidence 100 .
api-code-quality.yml (in api/)uv lock --check; uv run ruff check . --exclude contrib; uv run ruff format --check . --exclude contrib; uv run pylint --disable=W,C,R,E -j 0 -rn -sn src/
api-security.yml (in api/)bandit + vulture (same flags style as SDK)
api-tests.ymlAPI pytest suite (needs PostgreSQL/Valkey services)
ui-tests.yml (in ui/)pnpm install --frozen-lockfile; pnpm run healthcheck (typecheck + lint + format check); pnpm run audit; unit tests (vitest related for changed files or full pnpm run test:unit); pnpm run test:integration; pnpm run build
ui-e2e-tests-v2.ymlPlaywright E2E, scoped by test-impact-analysis.yml (.github/test-impact.yml)
mcp-tests.yml (in mcp_server/)uv run pytest --cov=./prowler_mcp_server --cov-report=xml tests
ci-actionlint.yml, ci-zizmor.ymlactionlint and zizmor on workflows
markdown-lint.ymlmarkdownlint-cli 0.45.0 on tracked *.md
*-container-checks.yml, *-codeql.ymlContainer build/scan, CodeQL

Most of these also run as prek hooks: uv run prek run --files <changed files> is the fastest local check.

Debug Checklist (PR failing checks)

  1. gh pr checks <number> to find the failing workflow/job, then open its file in .github/workflows/.
  2. Check path filters: is the workflow supposed to run for your changed files?
  3. Map it to the tables above and run the same command locally.
  4. For workflows triggered by labels (labeled/unlabeled), re-apply or remove the label to re-run.

TruffleHog Secret Scanning

CI runs TruffleHog 3.99.2 on the PR diff with --results=verified,unknown, so fake values that match a detector format can fail too.

  • Test data: use obviously fake values that do not match real key formats, e.g. api_key = "sk-fake-test-key-for-unit-testing-only", not sk-...T3BlbkFJ... or AKIA + 16 chars.
  • Known false positive on a line: append the inline comment # trufflehog:ignore (used in tests/lib/utils/utils_test.py).
  • Real secret: remove it, rotate it (it is in git history), and tell the maintainers.
  • Local: uv run prek install --hook-type pre-push enables the TruffleHog hook before push.

Changing Workflows

  • Pin every action by full commit SHA with a version comment (uses: actions/checkout@<sha> # v6.0.2); start jobs with step-security/harden-runner; declare permissions: {} at the top and grant per job.
  • Run uv run prek run actionlint --files <workflow> and uv run prek run zizmor --files <workflow> before pushing. Workflows with pull_request_target carry # zizmor: ignore[...] justifications; keep them accurate.
  • Never edit issue-triage.lock.yml by hand (generated by gh-aw, see gh-aw).

Resources

  • PR template: .github/pull_request_template.md
  • Labels: .github/labeler.yml; review ownership: .github/CODEOWNERS
  • Composite actions: .github/actions/ (setup-python-uv, trivy-scan, grype-scan, osv-scanner, slack-notification)

How it compares

This skill provides targeted debugging and validation for GitHub Actions CI/CD, unlike general CI troubleshooting.

Compared to similar skills

prowler-ci side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
prowler-ci (this skill)110moNo flagsIntermediate
github-actions-templates77moNo flagsIntermediate
security-automation110moReviewAdvanced
bazel-build-optimization146moNo flagsAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry