Description

Troubleshoot GitHub Actions workflows, particularly for Go projects. Diagnose failing workflows, distinguish between code and environment issues, interpret logs, and apply fixes for common CI/CD problems.

README (SKILL.md)

GitHub Actions Troubleshooting Skill

Name: GitHub Actions Troubleshooting
Author: irook661

Use the gh CLI and Git to diagnose and fix GitHub Actions workflow failures, particularly for Go projects. This skill helps identify whether failures are due to code issues or environment/configuration problems.

Workflow Analysis

Check the status of recent workflow runs:

gh run list --repo owner/repo --limit 10

View details of a specific failing workflow:

gh run view \x3Crun-id> --repo owner/repo

Get logs for failed jobs only:

gh run view \x3Crun-id> --repo owner/repo --log-failed

Distinguishing Issue Types

Code Issues: Failures in compilation, tests, or linting that occur consistently across environments
Environment Issues: Problems with dependency resolution, tool installation, or type-checking in CI that work locally

Common Go CI Fixes

Linter Configuration Issues

Look for "undefined" reference errors that indicate import resolution problems
Try minimal linter configs that disable type-checking linters
Use golangci-lint run --disable-all --enable=gofmt for basic syntax checking

Dependency Resolution

Verify go.mod and go.sum are consistent
Run go mod tidy to resolve dependency conflicts
Check that required dependencies are properly declared

Diagnostic Commands

Check specific workflow job logs:

gh run view --job \x3Cjob-id> --repo owner/repo

Download workflow artifacts for inspection:

gh run download \x3Crun-id> --repo owner/repo

Troubleshooting Workflow

Identify which jobs are failing and which are passing
Examine error messages for clues about the nature of the issue
Determine if the issue is reproducible locally
Apply targeted fixes based on issue type
Monitor subsequent workflow runs to verify resolution

Usage Guidance

This skill appears coherent and limited to GitHub Actions troubleshooting. Before installing, note that: (1) gh will need GitHub authentication (gh auth) to access private repositories — the skill does not request tokens but will use whatever gh session is present; (2) the troubleshooting commands can download artifacts and run local Go tools (golangci-lint, go mod tidy), which may modify your workspace — run them on a safe branch or in a disposable environment if you are cautious; (3) installing gh via apt/homebrew may require platform privileges. If you plan to allow autonomous agent invocation, be comfortable with the agent running gh/git commands against repos the agent can access; otherwise run the skill manually.

Capability Analysis

Type: OpenClaw Skill Name: github-actions-troubleshooting Version: 1.0.0 The skill bundle is benign. It provides instructions and commands for troubleshooting GitHub Actions workflows using the standard `gh` CLI and Git. The installation steps use legitimate package managers (`brew`, `apt`) to install the `gh` CLI. All commands listed in `SKILL.md` are standard diagnostic or informational commands related to GitHub Actions, such as `gh run list`, `gh run view`, and `gh run download`. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts designed to subvert the agent's behavior or access unrelated sensitive data. The skill's actions are clearly aligned with its stated purpose.

Capability Assessment

✓ Purpose & Capability

Name and description match the declared requirements (gh and git). The SKILL.md uses gh and git commands and Go toolchain commands appropriate to diagnosing CI failures; there are no unrelated binaries or env vars requested.

✓ Instruction Scope

Runtime instructions are narrowly scoped to listing runs, viewing logs, downloading artifacts, and running Go tooling (golangci-lint, go mod tidy). The doc does not instruct reading unrelated system files or secret env vars. It does instruct operations that require repository access (via gh) and running local Go commands, which is expected for this purpose.

✓ Install Mechanism

Install spec uses standard package managers (brew and apt) to install the GitHub CLI (gh). No arbitrary download URLs, archives, or extract steps are present.

✓ Credentials

No environment variables or credentials are declared. The gh CLI used by the skill will require the user's normal GitHub authentication (gh auth) to access private repos, but that is proportional and typical for a GitHub troubleshooting tool.

✓ Persistence & Privilege

The skill does not request permanent presence (always: false) or elevated platform privileges. It is instruction-only and does not modify other skills or system-wide agent settings.

Version History

v1.0.0

Initial release of the github-actions-troubleshooting skill: - Provides commands and step-by-step guidance to troubleshoot GitHub Actions workflows, with a focus on Go projects. - Helps distinguish between code-related and environment/configuration issues. - Includes diagnostic commands for listing workflow runs, viewing logs, and downloading artifacts using the GitHub CLI. - Offers common fixes for Go CI problems, such as linter configuration and dependency resolution. - Details a structured workflow for analyzing and resolving CI/CD failures.

Metadata

Slug github-actions-troubleshooting

Version 1.0.0

License —

All-time Installs 2

Active Installs 2

Total Versions 1

Frequently Asked Questions

What is GitHub Actions Troubleshooting?

Troubleshoot GitHub Actions workflows, particularly for Go projects. Diagnose failing workflows, distinguish between code and environment issues, interpret logs, and apply fixes for common CI/CD problems. It is an AI Agent Skill for Claude Code / OpenClaw, with 1825 downloads so far.

How do I install GitHub Actions Troubleshooting?

Run "/install github-actions-troubleshooting" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GitHub Actions Troubleshooting free?

Yes, GitHub Actions Troubleshooting is completely free (open-source). You can download, install and use it at no cost.

Which platforms does GitHub Actions Troubleshooting support?

GitHub Actions Troubleshooting is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GitHub Actions Troubleshooting?

It is built and maintained by irook661 (@irook661); the current version is v1.0.0.

More Skills

GitHub Actions Troubleshooting