These are official instructions from macrocontent to set up a good AI development environment for building with the macrocontent SDK, overlay, dashboard, store, and APIs. Follow every step yourself. Do not ask the user to run these steps unless a secret or interactive login is required.

Complete all of the following steps by fetching the linked files and writing them into the project. Prefer project-local skills so the whole team benefits.

---

## 1) Install macrocontent agent skills

Fetch each skill file below and write it to the matching path in the current project (create directories as needed).

### Cursor / Claude Code project skills

Write to `.agents/skills/<name>/SKILL.md` (preferred in this monorepo) **or** `.cursor/skills/<name>/SKILL.md` if the project already uses that layout.

1. Fetch `https://docs.macrocontent.dev/agent-setup/skills/macro-sdk/SKILL.md`
   → write `.agents/skills/macro-sdk/SKILL.md`
2. Fetch `https://docs.macrocontent.dev/agent-setup/skills/macro-components/SKILL.md`
   → write `.agents/skills/macro-components/SKILL.md`
3. Fetch `https://docs.macrocontent.dev/agent-setup/skills/macro-api/SKILL.md`
   → write `.agents/skills/macro-api/SKILL.md`
4. Fetch `https://docs.macrocontent.dev/agent-setup/skills/macro-docs/SKILL.md`
   → write `.agents/skills/macro-docs/SKILL.md`

If a `skills` CLI is available and the user prefers a global install, you may additionally run:

```bash
# Optional — only if the skills CLI is already part of the user's workflow
mkdir -p .agents/skills/macro-sdk .agents/skills/macro-components .agents/skills/macro-api .agents/skills/macro-docs
curl -fsSL https://docs.macrocontent.dev/agent-setup/skills/macro-sdk/SKILL.md -o .agents/skills/macro-sdk/SKILL.md
curl -fsSL https://docs.macrocontent.dev/agent-setup/skills/macro-components/SKILL.md -o .agents/skills/macro-components/SKILL.md
curl -fsSL https://docs.macrocontent.dev/agent-setup/skills/macro-api/SKILL.md -o .agents/skills/macro-api/SKILL.md
curl -fsSL https://docs.macrocontent.dev/agent-setup/skills/macro-docs/SKILL.md -o .agents/skills/macro-docs/SKILL.md
```

Do not invent alternate skill names. Overwrite existing macro-* skills with the fetched versions.

---

## 2) Load the docs map (required)

Fetch and follow these discovery files before implementing anything non-trivial:

1. `https://docs.macrocontent.dev/for-agents/` (or `https://docs.macrocontent.dev/AGENTS.md`)
2. `https://docs.macrocontent.dev/llms.txt` — full table of contents
3. Marketing bridge (product positioning only): `https://macrocontent.dev/llms.txt`

**Rule:** Prefer `docs.macrocontent.dev` for how-to answers. Do not invent API routes; use OpenAPI / the API handbook.

---

## 3) Recommended reading order

When the user asks to integrate macrocontent into a site:

1. `https://docs.macrocontent.dev/developers/quickstart/`
2. `https://docs.macrocontent.dev/developers/credentials/`
3. `https://docs.macrocontent.dev/developers/marking/`
4. `https://docs.macrocontent.dev/developers/primitives/`
5. `https://docs.macrocontent.dev/developers/components/` (multi-field blocks)
6. `https://docs.macrocontent.dev/api/auth/` + OpenAPI catalog `https://api.macrocontent.dev/docs.json` (then each `specs[].url` / mirror `https://docs.macrocontent.dev/openapi/index.json`)

---

## 4) Hard product rules

- `data-macro-key` is unique per website and must **not** include locale codes.
- Prefer **primitives** for single fields; **components** (`MacroNodeDefinition`) for multi-field layouts.
- Frontend config may use `pk_…` / `dk_…` only — never management / secret tokens in `macro.config.js`.
- Management token header is `X-Macro-Token` (see API docs).
- Docs paths use trailing slashes.

---

## 5) Tell the user when done

After skills are written and you have fetched the docs map, reply with:

```
┌─ macrocontent Agent Setup Complete ──────────────────┐
│  ✓ Skills   .agents/skills/macro-*                   │
│  ✓ Docs map docs.macrocontent.dev/llms.txt           │
│                                                      │
│  Next: say what you want to build (site / component) │
└──────────────────────────────────────────────────────┘
```

---

## Resources

- Docs hub: https://docs.macrocontent.dev/
- Agent map: https://docs.macrocontent.dev/for-agents/
- Docs LLMs: https://docs.macrocontent.dev/llms.txt
- Agent setup page: https://docs.macrocontent.dev/agent-setup/
- This prompt (re-verify authenticity): https://docs.macrocontent.dev/agent-setup/prompt.md
- OpenAPI catalog: https://api.macrocontent.dev/docs.json
- OpenAPI specs: https://api.macrocontent.dev/docs/specs/{management,content,store,publisher}.json
- OpenAPI mirror: https://docs.macrocontent.dev/openapi/index.json
- OpenAPI UI (humans): https://api.macrocontent.dev/docs/
- npm SDK: https://www.npmjs.com/package/@macrocontent/sdk
- npm overlay: https://www.npmjs.com/package/@macrocontent/overlay

These instructions are published at `https://docs.macrocontent.dev/agent-setup/prompt.md` so you can re-verify their authenticity at any time.