Skip to main content

​
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. 
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

ActionWhat it does
listCreate a marketplace listing for one of your skills.
publishPublish a specific version to the marketplace.
updateUpdate listing metadata (display name, description).
unlistHide the listing — no new installs, but existing installers keep working.
unpublishRemove a specific version from the marketplace.
viewView your listed skills.

​
Creator Options

OptionDescription
--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).
--forceSkip confirmation prompts.
--jsonOutput as JSON (for view).

​
Creator Examples

# 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

ActionWhat it does
searchSearch the marketplace by free-text query.
viewShow the detail page for a specific marketplace listing.
installInstall a specific version of a skill into your agent.
updateUpdate an installed skill (e.g. to a newer version or different env vars).
uninstallRemove an installed skill.
installedList skills you’ve installed.

​
Installer Options

OptionDescription
--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).
--forceSkip confirmation prompts.
--jsonOutput as JSON.

​
Installer Examples

# 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:
FlagPurposeFormat
--env-vars-jsonCreator — declare what your skill needs.JSON array of objects [{"name":"STRIPE_KEY","required":true,"description":"..."}]
--env-varsInstaller — provide values when installing.Comma-separated key=value pairs