CI Doctor
Debug and fix failing GitHub Actions in seconds. Stop wasting hours on CI.
- Identify the root cause of failing GitHub Actions or GitLab CI jobs
- Automatically fix YAML syntax errors in workflow configuration files
- Debug dependency and lockfile mismatches that break build environments
Secure checkout via Stripe
Included in download
- Identify the root cause of failing GitHub Actions or GitLab CI jobs
- Automatically fix YAML syntax errors in workflow configuration files
- terminal, file_read, file_write automation included
- Includes example output and usage patterns
See it in action
A real example of what this skill takes in and produces.
Sample output
Root Cause: The 'build' job failed because the 'production' environment requires a 'NPM_TOKEN' secret which is not configured. Evidence: 401 Unauthorized - GET https://registry.npmjs.org/ Fix: Add NPM_TOKEN to your repository secrets. PR Option: I can update the YAML to use the secret now.
Debug and fix failing GitHub Actions in seconds. Stop wasting hours on CI.
Secure checkout via Stripe
Included in download
- Identify the root cause of failing GitHub Actions or GitLab CI jobs
- Automatically fix YAML syntax errors in workflow configuration files
- terminal, file_read, file_write automation included
- Includes example output and usage patterns
- Instant install
See it in action
A real example of what this skill takes in and produces.
Sample output
Root Cause: The 'build' job failed because the 'production' environment requires a 'NPM_TOKEN' secret which is not configured. Evidence: 401 Unauthorized - GET https://registry.npmjs.org/ Fix: Add NPM_TOKEN to your repository secrets. PR Option: I can update the YAML to use the secret now.
About This Skill
Automated CI/CD Troubleshooting
CI Doctor is a specialized diagnostic skill designed to get your pipelines back to green. It eliminates the tedious manual process of digging through thousands of lines of build logs by automatically identifying the root cause of failures across GitHub Actions, GitLab CI, and CircleCI.
How it works
Unlike generic AI prompts, this skill uses a structured diagnostic framework. It leverages the GitHub CLI (gh) and local context to parse logs from the first failing step rather than just the final summary. It classifies failures into specific categories like dependency errors, permission issues, or configuration syntax errors to provide a surgically precise fix.
Features
- Deep Log Analysis: Automatically fetches and parses logs using `gh run view --log-failed`.
- Multi-Provider Support: Detects and debugs GitHub Actions, GitLab CI, and CircleCI environments.
- Root Cause Identification: Distinguishes between cascading errors and the actual source of truth.
- Safe Implementation: Proposes fixes and creates pull requests only after developer confirmation.
- Context Awareness: Inspects package manifests and lockfiles to ensure fixes are compatible with your tech stack.
The Output
You receive a concise report containing a one-sentence root cause, the specific evidence from the logs, a copy-pasteable fix (code or YAML), and an offer to automate the pull request creation.
Use Cases
- Identify the root cause of failing GitHub Actions or GitLab CI jobs
- Automatically fix YAML syntax errors in workflow configuration files
- Debug dependency and lockfile mismatches that break build environments
- Identify and resolve missing secrets or environment variables in pipelines
- Generate and push a PR with a confirmed fix to unblock the main branch
Known Limitations
Requires GitHub CLI (gh) installed and authenticated (gh auth login). Supports GitHub Actions only. Fix PRs require user confirmation before creation. Cannot fix self-hosted runner configuration issues. Does not modify workflow settings in GitHub UI (e.g., branch protection rules).
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/ci-doctor | tar xz -C ~/.claude/skills/Free skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Early access skill
Be the first to review this skill.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
Allowed Hosts
File Scopes
CI Doctor needs terminal access to run the GitHub CLI (`gh`) and git commands. These commands fetch workflow run status, download failure logs, and (with user confirmation) create fix PRs. The skill never runs destructive git operations (force push, reset) and never creates PRs without explicit user approval. File read access allows CI Doctor to examine workflow YAML files (`.github/workflows/*.yml`), dependency manifests (`package.json`, `requirements.txt`, `go.mod`), and error logs to understand the CI environment and identify root causes like missing dependencies, syntax errors, or misconfigured secrets. File write access is used only when the user explicitly confirms "create a fix PR." The skill then creates a new branch, modifies the workflow file, commits the change, and opens a PR. All changes are previewed to the user before any write occurs. The skill never writes to files without user consent. Network access fetches workflow run data from `api.github.com` as a fallback if the GitHub CLI is not installed. These are read-only API calls authenticated via the user's GitHub token (provided by the user or read from local git config). No data is sent to external servers beyond GitHub's API. No browser or environment variable access is required.
Works with Claude Code and Codex. Requires GitHub CLI (gh) installed and authenticated. Supports GitHub Actions only initially; GitLab CI and CircleCI planned.
Creator
Fairy Squadmother sells skills for people with real work, limited patience, and a low tolerance for software pageantry. Her skills help creators, founders, freelancers, and practical humans turn repeatable messes into reusable systems. Promptcrud. Taskspawn. Filefog. Launch splatter. Documentation drift. The weird little admin barnacles that attach themselves to anything worth doing. She builds for the moment when you know the process can be better, but you do not have a spare week to go spelunking through your own workflow with a headlamp and a grudge. Clear instructions. Useful defaults. Less performance. More usable machinery. Onward.
Frequently Asked Questions
Learn More About AI Agent Skills
More Premium Skills
diagnosing-rag-failure-modes
RAG fails quietly. It retrieves documents, returns confident-looking answers, and misses the question entirely — because the question required connecting facts across documents, reasoning about sequence, or tracing causation. This skill gives you a five-question diagnostic checklist that classifies any failing query as either RAG-safe or structurally RAG-incompatible, then maps it to the specific failure pattern and the architectural fix that resolves it.
subagent-orchestrator (Develop based on the Claude Code sourcemap)
Turn your AI agent into a coordinator that manages parallel subagents for complex coding and research tasks.
designing-hybrid-context-layers
Architects the right retrieval strategy for every query — teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.
consumer-motivation-analyzer
Go beyond surface-level feedback to uncover the psychological drivers and hidden motivations behind buyer behavior.