---
title: Agent Skills
description: Storyblok Agent Skills instruct AI coding agents to work efficiently with Storyblok through the MCP server and CLI.
url: https://www.storyblok.com/docs/tooling/agent-skills
---

# Agent Skills

[Storyblok Agent Skills](https://github.com/storyblok/agent-plugin) instruct AI coding agents, such as Claude Code, Codex, and Cursor, to work efficiently with Storyblok. The skills follow [Agent Skills](https://agentskills.io), an open format for instructions that agents load on demand.

The skills cover the following tasks:

-   **Content modeling:** create and change blocks, content types, and fields.
-   **Frontend development:** write and register the components that render a space’s blocks.
-   **Figma implementation:** turn a design into Storyblok blocks and the components that render them.
-   **Space management:** use the MCP server or the CLI, depending on the task.

## Install

Storyblok ships the skills as a plugin. The plugin installs every skill, registers the Storyblok [Model Context Protocol (MCP) server](/docs/tooling/mcp-server), and updates through the agent’s plugin manager.

To install the plugin in every supported agent on your device, run the following command:

```bash
npx plugins add storyblok/agent-plugin
```

The [`plugins` CLI](https://www.npmjs.com/package/plugins) detects which of the following agents you have, and installs the plugin for your user account through each one’s own plugin system:

-   Claude Code
-   Codex
-   Cursor
-   GitHub Copilot CLI
-   Grok Build
-   Kimi Code
-   VS Code

> [!NOTE]
> On macOS and Linux, Cursor loads the plugin from Claude Code’s plugin folder. To use it, enable **Include Third-Party Plugins, Skills, and Other Configs** in Cursor’s settings. Otherwise, follow the steps in the **Cursor** tab below.

To install the plugin manually, or in an agent the `plugins` CLI doesn’t support, such as Kiro or Antigravity, follow the steps for the agent:

-   Claude Code
    
    Add the marketplace and install the plugin from inside Claude Code:
    
    ```text
    /plugin marketplace add storyblok/agent-plugin
    /plugin install storyblok@storyblok
    ```
    
    Or from a shell:
    
    ```bash
    claude plugin marketplace add https://github.com/storyblok/agent-plugin.git
    claude plugin install storyblok@storyblok
    ```
    
-   Codex
    
    ```bash
    codex plugin marketplace add storyblok/agent-plugin
    codex plugin add storyblok@storyblok
    ```
    
-   Cursor
    
    Clone the plugin into Cursor’s local plugins folder:
    
    ```bash
    git clone https://github.com/storyblok/agent-plugin ~/.cursor/plugins/local/storyblok
    ```
    
    In Cursor’s settings, enable **Allow Local Plugin Imports**, and then reload the Cursor window.
    
-   Kiro
    
    Open the **Powers** panel, select **Add Custom Power** → **Import power from GitHub**, and enter `https://github.com/storyblok/agent-plugin`.
    
-   Antigravity
    
    ```bash
    git clone https://github.com/storyblok/agent-plugin
    agy plugin install ./agent-plugin
    ```

> [!WARNING]
> When you connect the agent to Storyblok, grant it access only to the spaces and permissions it needs. Learn more in [Working safely](/docs/tooling/mcp-server#working-safely).

For an agent without plugin support, install the skills with the [`skills` CLI](https://skills.sh), and then [set up the MCP server](/docs/tooling/mcp-server/setup):

```bash
npx skills add storyblok/agent-plugin
```

## Skills

The agent loads a skill when a request matches the skill’s description. To use a skill explicitly, mention it by name in the prompt.

The plugin has no custom slash commands. In Claude Code, each skill is also available as a slash command, prefixed with the plugin name. For example, `/storyblok:storyblok-model-content`.

| Skill | Use it to | Example prompt |
| --- | --- | --- |
| [`storyblok-use-storyblok`](https://github.com/storyblok/agent-plugin/tree/main/skills/storyblok-use-storyblok) | Start any Storyblok task. The agent loads this skill first to pick the right tool and skill for the request. | “Add an FAQ section to the pricing page” |
| [`storyblok-model-content`](https://github.com/storyblok/agent-plugin/tree/main/skills/storyblok-model-content) | Create or change blocks, content types, and fields, or model a content schema from a description or a design. | “Model content for a blog” |
| [`storyblok-build-frontend`](https://github.com/storyblok/agent-plugin/tree/main/skills/storyblok-build-frontend) | Write, register, and validate the frontend components that render a space’s blocks. | “Build an Astro + Storyblok landing page” |
| [`storyblok-implement-figma`](https://github.com/storyblok/agent-plugin/tree/main/skills/storyblok-implement-figma) | Turn a Figma design into Storyblok blocks and the frontend components that render them. Requires a connected Figma MCP server. | “Build this Figma design with Storyblok” |
| [`storyblok-use-mcp`](https://github.com/storyblok/agent-plugin/tree/main/skills/storyblok-use-mcp) | Call the MCP server correctly: the tool model, operation names, and payload shapes for every resource. | —   |
| [`storyblok-use-cli`](https://github.com/storyblok/agent-plugin/tree/main/skills/storyblok-use-cli) | Use the Storyblok CLI for code-driven schemas, content migrations, and bulk pulls and pushes. | “Pull all stories from this space” |

The other skills load `storyblok-use-mcp` and `storyblok-use-cli` when a task needs the MCP server or the CLI.

## How skills relate to the MCP server

The [MCP server](/docs/tooling/mcp-server) and the skills are separate, and the plugin installs both:

|     | MCP server | Agent Skills |
| --- | --- | --- |
| Provides | Access to a Storyblok space through the Management API | Instructions for using that access: which operation fits a task, what a valid schema looks like, and when to use the [CLI](/docs/tooling/cli) |
| Works without the other | Yes | Yes, using the CLI or direct Management API calls instead |
| Permissions | The spaces and permissions you grant | None of their own. Every change runs through the MCP server or the CLI |

Without the skills, an agent works out operations and payloads by trial and error. This takes more time and tokens, and tends to create new components instead of reusing existing ones.

To check what the skills run, fetch, and send on your machine, refer to the [plugin’s README](https://github.com/storyblok/agent-plugin#what-the-skills-run-fetch-and-send).

## Update

To get fixes and new skills, update the plugin. Run `npx plugins add storyblok/agent-plugin` again, or follow the steps for the agent:

-   Claude Code
    
    ```bash
    claude plugin update storyblok@storyblok
    ```
    
-   Codex
    
    Refresh the marketplace, and then reinstall the plugin:
    
    ```bash
    codex plugin marketplace upgrade storyblok
    codex plugin add storyblok@storyblok
    ```
    
-   Cursor
    
    Pull the latest version into the plugin folder, and then reload the Cursor window:
    
    ```bash
    git -C ~/.cursor/plugins/local/storyblok pull
    ```
    
-   Kiro
    
    In the **Powers** panel, select **storyblok**, and then select **Check for updates**.
    
-   Antigravity
    
    Antigravity installs a copy of the plugin, so pulling the clone doesn’t update it on its own. Pull the latest version, and then install the plugin again:
    
    ```bash
    git -C agent-plugin pull
    agy plugin install ./agent-plugin
    ```

Skills installed with the `skills` CLI don’t update with the plugin. To update them, run:

```bash
npx skills update
```

## Pagination

-   [Previous: Setup](/docs/tooling/mcp-server/setup)