> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-docs.synta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Rules & Agent Instructions

> Configure AI agent rules for optimal n8n workflow automation

Agent rules help your AI client understand n8n workflow patterns, best practices, and common pitfalls. Configure these rules once and get expert-level workflow building:

* **Node discovery patterns**: When to use `search_nodes` vs `get_node`
* **Workflow building guidelines**: Proper connection handling and node configuration
* **Validation requirements**: Always validate before deployment
* **Self-healing instructions**: How to leverage `n8n_trigger_execution` for automatic error fixing

<div class="callout mint-my-4 mint-px-4 mint-py-3 mint-overflow-hidden mint-rounded-xl mint-flex mint-gap-3 mint-border mint-border-[#c15f3c]/30 mint-bg-[#c15f3c]/10">
  <div class="mint-mt-0.5 mint-w-4 mint-flex-shrink-0">
    <svg class="mint-w-4 mint-h-4 mint-text-[#c15f3c]" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
      <path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
    </svg>
  </div>

  <div class="mint-text-sm mint-text-[#c15f3c]">
    Rules are optional but highly recommended. They significantly improve the quality of AI-generated workflows.
  </div>
</div>

## Client Configuration

Select your AI client to see specific setup instructions:

<Tabs>
  <Tab title="Cursor">
    ### Project Rules Setup

    <Steps>
      <Step title="Open Project Rules and Add Rule">
        Go to **Cursor Settings** → **Rules and Commands** → **Project Rules** → Click **"Add Rule"**
      </Step>

      <Step title="Copy Rule Content">
        Visit the [Cursor Rules for Synta](https://github.com/Synta-ai/synta-rules-for-agents/blob/main/.cursor/rules/synta.mdc).

        Then, copy the rule file's content, paste into the editor and save.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    ### Project Instructions Setup

    <Steps>
      <Step title="Create CLAUDE.md">
        In your project root, create a file named `CLAUDE.md`
      </Step>

      <Step title="Copy agent instructions">
        Visit the [Claude Code instructions for Synta](https://github.com/Synta-ai/synta-rules-for-agents/blob/main/.claude/agents/synta.md)

        Then, copy the rule file’s content, paste into your `CLAUDE.md` and save.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude.ai">
    ### Project Instructions Setup

    <Steps>
      <Step title="Create a New Project">
        Open Claude (Desktop app or Claude.ai website) and navigate to **Projects** → **Create New Project**. Give your project a name and description, and then click "Create Project".
      </Step>

      <Step title="Edit Custom Instructions">
        In the project, click the **plus icon** on the right-hand side of the **Instructions** text label.
      </Step>

      <Step title="Add Custom Instructions">
        Visit the [Claude instructions for Synta](https://github.com/Synta-ai/synta-rules-for-agents/blob/main/.claude/agents/synta.md)

        Then, copy the file's content, paste it into the text field and click **Save instructions**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    ### Project Instructions Setup

    <Steps>
      <Step title="Create a Project">
        On the left sidebar, click the **New project** button, add a name and then click **Create project**
      </Step>

      <Step title="Open Project Settings">
        Click the three dots (**…**) at the top right of the editor and choose **Project settings**
      </Step>

      <Step title="Add Project Instructions">
        Visit the [ChatGPT project instructions for Synta](https://github.com/Synta-ai/synta-rules-for-agents/blob/main/.chatgpt/chatgpt-project-instructions.md).

        Then, copy the file's content, paste it into the **Instructions** field and click **Save**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Codex">
    ### Project Skill Setup

    <Card>
      <div class="mint-flex mint-items-center mint-gap-2 mint-mb-4">
        <span class="mint-font-semibold">Quick install</span>
      </div>

      Run the command for your OS to auto-install the Synta Skill:

      <CodeGroup>
        ```bash macOS/Linux theme={null}
        mkdir -p ~/.agents/skills/synta-n8n
        curl -o ~/.agents/skills/synta-n8n/SKILL.md https://raw.githubusercontent.com/Synta-ai/synta-rules-for-agents/main/.codex/skills/SKILL.MD
        ```

        ```powershell Windows (PowerShell) theme={null}
        New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills\synta-n8n"
        Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Synta-ai/synta-rules-for-agents/main/.codex/skills/SKILL.MD" -OutFile "$env:USERPROFILE\.agents\skills\synta-n8n\SKILL.md" -UseBasicParsing
        ```

        ```cmd Windows (Command Prompt) theme={null}
        mkdir "%USERPROFILE%\.agents\skills\synta-n8n" 2>nul
        curl -L -o "%USERPROFILE%\.agents\skills\synta-n8n\SKILL.md" https://raw.githubusercontent.com/Synta-ai/synta-rules-for-agents/main/.codex/skills/SKILL.MD
        ```
      </CodeGroup>

      Then, restart Codex. Use `$` or `/skills` to invoke, or let Codex call by description.
    </Card>
  </Tab>

  <Tab title="Google Antigravity">
    ### Project Rules Setup

    <Steps>
      <Step title="Open the Rules tab">
        Click the three dots (**…**) at the top of the editor's agent panel → **Customizations** and switch to the **Rules** tab.
      </Step>

      <Step title="Add rule">
        Choose either:

        * **+ Global** (applies across all your workspaces)
        * **+ Workspace** (applies only to the current project).
      </Step>

      <Step title="Copy description and content, then save">
        In the editor for the rule:

        1. Set the activation mode (recommended: **Model Decision**).
        2. **Description** — Copy and paste from this block:

        ```
        Expert guidance for building and editing n8n workflows with Synta MCP tools. Use for creating new workflows, modifying existing workflows, template discovery, node configuration, validation, and connection management in n8n.
        ```

        3. **Content** — Copy the [Antigravity rule content for Synta](https://github.com/Synta-ai/synta-rules-for-agents/blob/main/.antigravity/agents/rules/synta_rule_content.md) and paste.
        4. Save the rule.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenCode">
    ### Project Rules Setup

    <Steps>
      <Step title="Create AGENTS.md">
        In your project root, create a file named `AGENTS.md`
      </Step>

      <Step title="Copy agent instructions">
        Visit the [OpenCode instructions for Synta](https://github.com/Synta-ai/synta-rules-for-agents/blob/main/.opencode/AGENTS.md)

        Then, copy the rule file content, paste it into your `AGENTS.md` file and save.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenClaw">
    ### Project Skill Setup

    <Card>
      <div class="mint-flex mint-items-center mint-gap-2 mint-mb-4">
        <span class="mint-font-semibold">Quick install</span>
      </div>

      Run the command for your OS to install the Synta skill into your managed skills directory:

      <CodeGroup>
        ```bash macOS/Linux theme={null}
        mkdir -p ~/.openclaw/skills/synta-n8n
        curl -o ~/.openclaw/skills/synta-n8n/SKILL.md https://raw.githubusercontent.com/Synta-ai/synta-rules-for-agents/main/.openclaw/skills/SKILL.md
        ```

        ```powershell Windows (PowerShell) theme={null}
        New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw\skills\synta-n8n"
        Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Synta-ai/synta-rules-for-agents/main/.openclaw/skills/SKILL.md" -OutFile "$env:USERPROFILE\.openclaw\skills\synta-n8n\SKILL.md" -UseBasicParsing
        ```

        ```cmd Windows (Command Prompt) theme={null}
        mkdir "%USERPROFILE%\.openclaw\skills\synta-n8n" 2>nul
        curl -L -o "%USERPROFILE%\.openclaw\skills\synta-n8n\SKILL.md" https://raw.githubusercontent.com/Synta-ai/synta-rules-for-agents/main/.openclaw/skills/SKILL.md
        ```
      </CodeGroup>

      Start a new session (or restart the gateway) so OpenClaw picks up the skill. You can invoke it via slash command or let the agent match by description.
    </Card>
  </Tab>

  <Tab title="Windsurf">
    ### Project Rules Setup

    <Steps>
      <Step title="Open the Rules settings">
        Go to **Windsurf** → **Settings** → **Windsurf Settings**, click on the **Cascade** tab on the left-hand sidebar, find the **Cascade Rules** heading and click **"Manage rules"**.
      </Step>

      <Step title="Add rule">
        Choose either:

        * **+ Global** (applies across all your workspaces)
        * **+ Workspace** (applies only to the current project)
      </Step>

      <Step title="Copy and paste rule content">
        Visit the [Windsurf rules for Synta](https://github.com/Synta-ai/synta-rules-for-agents/blob/main/.windsurf/synta.md).

        Copy the file's content, paste it into the editor, and save.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Contributing

<Card>
  The repository is open-source and welcomes contributions:

  * Add configurations for new AI agents
  * Improve existing rule sets
  * Share workflow patterns and examples

  Visit the [repository](https://github.com/Synta-ai/synta-rules-for-agents) to contribute or report issues.

  <div class="callout mint-my-4 mint-px-4 mint-py-3 mint-overflow-hidden mint-rounded-xl mint-flex mint-gap-3 mint-border mint-border-[#c15f3c]/30 mint-bg-[#c15f3c]/10">
    <div class="mint-mt-0.5 mint-w-4 mint-flex-shrink-0">
      <svg class="mint-w-4 mint-h-4 mint-text-[#c15f3c]" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
        <path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
      </svg>
    </div>

    <div class="mint-text-sm mint-text-[#c15f3c]">
      These configurations are maintained by the Synta community and are designed to help agents make the most of Synta's MCP server capabilities.
    </div>
  </div>
</Card>

## Next Steps

<Card title="View Best Practices" icon="lightbulb" href="/best-practices">
  Learn tips and tricks for building better workflows with AI
</Card>