# AI コーディングエージェントで始める

> Claude Code、Codex、Cursor などの AI コーディングエージェントに、GitHub Actions のジョブを Skipbox へ移してもらう手順。スキルを入れて頼み、プルリクエストを確かめます。

GitHub Actions のジョブを Skipbox に移す作業は、AI コーディングエージェントに任せられます。あなたがするのは GitHub アプリのインストールです。エージェントは移すとよいジョブを探し、`runs-on` を書き換え、ジョブに要るセットアップのステップを足して、プルリクエストを開きます。

## スキルを入れる

スキルは、GitHub の [skipbox-dev/skills](https://github.com/skipbox-dev/skills) にある Markdown のファイル一つです。どのジョブを移すか、ラベルとサイズ、ランナーのイメージに入っているもの、失敗したり待機中のままになったりするジョブの直し方が書いてあります。入れ方は三つあります。

skills.sh で入れる（Claude Code、Codex、Cursor など）：

```bash
npx skills add skipbox-dev/skills
```

Claude Code のプラグインとして入れる。まずマーケットプレイスを追加します。

```text
/plugin marketplace add skipbox-dev/skills
```

次にプラグインをインストールします。

```text
/plugin install skipbox@skipbox-skills
```

手で入れる：[`SKILL.md`](https://github.com/skipbox-dev/skills/blob/main/skills/skipbox-github-runners/SKILL.md) を、エージェントのスキルかルールのフォルダーにコピーします。Claude Code では次の場所です。

```text
.claude/skills/skipbox-github-runners/SKILL.md
```

## エージェントに頼む

エージェントでリポジトリを開き、ふだんの言葉で頼みます。

```text
Linux の CI のジョブを Skipbox に移して、プルリクエストを開いて
GitHub Actions で費用がかかっているワークフローはどれ？ Skipbox に移すとよいのはどれ？
このジョブが Skipbox で「command not found」で失敗する。直して
Skipbox に移したジョブが待機中のまま動かない。理由を調べて
```

エージェントはまずジョブ一つから移すので、最初の実行で足りないツールがわかります。macOS、Windows、Arm のジョブは GitHub のランナーに残します。

## エージェントにできないこと

- **ログインと Skipbox のアプリのインストール:** リポジトリを持つアカウントで、[クイックスタート](https://docs.skipbox.dev/ja/quickstart)の手順 1 と 2 をしてください。組織と個人アカウントで入れるアプリが違います（[組織と個人アカウント](https://docs.skipbox.dev/ja/accounts)）。
- **プランを選ぶこと:** 無料トライアルにカードは要りません。最初のジョブから始まり、7日間か 3,000分の早いほうまで使えます。そのあとのプランは、あなたが選びます（[プラン](https://docs.skipbox.dev/ja/plans)）。

この方法では Skipbox はワークフローを変えません。変更はエージェントが開くプルリクエストだけで、マージするのはあなたです。そのプルリクエストを Skipbox に開かせるときは、アカウントのページでリポジトリの横の「プルリクエストを開く」を押します（[GitHub アプリの権限](https://docs.skipbox.dev/ja/permissions)）。

## スキルを入れない場合

このドキュメントのどのページも、アドレスの末尾に `.md` を付けると Markdown で読めます。全ページの一覧は `https://docs.skipbox.dev/llms.txt` にあります。スキルのないエージェントも、ドキュメントをそのまま読めます。まずは次のページから。

- 手順：[クイックスタート](https://docs.skipbox.dev/ja/quickstart)
- どのラベルを書くか：[ラベルとサイズ](https://docs.skipbox.dev/ja/labels)
- VM に入っているもの：[ランナーのイメージ](https://docs.skipbox.dev/ja/runner-image)
- GitHub のランナーで通っていたジョブが失敗する：[移したジョブが失敗するとき](https://docs.skipbox.dev/ja/migration)

トライアル中のラベルは `skipbox` です。わからないことは hello@skipbox.dev までご連絡ください。

2026-11-12 更新 · https://docs.skipbox.dev/ja/ai-agents