How to use Kuroco Skills

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 MCP	MCP Server	MCP Server for Admin API (/direct/rcms_api/admin_mcp/), Bearer token authentication
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)

For admin operations from an AI agent, use Admin MCP. It can be registered directly with MCP-aware clients (Claude Code, Claude Desktop, etc.) and supports scoped and read-only access control via OAuth.

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 9 skills:

Skill	Description
kuroco-docs	Search and reference Kuroco official documentation
kuroco-app-builder	Workflow for building an app or site from scratch (mock-first → content structures → API → live data → deployment)
kuroco-api-content	API design, authentication (Cookie / dynamic and static access tokens), CORS, content CRUD, filter queries
kuroco-frontend-integration	Vite / Nuxt.js / Next.js integration, SPA/SSG/SSR, authentication, deployment to KurocoFront
kuroco-server-processing	Smarty plugin & syntax reference (206 plugins), batch processing, webhooks, triggers
kuroco-admin-mcp	Admin MCP (management MCP server) connection setup, OAuth / CIMD authentication, scopes, tool usage
kuroco-content-structure-creation	Content Structure (TopicsGroup) creation via MCP tool, field type reference
kuroco-api-performance-review	API performance & usage-cost investigation (API analytics, cache configuration review, improvement proposals)
kuroco-security-audit	Read-only security configuration audit (API security, CORS, IP restrictions, permissions, tokens)

For details on each skill, see the Kuroco Skills Reference.

Prerequisites: Install Claude Code

Kuroco Skills requires Claude Code to be installed.

caution

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.

note

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

Why skills.sh is recommended

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 two commands in Claude Code. Registering the marketplace and installing the plugin are separate steps:

/plugin marketplace add diverta/kuroco-skills
/plugin install kuroco-skills@diverta-kuroco-skills

Restart Claude Code after installing to activate the 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 as consolidated files per category. After installation, Claude Code can immediately search across the documentation for accurate answers.

Announcements and release notes are not bundled because freshness matters for them. Refer to the official site for these.

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 deploy a site to KurocoFront"	frontend-integration
"I want to build a whole app on Kuroco"	app-builder
"Show me a working screen (prototype) first"	app-builder
"I want to create content from the admin panel"	admin-mcp
"I want to operate Kuroco from Claude Desktop"	admin-mcp
"I want to create a new content definition"	content-structure-creation
"Why did my Kuroco usage cost increase?"	api-performance-review
"I want to check whether my security settings are safe"	security-audit
"I want to search endpoint settings in Kuroco docs"	kuroco-docs

Letting Claude operate Kuroco via Admin MCP

For clients that natively speak the Model Context Protocol (Claude Code, Claude Desktop, Codex CLI, etc.), Kuroco exposes the Admin API as an Admin MCP Server. Once connected, you can drive admin operations by giving Claude Code instructions in natural language.

"Create three blog posts."
"I want to check the list of content definitions."
"Retrieve member information and list it."

The endpoint is mounted at /direct/rcms_api/admin_mcp/ and accepts JSON-RPC 2.0 over HTTP POST. It supports two authentication modes depending on the host:

Host	Authentication
Management URL (ROOT_MNG_URL)	Admin session cookie (same as the admin UI login)
API URL (ROOT_API_URL)	Bearer token in Authorization header

For Bearer authentication, two token shapes are accepted:

• OAuth Authorization Server access token issued by /direct/login/oauth_idp/{idpid}/token with target_domain=AdminMCP. Audience-bound per RFC 8707 / RFC 9728 — recommended for end-user authorization flows.
• Privileged static token (api_id=-1): a Bearer obtained from an active management session via AdminMCPServer::generateToken(). Use this for tools that cannot perform an OAuth handshake — programmatic issuance, scripted agents, CI without an interactive login.

For details on module-scoped URLs (/x/<csv>/readonly), recognized CSV entries, and tool naming rules, see the MCP Server Reference.

Registering with Claude Code

# OAuth Authorization Server-based authorization (recommended for end-user flows)
claude mcp add --transport http kuroco-admin \
  https://example.g.kuroco.app/direct/rcms_api/admin_mcp/x/topics_group_1,member/readonly

# Static Bearer token (CI / unattended agents)
claude mcp add --transport http kuroco-admin \
  https://example.g.kuroco.app/direct/rcms_api/admin_mcp/x/topics_group_1,member \
  --header "Authorization: Bearer <privileged-static-token>"

For more clients and header-passing rules, see MCP Client Configuration.

Billing notice

Requests under /direct/rcms_api/admin_mcp/ are routed through /direct/ and are billable in Kuroco. An AI agent operating autonomously and repeatedly may generate a large number of requests unintentionally, so prefer /readonly scoping for read-heavy agents and limit the module CSV to what each agent actually needs.

Updating

If you installed via Claude Code commands, update both the marketplace and the plugin:

/plugin marketplace update diverta-kuroco-skills
/plugin update kuroco-skills

Restart Claude Code to apply the update.

note

/plugin marketplace add only registers a marketplace — running it again on an already-registered one does not fetch the latest version (it reports already on disk). Use /plugin marketplace update to update.

If you cloned manually, update with git pull:

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)
│   ├── app-builder/             # App/site building workflow (frontend-first)
│   ├── api-content/             # API patterns + Content CRUD
│   ├── frontend-integration/    # Vite/Nuxt/Next.js integration + KurocoFront deployment
│   ├── server-processing/       # Smarty plugin reference + Batch & webhook
│   ├── admin-mcp/               # Admin MCP connection, OAuth/CIMD, scopes
│   ├── content-structure-creation/  # Content Structure creation via MCP
│   ├── api-performance-review/  # API performance & cost review
│   └── security-audit/          # Security configuration audit
├── scripts/
│   └── consolidate_docs.py      # Regenerates the bundled consolidated docs (for maintainers)
└── README.md

Related documentation

• Kuroco Skills Reference - Detailed description of each skill
• Kuroco Skills GitHub Repository
• Claude Code Official Documentation