cicd-scan

Reconstructs a codebase's CI/CD pipeline as an evidence-backed narrative of triggers, builds, gates, and releases.

3|1|Updated Aug 26, 2026
One-click install
npx skills add https://github.com/zeljkoobrenovic/sokrates-skills --skill cicd-scan-zeljkoobrenovic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cicd-scan
Source: https://github.com/zeljkoobrenovic/sokrates-skills/tree/main/skills/scanners/cicd-scan
Command: npx skills add https://github.com/zeljkoobrenovic/sokrates-skills --skill cicd-scan-zeljkoobrenovic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? CI/CD configuration files list steps but never explain the actual process a change goes through. This Skill reads workflow definitions, build files, and release scripts to reconstruct the full lifecycle — what runs on a PR, what gates a merge, how releases are versioned and published, and where artifacts get deployed — in language a new team member or auditor can follow. ## Core Features & Use Cases - Lifecycle Reconstruction: Maps the trigger surface (PR, push, tag, schedule, manual dispatch) and traces each stage from build through testing, quality gates, release, and deployment, following reusable-workflow chains and shell scripts to their leaves. - Pipeline Hygiene Audit: Flags risks like unpinned third-party actions, over-broad credentials, pull_request_target misuse, missing test gates on the release path, and secrets that could leak into logs. - Evidence-Backed Findings: Every claim cites the workflow or script lines it was read from, with declared facts distinguished from inferences and absences reported as findings. - Use Case: Ask "what happens when I push a tag starting with v?" and receive a narrative of the release flow — version bumping, changelog, artifact publishing to npm or other registries, signing, and deployment channels — plus any hygiene concerns. ## Quick Start Ask the AI to run the cicd-scan skill on this repository and explain how the project is built, tested, and released.

Frequently Asked Questions about cicd-scan

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

FAQPage Schema
How do I document what my CI/CD pipeline actually does?

Run this scanner against the repository to get a narrative of the full lifecycle: what triggers each workflow, how code is built and tested, which gates guard merges, and how releases are published. Findings cite the exact workflow and script lines they were derived from.

How to audit GitHub Actions workflows for security risks?

The pipeline-hygiene group flags unpinned third-party actions, over-broad credentials, pull_request_target misuse with PR code checkout, secrets that could leak into logs, and missing gates on the release path. Severity is calibrated from info up to high based on real attack surface.

Does this work without a Sokrates analysis folder?

Yes, it degrades gracefully without one. The _sokrates build and deployment index is treated as a supplement, and the scanner always globs .github/workflows/, .gitlab-ci.yml, Jenkinsfile, and similar files directly since CI files are often excluded from Sokrates indexes.

What is the difference between cicd-scan and tech-stack-scan?

tech-stack-scan inventories the tools — which CI provider, build system, and frameworks are present. cicd-scan explains the flow: what happens when you push, tag, or merge, and judges the hygiene of that process.

Why does the scanner report absences as findings?

Missing pipeline stages are meaningful facts, such as no deploy step in any workflow implying deployment lives elsewhere. Absence findings cite the nearest positive evidence that delimits them, like a release workflow's needs list lacking a test job.