diverta/kuroco-skills
Overview
This skill controls the Kuroco Admin API (admin_api) via the kuroco-admin CLI to discover endpoints, fetch schemas, and execute management API calls. It provides five modes (whoami, discover, schema/help, advise, execute) and enforces safe patterns for authentication, schema inspection, and write operations. Use it to script or interactively operate the management console from Bash with JSON output for automation and AI agents.
How this skill works
The CLI keeps a persistent session cookie after kuroco-admin login and sends it automatically for subsequent commands. Use whoami to verify authentication, discover or advise to find modules/controllers, help/schema to fetch request/response JSON Schema, and exec to perform GET/POST calls with --json and optional --columns. Advise accepts natural language and returns recommended API steps and parameters generated without hallucination for endpoint and spec references.
When to use it
- Exploring available management modules and controllers programmatically (discover).
- Determining required fields and types before performing INSERT/UPDATE (help/schema).
- Executing safe CRUD operations from scripts or CI with JSON responses (exec with --json).
- Getting AI-suggested API steps from a natural-language goal (advise).
- Verifying session validity and troubleshooting auth issues (whoami).
Best practices
- Always run kuroco-admin whoami --json first to confirm session validity.
- Prefer advise for business goals when mt/ct are unknown; then validate with help/schema.
- For GETs always specify --columns to minimize payload and for consistent parsing.
- For writes fetch the controller schema (help or exec MODE=schema with params) and run --dry-run before executing.
- Never log or expose the cookie file; avoid printing --verbose output that contains headers.
- Confirm user consent for any INSERT/UPDATE/DELETE and check exit codes (2 = re-login required).
Example use cases
- Create a new article: advise "create a new article" → help topics/topics_edit → exec topics/topics_edit_api MODE=INSERT --data ... --json
- List topics with pagination and limited fields: exec topics/topics_list --param "topics_group_id[]=1" --param cnt=20 --columns topics_id,subject --json
- Fetch extended schema for block editor fields by specifying topics_group_id via exec MODE=schema to include ext_col definitions.
- Bulk lookup group lists in parallel by issuing multiple kuroco-admin exec commands from separate Bash calls.
- Dry-run an update to preview request payload before committing to the API.
FAQ
Exit code 2 indicates an authentication error; run kuroco-admin login --url <URL> to re-login and then retry the operation.
When should I use discover versus advise?
Use advise when you have a goal in natural language and want recommended steps; use discover when you need a programmatic list of modules/controllers.
10 skills
This skill helps you quickly locate and reference Kuroco official documentation by guiding searches and surfacing relevant guides.
This skill helps you design, call, secure, and manage Kuroco API endpoints and content CRUD with robust error handling.
This skill helps you operate Kuroco Admin API via the kuroco-admin CLI, enabling discovery, schema retrieval, and safe execution.
This skill helps you master Kuroco Smarty templates, webhooks, and batch patterns with practical examples and best practices.
This skill helps you operate Kuroco mng_api from a browser, enabling discovery, execution, and schema access with authenticated fetch.
This skill enables browser-based execution of Kuroco admin_api via authenticated fetch calls, providing discovery, schema, and execution workflows.
This skill helps you integrate Kuroco with Nuxt or Next.js, enabling secure authentication, SSR/SSG, and seamless content delivery.
This skill helps you design and integrate Kuroco API endpoints securely, with authentication, rate limiting, caching, and error handling best practices.
This skill automates registration, build, upload, and deployment of Kuroco sites from AI prompts, delivering preview or production URLs efficiently.
This skill helps you manage Kuroco content CRUD operations efficiently with best practices for topics, extensions, filtering, and exports.
