What problem does it solve?
Adding a new capability to the ryOS AI assistant requires touching many files across the server and client, and it is easy to miss a step such as the dispatch switch case or the execution-side metadata. This Skill provides the complete file map, decision rules, and code patterns so a new chat tool works end to end on the first attempt.
Core Features & Use Cases
- Server vs Client Decision Guide: Determines whether a tool needs a server-side
execute function (Redis, secrets, server fetch) or a client-side handler (Zustand stores, IndexedDB, DOM, media playback).
- Step-by-Step Implementation: Covers Zod schema definition, tool description and registration, execution metadata, client handler conventions, dispatch wiring, and server executors.
- Testing and Checklist Guidance: Explains how to add schema unit tests and verify the tool end to end in the Chats app.
- Use Case: You want Ryo to control a new app feature, such as listing and creating items in a store. Follow the Skill to add the schema, description, handler, and dispatch case so the AI can invoke the capability in chat.
Quick Start
Ask the AI to add a new chat tool named myFeatureControl following the add-ai-chat-tool skill, with list, create, and delete actions handled client-side.