> ## Documentation Index
> Fetch the complete documentation index at: https://starter.mintlify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf setup

> Configure Windsurf for your documentation workflow

Set up Windsurf's Cascade AI assistant to help you write and maintain your Mintlify documentation.

## Prerequisites

* Windsurf editor installed

## Setup

<Steps>
  <Step title="Open your docs directory in Windsurf">
    Open the root of your documentation repository where `docs.json` is located.
  </Step>

  <Step title="Install the Mintlify skill">
    In the integrated terminal, run:

    ```bash theme={null}
    npx skills add https://mintlify.com/docs
    ```

    This gives Windsurf Mintlify's component reference, writing standards,
    and workflow guidance.
  </Step>

  <Step title="Customize project instructions">
    Edit `AGENTS.md` in your project root to add project-specific terminology,
    style preferences, and content boundaries.
  </Step>

  <Step title="Start writing with Cascade">
    Open a file and use Cascade to draft and edit documentation.
  </Step>
</Steps>