Home  /  Tools and integrations

Coding Agent Skills

View as Markdown

Coding agents like Claude Code, Codex, Cursor, and others can work with Materialize using our open-source agent skills. Once installed, these skills give your coding agent access to Materialize documentation and reference material so it can provide more accurate assistance when writing queries, setting up sources, creating materialized views, and more.

Prerequisites

Node.js (v16 or later) must be installed.

Installation

Install the Materialize agent skills with a single command:

npx skills add MaterializeInc/agent-skills

Once installed, the skills activate automatically when your prompts match their intended use cases — no additional configuration required.

The skills follow the Agent Skills Open Standard and work with any coding agent that supports the standard.

To verify the installation succeeded, ask your coding agent a Materialize-specific question such as “How do I create a source from Kafka in Materialize?” and confirm it references Materialize documentation in its response.

Reduce permission prompts (Claude Code)

Claude Code prompts before reading files outside your project. Since globally installed skills live under ~/.claude/skills/, if you installed the materialize-docs skill globally, Claude Code may ask to approve reads each time the skill opens a new documentation subdirectory.

To stop these prompts, grant read access to the materialize-docs skill in ~/.claude/settings.json:

{
  "permissions": {
    "additionalDirectories": ["~/.claude/skills/materialize-docs"]
  }
}

This grants access to just that one skill’s directory. If you have multiple skills installed and want to cover them all at once, you can broaden the path to ~/.claude/skills, though scoping to a single skill is the safer default.

Claude Code’s auto permission mode also removes the prompts, but applies to all tools rather than just this directory.

What’s included

The materialize-docs skill bundles reference files across categories including:

  • SQL command references
  • Core concepts (clusters, sources, sinks, views, indexes)
  • Data ingestion (Kafka, PostgreSQL, MySQL, MongoDB, webhooks)
  • Data transformation patterns
  • Integration methods and APIs
  • Security and deployment guidance
Back to top ↑