Kuroco Skills for Claude Code の使い方
Kuroco Skills は、Claude Code 向けのスキルパッケージです。 Kuroco の API 連携、コンテンツ管理、フロントエンド統合、バッチ処理などに関するベストプラクティスを Claude Code に学習させ、Kuroco 開発の生産性を向上させます。
Kuroco AI アーキテクチャ
Kuroco は AI 連携のために以下のインターフェースを提供しています。
| コンポーネント | 種類 | 説明 |
|---|---|---|
| 管理画面 | Web UI | 管理者向けの Kuroco 管理画面 |
| Admin API | REST API | API 経由の管理操作（/direct/rcms_api/admin_api/） |
| Admin CLI | CLI ツール | Admin API のラッパー CLI（kuroco-admin） |
| Client API | REST API | フロントエンドアプリ向けの公開 API（/rcms-api/{id}/） |
| Client API | MCP サーバ | Client API の MCP サーバ (/rcms-api/{id}/mcp) |
| Client CLI | CLI ツール | Client API のラッパー CLI（kuroco-client） |
Kuroco Skills は kuroco-admin-api スキルを通じて、Admin CLI を内部的に利用し Claude Code から Admin API を操作できるようにします。
Client CLI は、独立して使用可能なスタンドアロンのコマンドラインツールです。
Kuroco Skills とは
Kuroco Skills をインストールすると、Claude Code が Kuroco に関する質問に対して、正確で具体的なコード例やベストプラクティスを提示できるようになります。 以下の 5 つのスキルが含まれています。
| スキル | 説明 |
|---|---|
| kuroco-docs | Kuroco 公式ドキュメントの検索・参照 |
| kuroco-api-content | API 設計・認証（Cookie/Token/StaticToken）、CORS、コンテンツ CRUD、フィルタークエリ |
| kuroco-frontend-integration | Nuxt.js / Next.js 統合、SSG/SSR、認証実装、AI 自動デプロイ |
| kuroco-server-processing | Smarty プラグイン・構文リファレンス（206 プラグイン）、バッチ処理、Webhook、トリガー |
| kuroco-admin-api | 管理 API（admin_api）の CLI 経由操作（kuroco-admin CLI） |
各スキルの詳細は「Kuroco Skills リファレンス」を参照してください。
事前準備: Claude Code のインストール
Kuroco Skills を使用するには Claude Code が必要です。
Claude Code はデスクトップ版（CLI）でのみ動作確認を行っています。Web 版（claude.ai）での動作は未検証です。
macOS の場合
ネイティブインストーラー（推奨）または Homebrew でインストールします。
# ネイティブインストーラー（推奨、自動更新あり）
curl -fsSL https://claude.ai/install.sh | bash
# または Homebrew
brew install --cask claude-code
インストール後、ターミナルで claude を実行すると Claude Code が起動します。
Windows の場合
ネイティブインストーラー（推奨）、WinGet、または WSL でインストールします。
# PowerShell（推奨、自動更新あり）
irm https://claude.ai/install.ps1 | iex
# または WinGet
winget install Anthropic.ClaudeCode
インストール後、ターミナル（PowerShell またはコマンドプロンプト）で claude を実行すると Claude Code が起動します。
Windows ではネイティブ（Git Bash が必要）と WSL の両方に対応しています。WSL 2 の使用が推奨されています。詳細は Claude Code 公式ドキュメントを参照してください。
その他のインストール方法については Claude Code セットアップガイドを参照してください。
インストール方法
方法 1: skills.sh からインストール（推奨）
skills.sh は AI エージェント向けスキルのオープンマーケットプレイスです。
npx skills add diverta/kuroco-skills
skills.sh でインストールすると、Kuroco Skills と一緒に find-skills メタスキルも自動的にインストールされます。
find-skills があることで、Claude Code が適切なスキルを選択して呼び出せるようになり、Kurocoに関する質問に対して、kuroco-skills を適切に使用します。
方法 2: Claude Code コマンドで追加
Claude Code 内で以下のコマンドを実行します。
/plugin marketplace add diverta/kuroco-skills
方法 3: 手動でクローン（グローバル）
すべてのプロジェクトで Kuroco Skills を利用する場合は、グローバルにインストールします。
mkdir -p ~/.claude/skills
git clone https://github.com/diverta/kuroco-skills.git ~/.claude/skills/kuroco-skills
方法 4: プロジェクトローカルに追加
特定のプロジェクトでのみ利用する場合は、プロジェクトディレクトリに追加します。
mkdir -p .claude/skills
git clone https://github.com/diverta/kuroco-skills.git .claude/skills/kuroco-skills
同梱ドキュメント
Kuroco Skills には、Kuroco 公式ドキュメントがプラグインに同梱されています。 インストール後すぐに Claude Code がドキュメントを横断検索して、正確な回答を提供できます。
ドキュメントを最新の状態に保つには、プラグイン自体を更新してください（更新方法を参照）。
基本的な使い方
Kuroco Skills をインストールすると、Claude Code で Kuroco に関する質問をした際に、関連するスキルが自動的に呼び出されます。 特別なコマンドや操作は必要ありません。
Kurocoに関する質問をする
以下のように Claude Code に質問すると、関連するスキルが自動的に使用されます。
| 質問例 | 使用されるスキル |
|---|---|
| 「Kuroco の API でログインを実装したい」 | api-content |
| 「Nuxt3 で Kuroco のコンテンツを表示したい」 | frontend-integration |
| 「バッチ処理で Slack 通知を送りたい」 | server-processing |
| 「Smarty のプラグインの使い方を知りたい」 | server-processing |
| 「サイトを自動デプロイしたい」 | frontend-integration |
| 「管理画面からコンテンツを作成したい」 | admin-api |
| 「Kuroco のドキュメントでエンドポイント設定を調べたい」 | kuroco-docs |
Claude に Kuroco の管理 API を操作させる
kuroco-admin-api スキルを使うと、Claude Code から kuroco-admin CLI 経由で Kuroco の管理 API（admin_api）を操作できます。
kuroco-admin login で保存されたセッション Cookie を利用するため、別途 API キーを設定する必要はありません。
admin_api へのリクエストは /direct/rcms_api/admin_api/ エンドポイントを通じて実行されます。
/direct/ 配下へのリクエストは Kuroco の 課金対象となります。
AI エージェントが自律的に操作を繰り返す場合、意図せず多数のリクエストが発生する可能性があるため、ご注意ください。
セットアップ手順
ステップ 1: Bun ランタイムをインストールする
CLI のビルドに必要な Bun をインストールします。
curl -fsSL https://bun.sh/install | bash
ステップ 2: kuroco-admin CLI をビルド・インストールする
cd /path/to/admin_cli
bun build --compile kuroco-admin.ts --outfile kuroco-admin
cp kuroco-admin /usr/local/bin/
ステップ 3: Kuroco 管理画面にログインする
kuroco-admin login --url https://example.g.kuroco-mng.app
メールアドレスとパスワードの入力を求められます。セッション Cookie は ~/.kuroco-admin/cookies.txt に保存されます。
使い方
Claude Code に自然言語で指示するだけで、管理 API の操作を自動化できます。
「ブログの記事を3件作成して」
「コンテンツ定義の一覧を確認したい」
「会員情報を API で取得してリストアップして」
「管理 API でカテゴリを追加して」
仕組み
Claude は内部で以下の kuroco-admin CLI コマンドを使い分けて操作を実行します。
| コマンド | 役割 |
|---|---|
kuroco-admin whoami | セッション情報の確認（member_id、名前、権限） |
kuroco-admin discover | 利用可能なモジュール・コントローラの探索 |
kuroco-admin advise | AI 支援：やりたいことを伝えると API 手順を回答 |
kuroco-admin help | コントローラのリクエスト・レスポンススキーマ取得 |
kuroco-admin exec | API 実行（GET/POST）、--columns でレスポンス絞り込み可能 |
変更操作（作成・更新・削除）を実行する前に、Claude は必ずユーザーに確認を求めます。 意図しない操作が実行されることはありませんが、指示は具体的に記述することを推奨します。
更新方法
Kuroco Skills を最新の状態に保つには、以下のいずれかの方法でアップデートします。
/plugin marketplace update kuroco-skills
または手動で更新します。
cd ~/.claude/skills/kuroco-skills
git pull origin main
リポジトリ構成
kuroco-skills/
├── .claude-plugin/
│ └── plugin.json # プラグインメタデータ
├── skills/
│ ├── kuroco-docs/ # ドキュメント検索 + 公式ドキュメント（同梱）
│ ├── api-content/ # API パターン + コンテンツ CRUD
│ ├── frontend-integration/ # Nuxt/Next.js 統合 + AI 自動デプロイ
│ ├── server-processing/ # Smarty プラグインリファレンス + バッチ & Webhook
│ └── admin-api/ # 管理 API CLI 操作
└── README.md
関連ドキュメント
サポート
お探しのページは見つかりましたか？解決しない場合は、問い合わせフォームからお問い合わせいただくか、Slackコミュニティにご参加ください。