Skip to main content
Set up Windsurf’s Cascade AI to work on the D-Sports docs (this repo). Cascade can use the Mintlify skill for components and style, and AGENTS.md for D-Sports-specific rules.

Prerequisites

  • Windsurf editor installed

Setup

1

Open the D-Sports docs repo in Windsurf

Open the root of this documentation repository (where docs.json is). This repo builds docs.d-sports.org.
2

Install the Mintlify skill

In the integrated terminal, run:
npx skills add https://mintlify.com/docs
This gives Windsurf Mintlify’s component reference and writing standards so Cascade can suggest correct MDX and components.
3

Use AGENTS.md

The repo’s AGENTS.md includes D-Sports terminology, style preferences, and a Mintlify MDX quick reference. Configure workspace rules or mention “D-Sports docs” / “Mintlify” so Cascade follows our style.
4

Write and preview

Use Cascade to draft or edit MDX; run mint dev to preview at http://localhost:3000.