> ## Documentation Index
> Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> Follow this path once per machine or project. Estimated time: 15–20 minutes.

Follow this path once per machine or project. Estimated time: **15–20 minutes**.

For **why** we recommend installing **skills + MCP** alongside the CLI—and how the four Orderly plugin skills fit the SDK workflow—read [**Skills-first workflow**](/build-on-omnichain/builder-marketplace/skills-first) first.

## Requirements

* **Node.js** v20.19.0 or newer.

## 1. Install the devkit CLI

Global install (recommended):

```bash theme={null}
pnpm add -g @orderly.network/devkit
```

One-off without global install:

```bash theme={null}
pnpm dlx @orderly.network/devkit --help
```

The executable name is **`orderly-devkit`** (not `orderly`).

Verify:

```bash theme={null}
orderly-devkit --help
```

## 2. Install agent skills (recommended for AI-assisted development)

These skills ship from **`OrderlyNetwork/orderly-skills`** and teach your agent **orderly-plugin-create**, **orderly-plugin-write**, **orderly-plugin-add**, and **orderly-plugin-submit**—aligned with `orderly-devkit` and this handbook’s tutorials.

```bash theme={null}
orderly-devkit skills install
orderly-devkit skills install --list    # list only
orderly-devkit skills install --dry-run # preview
```

Use **`--agent cursor`** (or your client) when you need skills installed for a specific agent—see [CLI reference: skills](/build-on-omnichain/builder-marketplace/cli-reference#skills-install).

**Without an AI agent**, this step is optional; you can rely on the CLI and docs alone. With an agent, **treat this as part of the default stack** together with the MCP below.

## 3. Install Orderly SDK Docs MCP (recommended)

Enables AI assistants to search SDK docs, resolve component and type metadata, and fetch workflows. Use either:

```bash theme={null}
orderly-devkit mcp install
```

or the sdk-docs binary directly:

```bash theme={null}
pnpm dlx @orderly.network/sdk-docs orderly-sdk-docs-mcp install --client all --scope user
```

See [Orderly SDK Docs MCP](/build-on-omnichain/builder-marketplace/mcp-sdk-docs) for tools and the `install` subcommand.

After `orderly-devkit create plugin` or a successful `submit`, the devkit may print hints if the MCP server is not detected (see the published **`@orderly.network/devkit`** sources for MCP detection behavior).

## 4. Create a plugin from the template

Interactive (prompts for name, plugin id, interceptor target, output directory):

```bash theme={null}
orderly-devkit create plugin
```

Non-interactive example (all required options for `--no-interactive`):

```bash theme={null}
orderly-devkit create plugin --no-interactive \
  --name MyPlugin \
  --id my-plugin \
  --interceptor Trading.OrderEntry.SubmitSection \
  --target ./MyPlugin \
  --skip-install
```

Details: [CLI reference: create plugin](/build-on-omnichain/builder-marketplace/cli-reference#create-plugin).

The template repository is **`OrderlyNetwork/orderly-plugin-template`**. A `.orderly-manifest.json` may be generated in the output folder.

## 5. Build and run locally

```bash theme={null}
cd ./YourPluginName
# Per template; often:
pnpm install   # or npm install
pnpm run dev   # or npm run dev
```

Wire the plugin into a host app using [`OrderlyAppProvider` plugins](/build-on-omnichain/builder-marketplace/integrate-host).

## Next steps

| Goal                                 | Document                                                                                |
| ------------------------------------ | --------------------------------------------------------------------------------------- |
| Skills + MCP mental model            | [**Skills-first workflow**](/build-on-omnichain/builder-marketplace/skills-first)       |
| First visible UI change              | [Tutorial: First plugin](/build-on-omnichain/builder-marketplace/first-plugin)          |
| Add plugin to a DEX app              | [Tutorial: Integrate into host](/build-on-omnichain/builder-marketplace/integrate-host) |
| Marketplace login and submit         | [Tutorial: Marketplace](/build-on-omnichain/builder-marketplace/marketplace-submission) |
| When to use widget vs page vs layout | [How-to: Plugin types](/build-on-omnichain/builder-marketplace/plugin-types)            |