Skip to content

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.

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.

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.

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:

Terminal window
claude plugin update controllerai

In 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.

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.