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

# Marketplace Command

> Browse, install, and publish skills via the Lua skill marketplace

## Overview

`lua marketplace` is the CLI surface for the Lua skill marketplace. It has two role modes:

* **Creator** — publish and manage your own skills for others to install.
* **Installer** — search the marketplace and install skills into your agent.

Running `lua marketplace` with no arguments prompts you to pick a role.

```bash theme={null}
lua marketplace                 # Interactive: pick role
lua marketplace create          # Creator menu
lua marketplace install         # Installer menu
```

## Creator Mode

For publishing and managing your own marketplace listings.

### Actions

| Action      | What it does                                                              |
| ----------- | ------------------------------------------------------------------------- |
| `list`      | Create a marketplace listing for one of your skills.                      |
| `publish`   | Publish a specific version to the marketplace.                            |
| `update`    | Update listing metadata (display name, description).                      |
| `unlist`    | Hide the listing — no new installs, but existing installers keep working. |
| `unpublish` | Remove a specific version from the marketplace.                           |
| `view`      | View your listed skills.                                                  |

### Creator Options

| Option                   | Description                                                  |
| ------------------------ | ------------------------------------------------------------ |
| `--skill-name <name>`    | Skill name (for `list`).                                     |
| `--display-name <name>`  | Display name shown in the marketplace (for `list`/`update`). |
| `--marketplace-id <id>`  | Marketplace skill ID (returned after `list`).                |
| `--version-id <id>`      | Version ID (for `publish`/`unpublish`).                      |
| `--changelog <text>`     | Changelog text shown to installers (for `publish`).          |
| `--env-vars-json <json>` | JSON describing required env vars (for `publish`).           |
| `--force`                | Skip confirmation prompts.                                   |
| `--json`                 | Output as JSON (for `view`).                                 |

### Creator Examples

```bash theme={null}
# Interactive creator menu
lua marketplace create

# View my listed skills
lua marketplace create view
lua marketplace create view --json | jq

# Create a new marketplace listing
lua marketplace create list \
  --skill-name mySkill \
  --display-name "My Skill"

# Publish a specific version with a changelog
lua marketplace create publish \
  --marketplace-id mkt_xyz \
  --version-id v1 \
  --changelog "Adds support for European VAT"

# Update display name
lua marketplace create update \
  --marketplace-id mkt_xyz \
  --display-name "My Skill (Pro)"

# Unlist (existing installers unaffected)
lua marketplace create unlist --marketplace-id mkt_xyz --force

# Unpublish a specific version
lua marketplace create unpublish \
  --marketplace-id mkt_xyz \
  --version-id v1 \
  --force
```

## Installer Mode

For discovering and installing skills published by others.

### Actions

| Action      | What it does                                                               |
| ----------- | -------------------------------------------------------------------------- |
| `search`    | Search the marketplace by free-text query.                                 |
| `view`      | Show the detail page for a specific marketplace listing.                   |
| `install`   | Install a specific version of a skill into your agent.                     |
| `update`    | Update an installed skill (e.g. to a newer version or different env vars). |
| `uninstall` | Remove an installed skill.                                                 |
| `installed` | List skills you've installed.                                              |

### Installer Options

| Option                  | Description                                              |
| ----------------------- | -------------------------------------------------------- |
| `--marketplace-id <id>` | Marketplace skill ID.                                    |
| `--version-id <id>`     | Version ID to install or update to.                      |
| `--env-vars <pairs>`    | Comma-separated `key=value` pairs for required env vars. |
| `--query <text>`        | Search query.                                            |
| `--page <n>`            | Page number for paginated search.                        |
| `--limit <n>`           | Results per page.                                        |
| `--skill-name <name>`   | Installed-skill name (for `update`/`uninstall`).         |
| `--force`               | Skip confirmation prompts.                               |
| `--json`                | Output as JSON.                                          |

### Installer Examples

```bash theme={null}
# Interactive installer menu
lua marketplace install

# Search the marketplace
lua marketplace install search --query "CRM"
lua marketplace install search --query "CRM" --page 2 --limit 20

# View a specific listing
lua marketplace install view --marketplace-id mkt_xyz
lua marketplace install view --marketplace-id mkt_xyz --json

# Install a specific version
lua marketplace install install \
  --marketplace-id mkt_xyz \
  --version-id v1 \
  --force

# Install with env vars
lua marketplace install install \
  --marketplace-id mkt_xyz \
  --version-id v1 \
  --env-vars "STRIPE_KEY=sk_xxx,WEBHOOK_SECRET=whsec_yyy" \
  --force

# List installed skills
lua marketplace install installed
lua marketplace install installed --json

# Update an installed skill to a newer version
lua marketplace install update \
  --skill-name myCRMSkill \
  --version-id v2

# Update env vars on an installed skill
lua marketplace install update \
  --skill-name myCRMSkill \
  --env-vars "STRIPE_KEY=sk_new"

# Uninstall
lua marketplace install uninstall --skill-name myCRMSkill --force
```

## Env Var Formats

When a skill declares required env vars, two flag shapes are used:

| Flag              | Purpose                                         | Format                                                                              |
| ----------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------- |
| `--env-vars-json` | **Creator** — declare what your skill needs.    | JSON array of objects `[{"name":"STRIPE_KEY","required":true,"description":"..."}]` |
| `--env-vars`      | **Installer** — provide values when installing. | Comma-separated `key=value` pairs                                                   |

## Related

* [Marketplace Overview](/marketplace/overview)
* [Creator Guide](/marketplace/creator-guide)
* [Installer Guide](/marketplace/installer-guide)