skill-doctorbot-ci-validator
by bamontejano
Git & GitHubBrief
Stop failing in production.
Description
What This Skill Does
Validates CI/CD workflow files offline without a live environment or Docker container. Catches syntax and schema errors in GitHub Actions, GitLab CI, CircleCI, and Keep (AIOps) workflows before you push. Uses mocking to check structure and logic instantly.
Validates offline using mocking instead of requiring a live database or Docker container, so checks run instantly in any environment.
When to Use It
- Validate a GitHub Actions workflow before pushing a commit
- Check Keep AIOps workflow steps for schema errors
- Scan an entire .github/workflows/ directory for broken configs
- Add offline CI validation to a pre-commit hook
- Verify agent-generated workflow files before suggesting them to users
Example Workflow
User asks: validate my Keep workflow at workflows/alert-pipeline.yaml
- 1
Locate the workflow file at workflows/alert-pipeline.yaml
- 2
Run validate_keep.py against the file using the Keep-specific mocker
- 3
Parse the output for syntax errors, missing steps, or invalid providers
- 4
Return a structured report of issues with exact line-level locations
List of validation errors with line numbers, or confirmation that the workflow passes all checks
Installation
clawhub install bamontejano/skill-doctorbot-ci-validatorRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.