CI Status Badge Deployment
Summary
Generate and deploy a GitHub Workflow Status badge that reflects the combined outcome of automated build, test, and static analysis checks in a continuous integration pipeline. This skill visually communicates pipeline health to repository users and contributors.
When to use
Apply this skill when you have configured a GitHub Actions workflow that executes build, test, and quality checks, and you want to embed a machine-readable, auto-updating badge in your repository README to signal pipeline status at a glance. Use it after Sonarcloud or other CI quality gates are integrated into your workflow file.
When NOT to use
- Workflow file does not yet exist or has not been committed to the repository—badge will show an error state until the workflow is accessible.
- Repository is private and the workflow runs on private runners without public status exposure—badge may not render correctly.
- You are building a status indicator for a tool that does not use GitHub Actions (e.g., GitLab CI, Jenkins, CircleCI)—use platform-specific badge services instead.
Inputs
- GitHub repository with GitHub Actions workflows configured
- GitHub Actions workflow file (YAML) with defined jobs and steps
- Workflow name or filename (e.g., CI_build.yml)
- Repository owner and name
Outputs
- GitHub Workflow Status badge (shield.io SVG image)
- Badge markdown code for embedding in README
- Auto-updating CI status indicator visible in repository documentation
How to apply
Create a GitHub Actions workflow file (e.g., CI_build.yml) that triggers on push and pull request events, define job steps for build/test execution and static analysis integration, then reference the workflow in a GitHub Workflow Status badge URL using the format https://img.shields.io/github/actions/workflow/status/<owner>/<repo>/<workflow-filename>. The badge will automatically update to reflect the latest workflow run status (success, failure, or in-progress). Place the badge markdown in your README to display current CI status. The badge acts as a living document that requires no manual updates—GitHub Actions automatically refreshes it based on workflow execution results.
Related tools
- GitHub Actions (Orchestrates continuous integration workflow execution; workflow status is the source of truth for badge rendering) — https://github.com/features/actions
- Sonarcloud (Executes static code analysis and quality gates within the workflow; results feed into the overall CI status)
- shields.io (Generates and hosts the status badge SVG image based on GitHub Actions workflow status queries) — https://shields.io
- MS2Query (Example project using GitHub Actions workflow with Sonarcloud integration and CI status badge) — https://github.com/iomega/ms2query
Examples
[](https://github.com/iomega/ms2query/actions/workflows/CI_build.yml)
Evaluation signals
- Badge markdown renders without 404 or 'workflow not found' errors in the README.
- Badge SVG image updates to reflect the status of the most recent workflow run (green for success, red for failure, yellow for in-progress).
- Clicking the badge URL navigates to the GitHub Actions workflow run history page.
- Workflow file (CI_build.yml) exists in the repository and contains at least one job with a defined trigger event.
- Badge is visible in the rendered README on GitHub; status changes correlate with new workflow executions within 1–2 minutes.
Limitations
- Badge status reflects only the latest workflow run; historical or per-branch status requires additional dashboards or custom query parameters.
- Private repositories may not expose workflow status publicly; badge will fail or show a generic error unless explicitly configured for public visibility.
- Workflow file must be committed to the default branch; badge URLs referencing workflows on feature branches may not resolve correctly.
- Sonarcloud or other quality gate failures are reflected in the badge only if the workflow is configured to fail on those checks; warnings alone will not affect the overall badge status.
- Badge URL is static and must be manually placed in README; no automatic badge generation or discovery is performed.
Evidence
- [other] MS2Query uses a GitHub Actions workflow (CI_build.yml) that triggers on pull requests and integrates with Sonarcloud, producing a GitHub Workflow Status badge that reflects the combined outcome of build, test, and static analysis checks.: "MS2Query uses a GitHub Actions workflow (CI_build.yml) that triggers on pull requests and integrates with Sonarcloud, producing a GitHub Workflow Status badge that reflects the combined outcome of"
- [other] Configure GitHub Actions workflow file to trigger on push and pull request events to the ms2query repository.: "Configure GitHub Actions workflow file to trigger on push and pull request events to the ms2query repository."
- [readme] : ""
- [other] Integrate Sonarcloud static analysis step into the workflow to scan code quality and security metrics.: "Integrate Sonarcloud static analysis step into the workflow to scan code quality and security metrics."
- [other] Retrieve and document the Sonarcloud quality report output showing code coverage, technical debt, and quality gates status.: "Retrieve and document the Sonarcloud quality report output showing code coverage, technical debt, and quality gates status."
1---2name: ci-status-badge-deployment-23description: Use when you have configured a GitHub Actions workflow that executes build, test, and quality checks, and you want to embed a machine-readable, auto-updating badge in your repository README to signal pipeline status at a glance.4license: CC-BY-4.05---67# CI Status Badge Deployment89## Summary1011Generate and deploy a GitHub Workflow Status badge that reflects the combined outcome of automated build, test, and static analysis checks in a continuous integration pipeline. This skill visually communicates pipeline health to repository users and contributors.1213## When to use1415Apply this skill when you have configured a GitHub Actions workflow that executes build, test, and quality checks, and you want to embed a machine-readable, auto-updating badge in your repository README to signal pipeline status at a glance. Use it after Sonarcloud or other CI quality gates are integrated into your workflow file.1617## When NOT to use1819- Workflow file does not yet exist or has not been committed to the repository—badge will show an error state until the workflow is accessible.20- Repository is private and the workflow runs on private runners without public status exposure—badge may not render correctly.21- You are building a status indicator for a tool that does not use GitHub Actions (e.g., GitLab CI, Jenkins, CircleCI)—use platform-specific badge services instead.2223## Inputs2425- GitHub repository with GitHub Actions workflows configured26- GitHub Actions workflow file (YAML) with defined jobs and steps27- Workflow name or filename (e.g., CI_build.yml)28- Repository owner and name2930## Outputs3132- GitHub Workflow Status badge (shield.io SVG image)33- Badge markdown code for embedding in README34- Auto-updating CI status indicator visible in repository documentation3536## How to apply3738Create a GitHub Actions workflow file (e.g., CI_build.yml) that triggers on push and pull request events, define job steps for build/test execution and static analysis integration, then reference the workflow in a GitHub Workflow Status badge URL using the format `https://img.shields.io/github/actions/workflow/status/<owner>/<repo>/<workflow-filename>`. The badge will automatically update to reflect the latest workflow run status (success, failure, or in-progress). Place the badge markdown in your README to display current CI status. The badge acts as a living document that requires no manual updates—GitHub Actions automatically refreshes it based on workflow execution results.3940## Related tools4142- **GitHub Actions** (Orchestrates continuous integration workflow execution; workflow status is the source of truth for badge rendering) — https://github.com/features/actions43- **Sonarcloud** (Executes static code analysis and quality gates within the workflow; results feed into the overall CI status)44- **shields.io** (Generates and hosts the status badge SVG image based on GitHub Actions workflow status queries) — https://shields.io45- **MS2Query** (Example project using GitHub Actions workflow with Sonarcloud integration and CI status badge) — https://github.com/iomega/ms2query4647## Examples4849```50[](https://github.com/iomega/ms2query/actions/workflows/CI_build.yml)51```5253## Evaluation signals5455- Badge markdown renders without 404 or 'workflow not found' errors in the README.56- Badge SVG image updates to reflect the status of the most recent workflow run (green for success, red for failure, yellow for in-progress).57- Clicking the badge URL navigates to the GitHub Actions workflow run history page.58- Workflow file (CI_build.yml) exists in the repository and contains at least one job with a defined trigger event.59- Badge is visible in the rendered README on GitHub; status changes correlate with new workflow executions within 1–2 minutes.6061## Limitations6263- Badge status reflects only the latest workflow run; historical or per-branch status requires additional dashboards or custom query parameters.64- Private repositories may not expose workflow status publicly; badge will fail or show a generic error unless explicitly configured for public visibility.65- Workflow file must be committed to the default branch; badge URLs referencing workflows on feature branches may not resolve correctly.66- Sonarcloud or other quality gate failures are reflected in the badge only if the workflow is configured to fail on those checks; warnings alone will not affect the overall badge status.67- Badge URL is static and must be manually placed in README; no automatic badge generation or discovery is performed.6869## Evidence7071- [other] MS2Query uses a GitHub Actions workflow (CI_build.yml) that triggers on pull requests and integrates with Sonarcloud, producing a GitHub Workflow Status badge that reflects the combined outcome of build, test, and static analysis checks.: "MS2Query uses a GitHub Actions workflow (CI_build.yml) that triggers on pull requests and integrates with Sonarcloud, producing a GitHub Workflow Status badge that reflects the combined outcome of"72- [other] Configure GitHub Actions workflow file to trigger on push and pull request events to the ms2query repository.: "Configure GitHub Actions workflow file to trigger on push and pull request events to the ms2query repository."73- [readme] [](https://github.com/iomega/ms2query/actions/workflows/CI_build.yml): "[](https://github.com/iomega/ms2query/actions/workflows/CI_build.yml)"74- [other] Integrate Sonarcloud static analysis step into the workflow to scan code quality and security metrics.: "Integrate Sonarcloud static analysis step into the workflow to scan code quality and security metrics."75- [other] Retrieve and document the Sonarcloud quality report output showing code coverage, technical debt, and quality gates status.: "Retrieve and document the Sonarcloud quality report output showing code coverage, technical debt, and quality gates status."
HolobiomicsLab 