Skills and Updates
How do you give an assistant the right guidance? Start with controllerai-start. Then load the skill for the task in hand, together with the references it points to. The eleven skills cover agent building, workflow construction, and verification. A skill guides the assistant’s work. It does not authorize an action, and it does not expand the account’s permissions.
The skills ship inside the Controller AI plugins: the Claude plugin for Claude Code, Cowork and Claude chat, and the OpenAI plugin for ChatGPT and Codex. A host without a plugin, such as Cursor or a connector added by URL, reads the same skills from the MCP server with guide_list and guide_get. The plugin, its skill set, and the hosted server each report their version separately.
Choose a skill for the next task
Section titled “Choose a skill for the next task”In the running example, Support helper answers policy questions from support-policy.md. Load the agent guidance for that work. Add the workflow guidance when the helper needs a Support desk workflow to record an escalation.
| Skill | Read it when you need to… | Example step |
|---|---|---|
controllerai-start |
Choose the deliverable and next skill. | Decide whether Support helper needs an agent, a workflow, or both. |
controllerai-agents |
Write instructions, add files and tools, test, or publish an agent. | Give Support helper its policy file. |
controllerai-integration-actions |
Attach one existing app operation directly to an agent. | Add a discovered support-channel notification action. |
controllerai-workflows |
Create, inspect, validate, restore, or publish a workflow. | Build Support desk. |
controllerai-node-config |
Discover and configure a node’s component, properties, and connection. | Configure the escalation step. |
controllerai-expressions |
Bind inputs, calculate values, or debug a resolved value. | Pass the ticket ID into a node. |
controllerai-flow-control |
Branch, loop, call a subflow, or handle an error. | Route a ticket with missing information. |
controllerai-data |
Define schemas and read, write, or import records. | Store ticket T-104. |
controllerai-ai-nodes |
Configure Ask AI or a workflow action that talks to an agent. | Summarize the ticket before escalation. |
controllerai-triggers |
Capture, map, test, or enable a schedule or event source. | Start processing when a ticket arrives. |
controllerai-runs |
Test a flow or inspect inputs, outputs, skips, and warnings. | Check the saved ticket and execution result. |
Read one skill’s instructions before you act. Then open the referenced file that answers the question in front of you. For example, agent release work points to references/instructions-and-versioning.md in controllerai-agents.
Where the skills come from
Section titled “Where the skills come from”| Host | How the skills arrive | How they update |
|---|---|---|
| Claude Code, Cowork, Claude chat | Bundled in the Claude plugin (Controller-AI/controllerai-claude-plugin, version 0.4.0). |
Update the plugin. |
| ChatGPT, Codex | Bundled in the OpenAI plugin. | Update the plugin through the host. |
| Cursor and other MCP hosts | Served by guide_list and guide_get. |
Always the server’s current bundle. |
A plugin’s skills and a connector’s guides come from the same authored skill tree. A plugin installs skills into the host. Remote guides install nothing on your machine. For account access and the builder’s handoffs, read Assistant security.
Update the plugin
Section titled “Update the plugin”In the Controller AI app, open Connect for setup. A plugin update belongs to the host that owns the plugin, and it replaces the bundled skills. None of these updates select or change a workflow.
In Claude Code, update the plugin, then run /reload-plugins or restart:
claude plugin update controlleraiIn Cowork and Claude chat, update or reinstall the plugin from Customize → Plugins. In ChatGPT and Codex, follow the host’s plugin controls. For setup details, see the host’s setup guide.
The in-product builder uses its bundled set. If it meets a runtime problem, it must report that instead of updating itself.
Fetch guides without a plugin
Section titled “Fetch guides without a plugin”Call guide_list with {} to see guide names, versions, and digests. Then call guide_get with the exact name you selected:
{ "name": "controllerai-agents" }The response includes instructions, skillSetVersion, sha256, and the referenced Markdown files with their own content and digests. Both tools read the server’s bundled guidance. Neither modifies account resources. When diagnosing a mismatch, compare the plugin’s skill set with the skillSetVersion the server reports, and keep each version attached to the component that reported it. As you build Support helper, use the MCP tool reference for exact operation contracts.