skills.rest
openai
openaiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

circleci-cli

Inspect, validate, rerun, and trigger CircleCI pipelines using the CircleCI CLI.

5.3k|765|Updated Mar 4, 2026
Search Tags:#CLI#pipeline#Troubleshooting#config validation#circleci#ci/CD#devOps
One-click install
npx skills add https://github.com/openai/plugins --skill circleci-cli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: circleci-cli
Source: https://github.com/openai/plugins/tree/main/plugins/circleci/skills/cli
Command: npx skills add https://github.com/openai/plugins --skill circleci-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnosing and operating CircleCI pipelines often requires switching between the web UI and manual API calls. This Skill drives the CircleCI CLI directly to authenticate, inspect pipeline and job status, validate configuration locally, and rerun or trigger pipelines with controlled scope.

Core Features & Use Cases

  • Read-First Diagnostics: Verify CLI installation and auth state, then inspect pipeline, project, and trigger state to capture concrete identifiers and failing steps before any mutation.
  • Local Config Validation: Run CircleCI config validation and processing commands before committing risky configuration edits.
  • Targeted Mutations: Rerun only the required workflow or job scope and trigger pipelines with explicit parameters and branch context.
  • Use Case: A failing deployment pipeline needs investigation. Use this Skill to confirm CLI auth, list recent pipelines, identify the first failing job, validate the config change locally, and rerun only the failed workflow.

Quick Start

Use the CircleCI CLI to check why my latest pipeline failed and rerun only the failed job.

Frequently Asked Questions about circleci-cli

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

FAQPage Schema
How do I rerun a failed CircleCI job from the CLI?▼

First inspect pipeline and workflow state with read-only commands to capture the failing job identifier, then rerun only that workflow or job scope. Confirm organization and project scope before issuing any mutating rerun command.

How to validate a CircleCI config file locally?▼

Run the CircleCI CLI config validation or processing commands against your local configuration before committing changes. This catches syntax and schema errors without pushing risky edits to the remote project.

Does the CircleCI CLI support triggering pipelines with parameters?▼

Yes, newer CLI builds expose pipeline and trigger subcommands that accept explicit parameters and branch context. Run circleci help first to confirm which subcommands your installed version supports.

Why does my CircleCI CLI command fail with permission errors?▼

Permission failures usually mean the token lacks the required organization or project scope. Verify auth state first, then report the exact scope gap and obtain a token with the needed permissions before retrying.

Can I fetch CircleCI job logs from the CLI?▼

Some CLI builds do not expose a logs command. In that case, use the CircleCI web app or connected CircleCI MCP tooling to view cloud job logs, and check circleci help for available commands.

Related Skills

Explore More Software Engineering Skills→
moltis-orgmoltis-org
2.8k

github-repo-management

Automate GitHub repository operations via gh CLI or REST API.

Official
Advanced
rbutinarrbutinar

fabric-pipeline-poll

Monitors Fabric Data Pipeline runs until they reach a terminal state, handling timeouts and surfacing failure details.

Community
Intermediate
drndrn
23

ci-investigate

Analyze flaky CI failures across CircleCI and GitHub Actions runs.

Community
Advanced
Nir-BhayNir-Bhay
19

cicd-pipeline-generator

Generate CI/CD pipeline configurations for GitHub Actions, GitLab CI, and CircleCI.

Community
Advanced