Skip to content

About

Storyblok Agent Skills for Claude Code, Codex, Cursor and Antigravity

Resources

Contributing

Security policy

Stars

9 stars

Watchers

0 watching

Forks

Repository files navigation

Storyblok Agent Skills

Agent skills for working with Storyblok via the Storyblok MCP server and CLI.

Documentation: Agent Skills

Generated distribution repo: its root is the plugin. Do not open pull requests against the generated files—see AGENTS.md.

Install

Install the plugin in every supported agent on your device:

npx plugins add storyblok/agent-plugin

In Claude Code, you can also run:

/plugin marketplace add storyblok/agent-plugin
/plugin install storyblok@storyblok

For Codex, Cursor, Kiro, Antigravity, and agents without plugin support, refer to the Install section of the docs.

The plugin registers the Storyblok MCP server over OAuth. No token is stored in this repo.

Skills

Skill When it activates
storyblok-build-frontend Generating frontend components for Storyblok blocks — writing, registering and validating the framework code that renders a space's content. E.g. "generate components for my blocks", "build an Astro + Storyblok landing page".
storyblok-build-plugin Extending Storyblok with plugins to enhance what editors can do — custom field inputs, Visual Editor panels, pages inside a space, integrations with external systems — including choosing, building, or deploying one. E.g. "editors need a map location picker", "build a field plugin", "deploy our plugin".
storyblok-implement-figma Turning a Figma design into frontend components backed by Storyblok blocks. E.g. "figma to storyblok", "build this Figma design".
storyblok-model-content Creating or modifying Storyblok components/blocks, content types, or fields, or modeling a content schema from multi-modal input. E.g. "model content for a blog", "add an image field to the teaser", "set up blocks for this landing page design".
storyblok-use-cli Driving Storyblok through the Storyblok CLI — code-driven schema, content migrations, bulk pull/push of stories, components, assets or datasources, or scaffolding a project.
storyblok-use-mcp Interacting with Storyblok through the MCP server — the tool model, operation names and payload shapes for stories, assets, components, datasources and every other resource. Load it before calling mcp__storyblok__ tools, alongside the skill that owns the task.
storyblok-use-storyblok A request touches Storyblok at all, including advice or a plan that changes nothing yet. You MUST load it first — before any other Storyblok skill and before any mcp__storyblok__ tool — to pick the right skill and the right tool for the job. E.g. "add an FAQ section to the pricing page", "model content for a blog", "set up Storyblok in this project".

What the skills run, fetch and send

The skills are instructions for the agent. Besides the Storyblok MCP server, they use these, only while doing the job the skill describes:

  • Figma MCP server (storyblok-implement-figma): reads the design the user links through the Figma MCP server the user has connected. The plugin does not ship or configure it; the request carries only the file key and node ids of that design.
  • Asset upload (storyblok-implement-figma: sync-assets.sh, upload-asset.sh) downloads each image listed in the asset manifest from its URL (usually a Figma export), then uploads it to the user's Storyblok space: the Storyblok Management API for the space's region (e.g. mapi.storyblok.com) and the signed upload URL that API returns. It authenticates with the personal access token the user names (an environment variable or a secret-manager command), which the agent pipes in on stdin; a token that is merely set in the environment is never used. The token reaches curl through a private temporary file, never the command line, and is not written to the project or sent anywhere else.
  • Page screenshots and image checks (storyblok-build-frontend: screenshot-page.sh; storyblok-implement-figma: preview-assets.sh, inspect-image.sh) open the given page or images in headless Chromium and write the result to a local file. They use the project's own Playwright when it has one. Otherwise they run Playwright 1.63.0 from npm through npx, and Playwright downloads Chromium if none is installed.
  • Storyblok CLI: the skills may run the Storyblok CLI from npm, which uses its own login.
  • Storyblok Management API: when neither the MCP server nor the CLI has an operation, the skills may call the Management API directly with the personal access token the user names. Without one, the agent asks which to use.

Support and privacy

License

MIT

About

Storyblok Agent Skills for Claude Code, Codex, Cursor and Antigravity

Resources

Contributing

Security policy

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages