Kuroco Skills for Claude Code

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

A Claude Code skill package for Kuroco HeadlessCMS development

日本語

概要

このリポジトリは、Kuroco HeadlessCMS を使った開発を支援する 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）

インストール方法

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

skills.sh は AI エージェント向けスキルのオープンマーケットプレイスです。

npx skills add diverta/kuroco-skills

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

Claude Code 内で以下を実行：

/plugin marketplace add diverta/kuroco-skills

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

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

使い方

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

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

例：

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

更新方法

/plugin marketplace update kuroco-skills

または手動で：

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

English

Overview

This repository provides Claude Code skills for Kuroco HeadlessCMS 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)

Installation

Method 1: Install from skills.sh (Recommended)

skills.sh is an open marketplace for AI agent skills.

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)

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

Method 4: Add to project locally

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

Update

/plugin marketplace update kuroco-skills

Or manually:

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
└── 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. These documents are bundled from the official source for convenience and are subject to Kuroco's terms of use.

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

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

kuroco-server-processing