---
slug: "kuroco-skills"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/diverta/kuroco-skills@main/README.md"
repo: "https://github.com/diverta/kuroco-skills"
source_file: "README.md"
branch: "main"
---
# Kuroco Skills for Claude Code

Kuroco HeadlessCMS の開発を支援する Claude Code 用スキルパッケージ

A Claude Code skill package for Kuroco HeadlessCMS development

---

## 日本語

### 概要

このリポジトリは、[Kuroco HeadlessCMS](https://kuroco.app/) を使った開発を支援する Claude Code 用のスキル集です。API連携、コンテンツ管理、フロントエンド統合、バッチ処理などのベストプラクティスを提供します。

### 含まれるスキル

| スキル | 説明 |
|--------|------|
| **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-admin-mcp** | Admin MCP（管理MCPサーバー、AIエージェントからの管理操作の推奨手段）の接続設定、OAuth/CIMD認証、スコープ、ツール利用 |
| **kuroco-content-structure-creation** | MCPツールによるコンテンツ定義（TopicsGroup）の作成、フィールドタイプリファレンス |

### インストール方法

#### 方法1: skills.sh からインストール（推奨）

[skills.sh](https://skills.sh/) は AI エージェント向けスキルのオープンマーケットプレイスです。

```bash
npx skills add diverta/kuroco-skills
```

#### 方法2: Claude Code コマンドで追加

Claude Code 内で以下を実行：

```
/plugin marketplace add diverta/kuroco-skills
```

#### 方法3: 手動でクローン（グローバル）

```bash
mkdir -p ~/.claude/skills
git clone https://github.com/diverta/kuroco-skills.git ~/.claude/skills/kuroco-skills
```

#### 方法4: プロジェクトローカルに追加

```bash
mkdir -p .claude/skills
git clone https://github.com/diverta/kuroco-skills.git .claude/skills/kuroco-skills
```

### 使い方

ドキュメントはプラグインに同梱されているため、インストール後すぐに使用できます。最新のドキュメントを取得するには、適宜プラグインを更新してください。

Claude Code でKurocoに関する質問をすると、関連するスキルが自動的に呼び出されます。

**例：**
- 「KurocoのAPIでログインを実装したい」→ api-content スキル
- 「Nuxt3でKurocoのコンテンツを表示したい」→ frontend-integration スキル
- 「バッチ処理でSlack通知を送りたい」→ server-processing スキル
- 「Smartyのプラグインの使い方を知りたい」→ server-processing スキル
- 「サイトを自動デプロイしたい」→ frontend-integration スキル
- 「管理画面からコンテンツを作成したい」→ admin-api スキル
- 「Claude Desktop からKurocoを操作したい」「Admin MCPに接続したい」→ admin-mcp スキル

### 更新方法

```
/plugin marketplace update kuroco-skills
```

または手動で：

```bash
cd ~/.claude/skills/kuroco-skills
git pull origin main
```

---

## English

### Overview

This repository provides Claude Code skills for [Kuroco HeadlessCMS](https://kuroco.app/) development. It includes best practices for API integration, content management, frontend integration, and batch processing.

### Included Skills

| Skill | Description |
|-------|-------------|
| **kuroco-docs** | Search and reference Kuroco official documentation |
| **kuroco-api-content** | API design, authentication (Cookie/Token/StaticToken), CORS, content CRUD, filter queries |
| **kuroco-frontend-integration** | Nuxt.js/Next.js integration, SSG/SSR, authentication, AI automated deployment |
| **kuroco-server-processing** | Smarty plugin & syntax reference (206 plugins), batch processing, webhooks, triggers |
| **kuroco-admin-api** | Management API (admin_api) CLI operations (kuroco-admin CLI) |
| **kuroco-admin-mcp** | Admin MCP server (recommended way for AI agents to perform admin operations): connection setup, OAuth/CIMD authentication, scopes, tool usage |
| **kuroco-content-structure-creation** | Content Structure (TopicsGroup) creation via MCP tool, field type reference |

### Installation

#### Method 1: Install from skills.sh (Recommended)

[skills.sh](https://skills.sh/) is an open marketplace for AI agent skills.

```bash
npx skills add diverta/kuroco-skills
```

#### Method 2: Add via Claude Code command

Run in Claude Code:

```
/plugin marketplace add diverta/kuroco-skills
```

#### Method 3: Manual clone (Global)

```bash
mkdir -p ~/.claude/skills
git clone https://github.com/diverta/kuroco-skills.git ~/.claude/skills/kuroco-skills
```

#### Method 4: Add to project locally

```bash
mkdir -p .claude/skills
git clone https://github.com/diverta/kuroco-skills.git .claude/skills/kuroco-skills
```

### Usage

Documentation is bundled with the plugin, so it's ready to use immediately after installation. To get the latest documentation, update the plugin periodically.

When you ask Claude Code questions about Kuroco, the relevant skills will be automatically invoked.

**Examples:**
- "I want to implement login with Kuroco API" → api-content skill
- "I want to display Kuroco content with Nuxt3" → frontend-integration skill
- "I want to send Slack notifications from batch processing" → server-processing skill
- "I want to know how to use Smarty plugins" → server-processing skill
- "I want to auto-deploy a site" → frontend-integration skill
- "I want to create content from the admin panel" → admin-api skill
- "I want to operate Kuroco from Claude Desktop" / "I want to connect to Admin MCP" → admin-mcp skill

### Update

```
/plugin marketplace update kuroco-skills
```

Or manually:

```bash
cd ~/.claude/skills/kuroco-skills
git pull origin main
```

---

## Repository Structure

```
kuroco-skills/
├── .claude-plugin/
│   └── plugin.json              # Plugin metadata
├── skills/
│   ├── kuroco-docs/             # Documentation search + official docs (bundled)
│   ├── api-content/             # API patterns + Content CRUD
│   ├── frontend-integration/    # Nuxt/Next.js integration + AI deployment
│   ├── server-processing/       # Smarty plugin reference + Batch & webhook
│   ├── admin-api/               # Management API CLI operations
│   ├── admin-mcp/               # Admin MCP connection, OAuth/CIMD, scopes
│   └── content-structure-creation/  # Content Structure creation via MCP
└── README.md
```

## License / ライセンス

### Code / コード
MIT License

This applies to all files in this repository **except** the `skills/kuroco-docs/docs/` directory.

このリポジトリ内のファイル（`skills/kuroco-docs/docs/` ディレクトリを**除く**）に適用されます。

### Documentation / ドキュメント
The contents of the `skills/kuroco-docs/docs/` directory are official Kuroco documentation, copyrighted by [Diverta Inc.](https://www.diverta.co.jp/) These documents are bundled from the official source for convenience and are subject to Kuroco's terms of use.

`skills/kuroco-docs/docs/` ディレクトリの内容は[株式会社ディバータ](https://www.diverta.co.jp/)が著作権を有するKuroco公式ドキュメントです。利便性のためプラグインに同梱されており、Kurocoの利用規約に従います。

- Redistribution or modification of `skills/kuroco-docs/docs/` content requires permission from Diverta Inc.
- `skills/kuroco-docs/docs/` 内のコンテンツの再配布・改変には株式会社ディバータの許可が必要です。

## Links

- [Kuroco Official Site](https://kuroco.app/)
- [Kuroco Documentation](https://kuroco.app/ja/docs/)
- [Diverta Inc.](https://www.diverta.co.jp/)