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.
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-mng-api-browser | Management API (mng_api) browser operations & admin panel automation |
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
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.
Examples
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" | mng-api-browser |
| "I want to search endpoint settings in Kuroco docs" | kuroco-docs |
Information provided by skills
Each skill provides the following types of information to Claude Code:
- Code examples: Implementation examples for API calls, authentication, content operations, etc.
- Setup guides: Step-by-step guides for admin panel configuration
- Best practices: Caching strategies, error handling, security settings
- Troubleshooting: Common errors and their solutions
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
│ └── marketplace.json # Marketplace registration info
├── 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
│ └── mng-api-browser/ # Management API browser operations
├── scripts/
│ └── validate.sh # Skill validation script
└── 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.