Add Cloud agent starter skill for running and testing the codebase

[ridgelawrence]

What

Adds a minimal starter skill at .cursor/skills/cloud-agent-starter.md that tells Cloud agents how to run and test this Mintlify documentation site.

Why

Cloud agents currently have no repo-specific guidance for setup, testing, or common workflows. This skill gives them actionable instructions from the first turn.

What's in the skill

Section	Covers
What This Repo Is	Mintlify MDX docs site, no backend/DB
Prerequisites	Node 19+, npm i -g mint
Repo Layout	Table mapping every directory to its purpose
Starting the Dev Server	mint dev, custom ports, troubleshooting table
Auth & Feature Flags	None needed — explicit callout so agents don't waste time looking
Codebase Areas & Testing	Per-area workflows for docs.json, MDX pages, API reference, snippets, and adding new pages
Automated Checks	mint broken-links, JSON validation one-liners
Deployment	Auto-deploy via Mintlify GitHub app
Cursor Cloud Instructions	Cloud-specific tips (no secrets, use computerUse, etc.)
Updating This Skill	How and when to add new runbook knowledge

Validation

• docs.json and openapi.json pass JSON syntax validation
• mint dev starts successfully and serves the site on the expected port
• mint broken-links runs and reports results (pre-existing broken links in the repo, not introduced here)

  

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 8ef891f9-fb0c-42b9-8b17-4294f6ea6905

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch wrldai-cloud-agent-skill-5d84

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}