Kuroco Skills for Claude Code の使い方
Kuroco Skills は、Claude Code 向けのスキルパッケージです。 Kuroco の API 連携、コンテンツ管理、フロントエンド統合、バッチ処理などに関するベストプラクティスを Claude Code に学習させ、Kuroco 開発の生産性を向上させます。
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-mng-api-browser | 管理 API（mng_api）のブラウザ経由操作・管理画面自動化 |
各スキルの詳細は「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
方法 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 に関する質問をした際に、関連するスキルが自動的に呼び出されます。 特別なコマンドや操作は必要ありません。
使用例
以下のように Claude Code に質問すると、関連するスキルが自動的に使用されます。
| 質問例 | 使用されるスキル |
|---|---|
| 「Kuroco の API でログインを実装したい」 | api-content |
| 「Nuxt3 で Kuroco のコンテンツを表示したい」 | frontend-integration |
| 「バッチ処理で Slack 通知を送りたい」 | server-processing |
| 「Smarty のプラグインの使い方を知りたい」 | server-processing |
| 「サイトを自動デプロイしたい」 | frontend-integration |
| 「管理画面からコンテンツを作成したい」 | mng-api-browser |
| 「Kuroco のドキュメントでエンドポイント設定を調べたい」 | kuroco-docs |
スキルが提供する情報
各スキルは以下のような情報を Claude Code に提供します。
- コード例: API 呼び出し、認証処理、コンテンツ操作などの実装例
- 設定手順: 管理画面での設定方法のステップバイステップガイド
- ベストプラクティス: キャッシュ戦略、エラーハンドリング、セキュリティ設定
- トラブルシューティング: よくあるエラーとその対処法
更新方法
Kuroco Skills を最新の状態に保つには、以下のいずれかの方法でアップデートします。
/plugin marketplace update kuroco-skills
または手動で更新します。
cd ~/.claude/skills/kuroco-skills
git pull origin main
リポジトリ構成
kuroco-skills/
├── .claude-plugin/
│ ├── plugin.json # プラグインメタデータ
│ └── marketplace.json # マーケットプレイス登録情報
├── skills/
│ ├── kuroco-docs/ # ドキュメント検索 + 公式ドキュメント（同梱）
│ ├── api-content/ # API パターン + コンテンツ CRUD
│ ├── frontend-integration/ # Nuxt/Next.js 統合 + AI 自動デプロイ
│ ├── server-processing/ # Smarty プラグインリファレンス + バッチ & Webhook
│ └── mng-api-browser/ # 管理 API ブラウザ操作
├── scripts/
│ └── validate.sh # スキルバリデーションスクリプト
└── README.md
関連ドキュメント
サポート
お探しのページは見つかりましたか？解決しない場合は、問い合わせフォームからお問い合わせいただくか、Slackコミュニティにご参加ください。