YCloud Developer Kit

YCloud Developer Kit helps your AI coding agent plan integrations, generate server-side code, and test workflows in your existing project. Describe what you want to build, such as WhatsApp order notifications, appointment reminders, or customer support, and the agent uses YCloud API contracts to guide the work. You can also ask the agent to review an existing integration or perform a specific live API operation with your configured server-side credentials.

Before you begin

For installation and local development, you need:

Codex, Claude Code, or WorkBuddy.
Node.js and npx available in your terminal.
The project where you want to build your integration.

You do not need a YCloud API key for the installation check or tests that use mocks. For live API requests, you need a YCloud account, a server-side API key, and the resources required by your workflow. See Authentication for credential setup.

Install the skills

Run the command for your coding agent from your project directory. Each command installs the full set of 17 skills in that project.

Codex
Claude Code
WorkBuddy

npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a codex --copy -y

npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a claude-code --copy -y

WorkBuddy uses the CodeBuddy-compatible skill directory, .codebuddy/skills/.

npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a codebuddy --copy -y

To choose your coding agent interactively, run:

npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*'

You can find versioned plugin ZIP packages and checksums on the official releases page.

Check the installation

Start a new session in your coding agent and send:

Use ycloud-developer-kit-smoke-test to check that YCloud Developer Kit is ready.

The expected response is:

YCloud Developer Kit is ready. No external API was called.

This check confirms that the agent can discover and invoke the readiness skill. It does not read credentials, call YCloud, or validate your account configuration. If the agent cannot find the skill, confirm that you ran the installation command in the correct project, selected the correct agent, and opened a new session for that project.

Build your first integration

Describe your business goal, project stack, and the result you need. Start with ycloud-integration-architect when the workflow spans several capabilities, such as templates, message sending, and webhooks. For example, send this prompt from your application project:

Use ycloud-integration-architect to add WhatsApp order notifications to this project.
Reuse the existing framework and configuration patterns.
Send an existing approved template and handle delivery-status webhooks.
Keep the API key on the server and verify webhook signatures.
Add local tests with synthetic data and mocked YCloud responses.
Report the files changed, test results, and remaining setup.

The agent uses the relevant domain skills for your selected workflow. Review the generated code and test results, then configure the required YCloud resources before requesting a live test. Give the agent the following context when it is relevant:

Context	Example
Business goal	Send an order confirmation through WhatsApp.
Existing stack	Reuse this project’s Node.js backend and test runner.
Scope	Use an existing template; do not create or edit templates.
Test environment	Use mocks with synthetic customer and message IDs.
Live operation	Retrieve the balance for the specified account using its configured credential reference.
Expected result	Server-side code, local tests, and a list of remaining configuration steps.

Reference credentials through your server configuration or secret manager. Do not paste API keys or webhook signing secrets into prompts.

What the kit covers

Version 0.7.13 includes 17 skills covering 88 API operations, plus API authentication and webhook receiving. The table groups the domain skills by the work you can request.

Capability	Skill	Typical tasks
API authentication	`ycloud-api-authentication`	Configure server-side API keys and plan key rotation.
WhatsApp messages	`ycloud-whatsapp-messages`	Send messages directly or through the queue, and retrieve messages.
WhatsApp media	`ycloud-whatsapp-media`	Upload media for a message workflow.
WhatsApp templates	`ycloud-whatsapp-templates`	Create, list, retrieve, edit, and delete templates; retrieve analytics.
Webhooks	`ycloud-webhook-endpoints`	Manage endpoints and build receivers with signature verification.
WhatsApp Business Accounts	`ycloud-whatsapp-business-accounts`	List and retrieve accounts; manage automatic creative optimization settings.
WhatsApp phone numbers	`ycloud-whatsapp-phone-numbers`	Manage registration, profiles, display names, usernames, and settings.
WhatsApp Groups	`ycloud-whatsapp-groups`	Manage groups, membership, join requests, and invite links.
WhatsApp Flows	`ycloud-whatsapp-flows`	Create, update, preview, publish, deprecate, and delete Flows.
Inbound message acknowledgements	`ycloud-whatsapp-inbound-messages`	Mark received messages as read or show a typing indicator.
WhatsApp Calling	`ycloud-whatsapp-calling`	Manage call sessions and download call media.
Account balance	`ycloud-balance`	Retrieve the account balance.
Contacts	`ycloud-contacts`	Manage contacts and notes, and list contact attributes.
Custom events	`ycloud-custom-events`	Manage event definitions and properties, and submit contact-associated events.
Unsubscribe preferences	`ycloud-unsubscribers`	Create, retrieve, list, and delete unsubscribe records.

The remaining two skills are ycloud-integration-architect, which coordinates workflows across domains, and ycloud-developer-kit-smoke-test, which checks installation readiness.

This release does not cover SMS, Verify, Voice, or Email integrations. Those products remain available through YCloud APIs. Use their API guides and reference pages for integration details.

More example prompts

Add inbound messages and webhooks

Use YCloud Developer Kit to add WhatsApp inbound-message handling to this backend.
Verify webhook signatures and handle duplicate events.
Add local tests for valid signatures, invalid signatures, and repeated delivery.
Report the implementation changes and test results.

Review an existing integration

Review this project's YCloud WhatsApp integration.
Check server-side authentication, request and response handling, delivery-status
webhooks, error handling, and retry behavior against the supported contracts.
Report findings and suggested fixes without changing files or calling live APIs.

Request a live read

Use ycloud-balance to retrieve the balance for the YCloud account identified in
this project's server configuration. Use the configured credential reference
without displaying the key. Report the returned amount and currency.

Local tests and live operations

Local mock tests let you check application behavior with synthetic data. A passing mock test does not confirm live authentication, message delivery, or production deployment. For live operations, specify the account, environment, target resources, and action. The agent uses the configured credentials within that scope. It asks for missing details when the target or effects are unclear. A request to develop code locally does not authorize unrelated live changes. For message sends and other asynchronous operations, distinguish an accepted request from its final outcome. Verify delivery or completion through the relevant retrieval API or webhook. If a live change times out, check the available resource state before retrying.

Getting Started

Guides

Endpoints

Webhook reference

Before you begin

Install the skills

Check the installation

Build your first integration

What the kit covers

More example prompts

Add inbound messages and webhooks

Review an existing integration

Request a live read

Local tests and live operations

Next steps

Send a WhatsApp message

Configure webhooks

​Before you begin

​Install the skills

​Check the installation

​Build your first integration

​What the kit covers

​More example prompts

​Add inbound messages and webhooks

​Review an existing integration

​Request a live read

​Local tests and live operations

​Next steps

Send a WhatsApp message

Configure webhooks

Before you begin

Install the skills

Check the installation

Build your first integration

What the kit covers

More example prompts

Add inbound messages and webhooks

Review an existing integration

Request a live read

Local tests and live operations

Next steps