Skip to main content
Release version: βversion

Kuroco Skills Reference

This page provides a detailed description of the 5 skills included in Kuroco Skills.

A skill that assists with searching and referencing Kuroco official documentation.

Features

  • Cross-search of official documentation bundled with the plugin
  • Quick reference organized by purpose (API, authentication, frontend, content management, etc.)

Example queries

"I want to know how to configure endpoints in Kuroco"
"Show me the login API specification"
"How do I write filter queries?"

Bundled documentation structure

DirectoryContent
tutorials/How-to guides, implementation steps, sample code
reference/API settings, Smarty plugins, filter queries
management/Detailed descriptions of admin panel features
faq/Frequently asked questions and answers
about/Kuroco overview, pricing plans, limitations, glossary
troubleshooting/Error resolution and diagnostic guides
information/Announcements and release information
update/Update information

kuroco-api-content - API integration & content management

A skill that provides best practices for Kuroco API design, implementation, and content management (CRUD operations). This skill consolidates the former kuroco-api-integration and kuroco-content-management skills.

Features

API integration:

  • Endpoint design patterns (URL structure, key models, operations)
  • 3 authentication methods (Cookie / Token / StaticToken)
  • CORS settings, caching strategies, rate limiting
  • Error handling patterns

Content management:

  • Content structure (Topics / TopicsGroup / TopicsCategory)
  • Custom fields (ext_col) setup and usage
  • Topics API operations (list / details / insert / update / delete / bulk_upsert)
  • Filter query syntax and usage
  • File uploads, CSV import/export

Example queries

"I want to implement login with Kuroco API"
"How do I use token authentication?"
"I'm getting a CORS error. How do I configure it?"
"I want to create a content definition in Kuroco"
"How do I get a list of articles via API?"
"I want to filter articles by a specific category"

Keywords

Kuroco API endpoint settings authentication CORS Cookie authentication Token authentication StaticToken JWT rate limiting credentials include 401 error 403 error 429 error pageInfo pagination content definition Topics category WYSIWYG file upload CSV import ext_col filter order_by bulk_upsert topics_flg custom fields

Authentication method comparison

MethodRecommended use caseFeatures
Cookie authenticationWeb appsSession-based. credentials: 'include' required
Token authenticationMobile appsJWT-based. Token in header
StaticToken authenticationServer-to-serverFixed token. Configured in admin panel

Filter query basic syntax

OperatorExample
=, !=filter=category_id = 1
>, >=, <, <=filter=ymd >= '2024-01-01'
containsfilter=subject contains 'keyword'
in, not_infilter=category_id in [1, 2, 3]

kuroco-frontend-integration - Frontend integration & AI deployment

A skill that provides integration patterns for Kuroco with Nuxt.js / Next.js, and AI automated deployment workflows. This skill now includes the former kuroco-ai-deployment skill.

For a hands-on tutorial, see the Kuroco Sample Site Tutorial.

Features

Frontend integration:

  • Integration patterns for Nuxt 3 / Nuxt 2 / Next.js (App Router / Pages Router)
  • Environment variables, project structure examples
  • Authentication implementation (login / logout / auth check / signup)
  • SSG / SSR configuration
  • KurocoPages integration
  • Third-party cookie issue solutions

AI automated deployment:

  • Deployment workflow (site registration → build → upload → deploy)
  • Temporary file upload using presigned URLs
  • Preview deploy / production deploy
  • Automatic framework detection (Nuxt / Next.js / Vite)

Example queries

"I want to display Kuroco content with Nuxt3"
"How do I implement authentication with Next.js and Kuroco?"
"I want to generate a static site with SSG"
"Login doesn't work on Safari (cookie issue)"
"I want to auto-deploy a Kuroco site"
"I want to deploy to a preview environment first"

Keywords

Nuxt3 Next.js App Router SSG SSR useAsyncData $fetch composable useAuth KurocoPages credentials include third-party cookies AI automated deployment add_site temp-upload presigned URL kuroco_front/deploy artifact_url stage_url CI/CD

Framework recommendations

FrameworkRecommended use case
Nuxt.js 3.xNew Vue projects (recommended)
Nuxt.js 2.xExisting Vue projects
Next.js 13+ (App Router)New React projects
Next.js (Pages Router)Existing React projects

Deployment workflow

1. Site registration  → mng_api (add_site)
2. Frontend build → npm run build / nuxt generate
3. Upload → presigned URL → S3
4. Deploy → mng_api (KurocoFront deploy)
5. Complete → stage_url (preview) or production_url

kuroco-server-processing - Smarty plugins & batch processing

A skill that provides a complete reference for Kuroco Smarty templates and automation patterns using batch processing, webhooks, and triggers. This skill consolidates the former kuroco-smarty-plugins and kuroco-webhook-processing skills.

Features

Smarty plugin reference:

  • Complete reference for 206 plugins
  • Category index (API / string / array / form / auth / integration / file / Vue.js)
  • Smarty basic syntax (variable assignment, loops, conditionals, modifiers)
  • Security settings (IF_FUNCS / MODIFIER_FUNCS)

Batch processing & webhooks:

  • Batch processing setup and execution frequency
  • Internal API calls (api_internal)
  • External API calls (api_request)
  • Trigger processing (on content update / on form submission)
  • External service integration (Slack / email / GitHub Actions)

Example queries

"I want to get and display a list of articles with Smarty"
"How do I use the sendmail plugin?"
"How do I parse JSON in Smarty?"
"I want to generate CSV daily with batch processing"
"I want to send a Slack notification when content is updated"
"I want to trigger a deploy via GitHub Actions"

Keywords

Smarty plugin Smarty function Smarty modifier assign foreach escape date_format api_internal sendmail slack_post_message ai_completion write_file batch processing Webhook scheduled execution cron Slack notification GitHub Actions api_request trigger custom function

Category reference

CategoryKey plugins
API & data retrievalapi_internal, assign_topics_list, assign_tag_list
String processingescape, truncate, date_format, translate
Array operationscount, in_array, implode, explode
Form & UIfileupload, inquiry_input, pager
Auth & permissionsrcms_auth, login, logout
External integrationsendmail, slack_post_message, ai_completion
File operationswrite_file, put_file, read_file
Vue.js integrationrcms_vue_component, head_include

Batch processing frequency

FrequencyUse case
Every 15 minutesWhen frequent sync is needed
Every 30 minutesNear-real-time processing
Every hourPeriodic aggregation and updates
Daily (specified time)Daily reports, backups

kuroco-mng-api-browser - Management API operations

A skill for operating the Kuroco management API (mng_api) via browser. It works with the Claude in Chrome extension for Claude Code.

Features

  • 4 mng_api modes (whoami / discover / schema / execute)
  • Authentication using browser session cookies
  • API exploration (discover mode / llms.txt)
  • Admin panel UI operations (navigation, form input)

Example queries

"Create content from the admin panel"
"Show me the content definitions for this site"
"Get member information via management API"
"Automate data entry in the admin panel"

Keywords

mng_api management API admin panel operations browser automation discover llms.txt Topics creation Member registration

Prerequisites

  • Claude in Chrome MCP must be installed
  • Must be logged in to the Kuroco admin panel

mng_api modes

ModeDescriptionUse case
whoamiGet session informationAuth check, get logged-in user permissions
discoverExplore available models & methodsUnderstand API structure
schemaGet request/response schemasCheck parameter specifications
executeExecute APIRetrieve, create, update, delete data

Security considerations

  • Do not display or log cookie values
  • Do not extract tokens via document.cookie
  • Always confirm with user before change operations (insert / update / delete)
  • File saving of API responses requires user consent


Support

If you have any other questions, please contact us or check out Our Slack Community.