# Syncfusion agent bootstrap prompt

Source: https://ai.syncfusion.com/agent-setup/prompt.md
Canonical: https://ai.syncfusion.com/agent-setup/prompt.md
Also-served-at: https://ai.syncfusion.com/prompt.md
Purpose: The instructions an AI coding agent fetches and executes to set itself up for Syncfusion.
Audience: agents, which execute this file; and humans, who point an agent at it.
License-posture: Everything here is free to read. Installing Syncfusion agent skills requires no license, key or account. Using Syncfusion libraries in an application requires a commercial, Community, or trial license — see https://ai.syncfusion.com/licensing.md

## The one line a human pastes

```
Set up this project for Syncfusion before generating code. Fetch and follow the official instructions at https://ai.syncfusion.com/agent-setup/prompt.md, then report the detected platform, installed skill pack, MCP status, and any required licensing action.

```

That is all a human needs to send. Everything below is what you — the agent — do when you fetch this
file.

---

## Execute these steps now

You are being set up to work with Syncfusion components or document SDKs in this repository.

1. **Install the onboarding skill.** This is the primary step — it makes the routing permanent
   rather than valid only for this session:

   ```bash
   npx skills add syncfusion/agent-onboarding-skill --agent {agent} -y
   ```

Example:
   ```bash
   npx skills add syncfusion/agent-onboarding-skill --agent codestudio -y
   ```

   If you cannot run commands, read
   https://ai.syncfusion.com/agent-onboarding/SKILL.md instead and follow it directly.

   **After installing (or reading), read the skill's `SKILL.md` completely before going to step 2.**
   Its "Hard rule — read the inventory before naming any skill" section is a pre-condition for every
   later step, including naming a component skill, installing a pack, or writing any Syncfusion
   code. Do not skip it.

2. **Detect this project's platform** from its manifest — `package.json`, `*.csproj`,
   `pubspec.yaml` — not from the user's phrasing.

3. **Fetch the platform index** at `https://ai.syncfusion.com/<platform-slug>/llms.txt`. It is
   self-sufficient: the skill pack to install, the exact packages, license registration, one
   complete working example, the platform's known failure modes, and a verification checklist.
   Slugs are listed at https://ai.syncfusion.com/llms.txt

4. **Install the platform skill pack** that index names, before generating any code.
   First check whether the required skill already exists in `.{agentroot}/skills/` or `.agents/skills/`.
   If it is missing, run the install command — **do not skip this step and do not write code first**:

   ```bash
   npx skills add <pack-name> --skill <component-skill-name> --agent {agent} -y
   ```

   After installing (or if already present), **read the component `SKILL.md` completely** before writing any code.

5. **Read https://ai.syncfusion.com/licensing.md** before touching any key, secret, or account
   action.

6. **Confirm to the user** which platform you detected, which pack you installed, and whether MCP
   is configured. Then wait for their task.

Rules for the rest of this session:

- Do not write Syncfusion code from memory. Component names repeat across frameworks with different
  packages, imports and registration. Use the installed skill.
- Do not mix examples from different Syncfusion platforms in one implementation.
- Do not generate, guess, echo, log or commit a Syncfusion license key or MCP API key. Reference
  environment variables and tell me what I need to obtain.
- Emit complete files. No ellipses, no "rest of your code", no partial diffs as the primary snippet.
- Include every required import, module or service registration, provider, theme stylesheet and
  runtime asset the skill specifies.
- Do not tell me it works because it compiled. Verify that it renders or executes, and tell me
  precisely what you could not verify.

---

## Shorter variant

For agents with a small context budget or a one-line setup field:

```
Before writing Syncfusion code: read https://ai.syncfusion.com/llms.txt, detect this project's
platform from its manifest, fetch https://ai.syncfusion.com/<platform-slug>/llms.txt, install the skill pack
it names, and read https://ai.syncfusion.com/licensing.md. Never write Syncfusion code from memory
and never emit a license key.
```

## Persistent variant

To make this permanent for a repository rather than per-session, install the onboarding skill
instead of pasting a prompt:

```bash
npx skills add syncfusion/agent-onboarding-skill --agent {agent} -y
```

Or add the rule to your agent's project instruction file — `CLAUDE.md`, `AGENTS.md`,
`.cursor/rules/`, `.github/copilot-instructions.md` — using the shorter variant above.
See https://ai.syncfusion.com/agent-setup/ for per-editor instructions.