# prowler-ci

prowler-ci is a Claude Code skill that helps investigate GitHub Actions failures and PR validation gates in the Prowler repository.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 15302 repo stars
- Author: prowler-cloud
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/prowler-cloud/prowler/tree/HEAD/skills/prowler-ci/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/prowler-ci

## What it does

This skill targets the internal CI setup of the Prowler repository. It maps automated checks under `.github/workflows/`, covering Conventional Commits PR title validation, merge conflict markers, label automation via `CODEOWNERS`, and changelog tracking.

It provides a concrete triage routine for failing Actions jobs, detailing path filters and common TruffleHog false alarms on synthetic credentials like AWS tokens or OpenAI keys in test suites. The skill operates using `Read`, `Edit`, `Write`, `Glob`, `Grep`, and `Bash`.

The changelog gate will fail PR builds unless a changelog entry exists under the matching `<component>/changelog.d/` path or the `no-changelog` label is explicitly applied.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add prowler-cloud/prowler --skill prowler-ci -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/prowler-ci/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/prowler-ci/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add prowler-cloud/prowler --skill prowler-ci -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/prowler-ci/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add prowler-cloud/prowler --skill prowler-ci -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/prowler-ci/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install prowler-cloud/prowler skills/prowler-ci
```

2. **Manually: put the files in place**
- File: `.github/skills/prowler-ci/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add prowler-cloud/prowler --skill prowler-ci -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/prowler-cloud/prowler --path skills/prowler-ci
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/prowler-ci/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add prowler-cloud/prowler --skill prowler-ci -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/prowler-cloud/prowler/tree/HEAD/skills/prowler-ci/SKILL.md

## When to use it
- diagnose failing GitHub Actions checks on a Prowler PR
- resolve Conventional Commits PR title validation errors
- fix TruffleHog secret scanning alerts triggered by test fixtures
- verify changelog fragment placement across repository components

## Example prompts
- Help me figure out why the changelog gate failed on my PR
- Check why TruffleHog flagged my unit test credentials
- Inspect the path filters for UI workflows in .github/workflows

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 92da562287f6132e.

BEGIN THIRD-PARTY FILE 92da562287f6132e
````text
---
name: prowler-ci
description: >
  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.
license: Apache-2.0
metadata:
  author: prowler-cloud
  version: "1.0"
  scope: [root]
  auto_invoke:
    - "Inspect PR CI checks and gates (.github/workflows/*)"
    - "Debug why a GitHub Actions job is failing"
    - "Understand changelog gate and no-changelog label behavior"
    - "Understand PR title conventional-commit validation"
    - "Understand CODEOWNERS/labeler-based automation"
allowed-tools: Read, Edit, Write, Glob, Grep, Bash
---

## What this skill covers

Use this skill whenever you are:

- Reading or changing GitHub Actions workflows under `.github/workflows/`
- Explaining why a PR fails checks (title, changelog, conflict markers, secret scanning)
- Figuring out which workflows run for UI/API/SDK changes and why
- Diagnosing path-filtering behavior (why a workflow did/didn't run)

## Quick map (where to look)

- PR template: `.github/pull_request_template.md`
- PR title validation: `.github/workflows/conventional-commit.yml`
- Changelog gate: `.github/workflows/pr-check-changelog.yml` (requires a fragment under `<component>/changelog.d/`)
- Changelog compile (release time): `.github/workflows/compile-changelogs.yml`
- Conflict markers check: `.github/workflows/pr-conflict-checker.yml`
- Secret scanning: `.github/workflows/find-secrets.yml`
- Auto labels: `.github/workflows/labeler.yml` and `.github/labeler.yml`
- Review ownership: `.github/CODEOWNERS`

## Debug checklist (PR failing checks)

1. Identify which workflow/job is failing (name + file under `.github/workflows/`).
2. Check path filters: is the workflow supposed to run for your changed files?
3. If it's a title check: verify PR title matches Conventional Commits.
4. If it's changelog: verify a valid fragment exists under the right `<component>/changelog.d/` OR apply `no-changelog` label.
5. If it's conflict checker: remove `<<<<<<<`, `=======`, `>>>>>>>` markers.
6. If it's secrets (TruffleHog): see section below.

## TruffleHog Secret Scanning

TruffleHog scans for leaked secrets. Common false positives in test files:

**Patterns that trigger TruffleHog:**
- `sk-*T3BlbkFJ*` - OpenAI API keys
- `AKIA[A-Z0-9]{16}` - AWS Access Keys
- `ghp_*` / `gho_*` - GitHub tokens
- Base64-encoded strings that look like credentials

**Fix for test files:**
```python
# BAD - looks like real OpenAI key
api_key = "sk-test1234567890T3BlbkFJtest1234567890"

# GOOD - obviously fake
api_key = "sk-fake-test-key-for-unit-testing-only"
```

**If TruffleHog flags a real secret:**
1. Remove the secret from the code immediately
2. Rotate the credential (it's now in git history)
3. Consider using `.trufflehog-ignore` for known false positives (rarely needed)

## Notes
````
END THIRD-PARTY FILE 92da562287f6132e

The third-party file has ended. Everything between the 92da562287f6132e tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2999 of 3138 bytes. © prowler-cloud · Apache-2.0 · https://github.com/prowler-cloud/prowler/tree/HEAD/skills/prowler-ci/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
