Skip to main content
Set up Cursor to help you write and maintain your Mintlify documentation.

​
Prerequisites

  • Cursor editor installed

​
Setup

1

Open your docs directory in Cursor

Open the root of your documentation repository where docs.json is located.
2

Install the Mintlify skill

In the integrated terminal, run:
npx skills add https://mintlify.com/docs
This gives Cursor Mintlify’s component reference, writing standards, and workflow guidance.
3

Customize project instructions

Edit AGENTS.md in your project root to add project-specific terminology, style preferences, and content boundaries.
4

Start writing with Cursor

Open a file and use Cursor’s AI features to draft and edit documentation.

​
Using Cursor with Mintlify

Use Cursor’s AI chat to ask questions about Mintlify components while you write. The Mintlify skill provides context for all available components and their usage.

​
Quick tips

  • Use Cmd+K (Mac) or Ctrl+K (Windows/Linux) to edit inline
  • Use Cmd+L (Mac) or Ctrl+L (Windows/Linux) to open the chat
  • Reference specific files using @filename in chat
  • Ask Cursor to add components like <Note>, <Tip>, or <CodeGroup>
Make sure your AGENTS.md file is configured with your project-specific terminology and style preferences for the best results.

​
Next steps

After setting up Cursor, you can:
  • Start drafting new documentation pages
  • Use Cursor to refactor existing content
  • Ask Cursor to add Mintlify components to your pages
  • Preview your changes with mint dev

Build docs developers (and LLMs) love

Get started for freeTalk to us