How to use Kuroco Skills for Claude Code
Kuroco Skills is a skill package for Claude Code. It teaches Claude Code best practices for Kuroco API integration, content management, frontend integration, and batch processing, improving productivity in Kuroco development.
Kuroco AI Architecture
Kuroco provides the following interfaces for AI integration:
| Component | Type | Description |
|---|---|---|
| Admin Panel | Web UI | Kuroco management screen for administrators |
| Admin API | REST API | Management operations via API (/direct/rcms_api/admin_api/) |
| Admin CLI | CLI Tool | CLI wrapper for Admin API (kuroco-admin) |
| Client API | REST API | Public-facing API for frontend apps (/rcms-api/{id}/) |
| Client API | MCP Server | MCP Server for Client API (/rcms-api/{id}/mcp) |
| Client CLI | CLI Tool | CLI wrapper for Client API (kuroco-client) |
Kuroco Skills enables Claude Code to leverage Admin API via the kuroco-admin-api skill, which uses the Admin CLI internally.
Client CLI is a standalone command-line tool that can be used independently.
What is Kuroco Skills
Once installed, Claude Code can provide accurate, concrete code examples and best practices when answering questions about Kuroco. The package includes the following 5 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) |
For details on each skill, see the Kuroco Skills Reference.
Prerequisites: Install Claude Code
Kuroco Skills requires Claude Code to be installed.
Claude Code has been tested with the desktop (CLI) version only. Operation on the web version (claude.ai) has not been verified.
macOS
Use the native installer (recommended) or Homebrew:
# Native installer (recommended, auto-updates)
curl -fsSL https://claude.ai/install.sh | bash
# Or via Homebrew
brew install --cask claude-code
After installation, run claude in your terminal to start Claude Code.
Windows
Use the native installer (recommended), WinGet, or WSL:
# PowerShell (recommended, auto-updates)
irm https://claude.ai/install.ps1 | iex
# Or via WinGet
winget install Anthropic.ClaudeCode
After installation, run claude in your terminal (PowerShell or Command Prompt) to start Claude Code.
On Windows, both native (requires Git Bash) and WSL are supported. WSL 2 is recommended for the best experience. For details, see the Claude Code official documentation.
For more installation options, see the Claude Code setup guide.
Installation
Method 1: Install from skills.sh (Recommended)
skills.sh is an open marketplace for AI agent skills.
npx skills add diverta/kuroco-skills
When installed using skills.sh, the find-skills meta-skill is automatically installed along with Kuroco Skills.
By having find-skills available, Claude Code can select and invoke the appropriate skills, and it will properly use kuroco-skills in response to questions about Kuroco.
Method 2: Add via Claude Code command
Run the following command in Claude Code:
/plugin marketplace add diverta/kuroco-skills
Method 3: Manual clone (Global)
To use Kuroco Skills across all projects, install globally:
mkdir -p ~/.claude/skills
git clone https://github.com/diverta/kuroco-skills.git ~/.claude/skills/kuroco-skills
Method 4: Add to project locally
To use only in a specific project, add to the project directory:
mkdir -p .claude/skills
git clone https://github.com/diverta/kuroco-skills.git .claude/skills/kuroco-skills
Bundled documentation
Kuroco Skills comes with official Kuroco documentation bundled in the plugin. After installation, Claude Code can immediately search across the documentation for accurate answers.
To keep the documentation up to date, update the plugin itself (see Updating).
Basic usage
Once Kuroco Skills is installed, relevant skills are automatically invoked when you ask Claude Code questions about Kuroco. No special commands or operations are required.
Ask a question about Kuroco.
Ask Claude Code questions like these, and the relevant skill will be used automatically:
| Question | Skill used |
|---|---|
| "I want to implement login with Kuroco API" | api-content |
| "I want to display Kuroco content with Nuxt3" | frontend-integration |
| "I want to send Slack notifications from batch processing" | server-processing |
| "I want to know how to use Smarty plugins" | server-processing |
| "I want to auto-deploy a site" | frontend-integration |
| "I want to create content from the admin panel" | admin-api |
| "I want to search endpoint settings in Kuroco docs" | kuroco-docs |
Letting Claude Operate Kuroco via Admin API
By using the kuroco-admin-api skill, Claude Code can operate Kuroco’s Management API (admin_api) via the kuroco-admin CLI.
Authentication uses session cookies saved by kuroco-admin login, so no additional API key configuration is needed.
admin_api requests are executed through the /direct/rcms_api/admin_api/ endpoint.
Requests under /direct/ are billable in Kuroco.
Be aware that when an AI agent operates autonomously and repeatedly, a large number of requests may be generated unintentionally.
Setup Steps
Step 1: Install Bun runtime
Install Bun, which is required to build the CLI:
curl -fsSL https://bun.sh/install | bash
Step 2: Build and install kuroco-admin CLI
cd /path/to/admin_cli
bun build --compile kuroco-admin.ts --outfile kuroco-admin
cp kuroco-admin /usr/local/bin/
Step 3: Log in to the Kuroco admin panel
kuroco-admin login --url https://example.g.kuroco-mng.app
You will be prompted for your email and password. Session cookies are saved to ~/.kuroco-admin/cookies.txt.
Usage
Simply give instructions to Claude Code in natural language to automate admin API operations.
"Create three blog posts."
"I want to check the list of content definitions."
"Retrieve member information via the API and list it."
"Add a category via the management API."
How It Works
Claude internally uses the following kuroco-admin CLI commands to perform operations:
| Command | Role |
|---|---|
kuroco-admin whoami | Check session information (member_id, name, permissions) |
kuroco-admin discover | Explore available modules and controllers |
kuroco-admin advise | AI-powered: describe what you want, get API steps |
kuroco-admin help | Get request/response schemas for a controller |
kuroco-admin exec | Execute API (GET/POST) with optional --columns filtering |
Before executing any modification operations (create, update, delete), Claude will always ask the user for confirmation.
Unintended actions will not be executed, but it is recommended to provide clear and specific instructions.
Updating
To keep Kuroco Skills up to date, use one of the following methods:
/plugin marketplace update kuroco-skills
Or update 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
Related documentation
- Kuroco Skills Reference - Detailed description of each skill
- Kuroco Skills GitHub Repository
- Claude Code Official Documentation
Support
If you have any other questions, please contact us or check out Our Slack Community.