actions-debugger

GitHub Actions のワークフロー実行エラーを調査し、原因を特定して解決策を提案する。「Actions エラー」「ワークフロー失敗」「CI が落ちた」「ビルド失敗」「テスト失敗」「Actions を調べて」「CI のエラーを見て」などで起動。失敗したジョブのログを分析し、具体的な修正方法を提示。

181 stars

Best use case

actions-debugger is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

GitHub Actions のワークフロー実行エラーを調査し、原因を特定して解決策を提案する。「Actions エラー」「ワークフロー失敗」「CI が落ちた」「ビルド失敗」「テスト失敗」「Actions を調べて」「CI のエラーを見て」などで起動。失敗したジョブのログを分析し、具体的な修正方法を提示。

Teams using actions-debugger should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/actions-debugger/SKILL.md --create-dirs "https://raw.githubusercontent.com/majiayu000/claude-skill-registry/main/skills/data/actions-debugger/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/actions-debugger/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How actions-debugger Compares

Feature / Agentactions-debuggerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

GitHub Actions のワークフロー実行エラーを調査し、原因を特定して解決策を提案する。「Actions エラー」「ワークフロー失敗」「CI が落ちた」「ビルド失敗」「テスト失敗」「Actions を調べて」「CI のエラーを見て」などで起動。失敗したジョブのログを分析し、具体的な修正方法を提示。

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Actions Debugger

GitHub Actions のワークフロー実行エラーを調査し、原因を特定して解決策を提案します。

## ワークフロー

### 1. 失敗した Run の特定

```bash
# 最近の失敗した Run を一覧表示
gh run list --status failure --limit 5

# 特定の PR に関連する Run を確認
gh pr checks {pr番号}
```

### 2. エラーログの取得

```bash
# Run の詳細とジョブ一覧を取得
gh run view {run_id} --verbose

# 失敗したステップのログを取得
gh run view {run_id} --log-failed
```

### 3. エラー分析

ログから以下を特定:

- エラーメッセージ
- 失敗したステップ
- 関連するファイル・行番号

### 4. 解決策の提案

エラーパターンに基づいて:

- 具体的な修正コード
- 設定変更の提案
- 参考ドキュメントへのリンク

## よくあるエラーパターン

### テスト失敗

```bash
# テストログの詳細確認
gh run view {run_id} --log-failed | grep -A 10 "FAIL"
```

**対処法**:

- 失敗したテストケースを特定
- ローカルで再現
- テストまたはコードを修正

### ビルドエラー

```bash
# ビルドログの確認
gh run view {run_id} --log-failed | grep -A 5 "error"
```

**対処法**:

- コンパイルエラーを特定
- 型エラーや構文エラーを修正
- 依存関係を確認

### 依存関係エラー

```bash
# npm / yarn エラーの確認
gh run view {run_id} --log-failed | grep -A 5 "npm ERR!"
```

**対処法**:

- `package-lock.json` を更新
- 依存関係のバージョンを確認
- キャッシュをクリア

### 権限エラー

**対処法**:

- workflow の permissions を確認
- GITHUB_TOKEN の権限を確認
- secrets の設定を確認

## 出力形式

### エラーレポート

```
## GitHub Actions エラー調査結果

**Run ID**: {run_id}
**ワークフロー**: {workflow_name}
**ステータス**: ❌ failure

### 失敗したジョブ

| ジョブ | ステップ | 原因 |
|--------|----------|------|
| test | Run tests | テスト失敗 |

### エラー詳細

```
FAIL src/__tests__/user.test.ts
  ● UserService > should return user
    Expected: "John"
    Received: "Jane"
```

### 修正提案

1. `src/__tests__/user.test.ts` の期待値を確認
2. または `UserService` の実装を確認

### 参考コマンド

```bash
# ローカルでテスト実行
npm test -- --testPathPattern=user.test.ts
```
```

## 重要な注意事項

- ✅ エラーログを詳細に分析
- ✅ 具体的な修正提案を含める
- ✅ ローカルでの再現方法を提示
- ❌ 漠然とした提案を避ける
- ❌ 関係ないエラーを混同しない

Related Skills

github-actions

181
from majiayu000/claude-skill-registry

Create and configure GitHub Actions. Use when building custom actions, setting up runners, implementing security practices, or publishing to the marketplace.

actions-pattern

181
from majiayu000/claude-skill-registry

Garante que novas Actions sigam o padrão de classes actions reutilizáveis do Easy Budget.

actions-cicd-practices

181
from majiayu000/claude-skill-registry

GitHub Actions and CI/CD best practices for automated testing, building, and deployment.

acc-check-leaky-abstractions

181
from majiayu000/claude-skill-registry

Detects leaky abstractions in PHP code. Identifies implementation details exposed in interfaces, concrete returns from abstract methods, framework leakage into domain, and infrastructure concerns in application layer.

vly-money

159
from majiayu000/claude-skill-registry

Generate crypto payment links for supported tokens and networks, manage access to X402 payment-protected content, and provide direct access to the vly.money wallet interface.

Fintech & CryptoClaude

lets-go-rss

159
from majiayu000/claude-skill-registry

A lightweight, full-platform RSS subscription manager that aggregates content from YouTube, Vimeo, Behance, Twitter/X, and Chinese platforms like Bilibili, Weibo, and Douyin, featuring deduplication and AI smart classification.

Content & Documentation

ux

159
from majiayu000/claude-skill-registry

This AI agent skill provides comprehensive guidance for creating professional and insightful User Experience (UX) designs, covering user research, information architecture, interaction design, visual guidance, and usability evaluation. It aims to produce actionable, user-centered solutions that avoid generic AI aesthetics.

UX Design & StrategyClaude

thor-skills

159
from majiayu000/claude-skill-registry

An entry point and router for AI agents to manage various THOR-related cybersecurity tasks, including running scans, analyzing logs, troubleshooting, and maintenance.

SecurityClaude

grail-miner

159
from majiayu000/claude-skill-registry

This skill assists in setting up, managing, and optimizing Grail miners on Bittensor Subnet 81, handling tasks like environment configuration, R2 storage, model checkpoint management, and performance tuning.

DevOps & Infrastructure

chrome-debug

159
from majiayu000/claude-skill-registry

This skill empowers AI agents to debug web applications and inspect browser behavior using the Chrome DevTools Protocol (CDP), offering both collaborative (headful) and automated (headless) modes.

Coding & DevelopmentClaude

whisper-transcribe

159
from majiayu000/claude-skill-registry

Transcribes audio and video files to text using OpenAI's Whisper CLI, enhanced with contextual grounding from local markdown files for improved accuracy.

Media Processing

astro

159
from majiayu000/claude-skill-registry

This skill provides essential Astro framework patterns, focusing on server-side rendering (SSR), static site generation (SSG), middleware, and TypeScript best practices. It helps AI agents implement secure authentication, manage API routes, and debug rendering behaviors within Astro projects.

Coding & Development