Menu
Use when pre-commit hooks fail repeatedly, lint errors persist after make format, or local checks disagree with CI on pulp-tool.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when the user confirms paste-ready PR materials, or asks for a PR title/body, commit message, or CHANGELOG entry after substantive pulp-tool repo changes.
Use when changing the Dockerfile, .tekton/ PipelineRuns, pulp-tool-container image, UBI/Python base, or Konflux container build integration. Container images are built by Konflux Tekton — not GitHub Actions.
Use when changing upload, global CLI flags (--config, --build-id, --namespace), --rpm-path, --parent-package, --sbom-path, --artifact-results, Tekton workspace paths, or Konflux downstream integration. Container image *build*: changing-pulp-container.
Use when make test-diff-coverage fails, CI reports diff coverage below 100%, or a GitHub PR is blocked on uncovered changed lines.
| name | troubleshooting-pulp-tool-ci |
| description | Use when pre-commit hooks fail repeatedly, lint errors persist after make format, or local checks disagree with CI on pulp-tool. |
pre-commit run --all-files
Fix every failure, then re-run until one full run passes with zero failures. Do not commit after a partial fix without a subsequent clean run.
Single hook: pre-commit run <hook-id> --all-files
make lint # All linters
make format # Auto-fix Black
make lint-black # Check formatting only
make lint-flake8
make lint-pylint
make lint-mypy
Prefer Makefile targets over invoking tools directly.
| Issue | Solution |
|---|---|
| Black vs Flake8 E203 | E203 ignored in .flake8 — expected with Black |
| Mypy errors in specific modules | Check [[tool.mypy.overrides]] in pyproject.toml — may be intentional |
| Hooks fail on commit | Loop pre-commit run --all-files locally until clean |
.pre-commit-config.yaml — hookspyproject.toml — Black, Pylint, Mypy.flake8 — Flake8Makefile — targetsIf the failure is uncovered changed lines, use fixing-diff-cover-failures skill instead of guessing from lint output.