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

# Installing Skills

> Find and install skills for your agent

## Finding Skills

The marketplace offers a wide range of skills to enhance your agent.

1. **Run the skill menu**:
   ```bash theme={null}
   lua marketplace skill
   ```
2. Select **"Browse & search for skills"**.
3. You can browse the full list or enter a search term.
   * Search matches against skill names, descriptions, and tags.
   * Search only ever returns skills you're allowed to see: public listings, plus any private listings from your own organization.
4. Select a skill to view details, including:
   * Description and category
   * Verified status
   * Author
   * Available versions and tools
   * Required environment variables

Non-interactively:

```bash theme={null}
lua marketplace skill search --query "CRM"
lua marketplace skill view --marketplace-id mkt_xyz --json
```

<Note>
  A private skill from another organization is indistinguishable from one that doesn't exist — search won't surface it, and looking it up by ID returns not-found. If a colleague shares a private skill's marketplace ID with you but you're not in the listing creator's organization, you'll see the same not-found.
</Note>

### Installing a Skill

Once you've found a skill:

1. Select **"Install"** (if viewing details) or choose **"Install a skill from the Marketplace"** from the main menu.
2. **Version Selection**:
   * The CLI will show available versions.
   * By default, the latest stable version is recommended.
3. **Configuration**:
   * If the skill requires environment variables (e.g., API keys), you will be prompted to enter them.
   * These values are securely stored in your agent's environment variables.
4. **Confirmation**: Review the installation details and confirm.

Non-interactively:

```bash theme={null}
lua marketplace skill install \
  --marketplace-id mkt_xyz \
  --version-id v1 \
  --env-vars "STRIPE_KEY=sk_xxx,WEBHOOK_SECRET=whsec_yyy" \
  --force
```

The skill is now installed on your agent and ready to use!

### Managing Installed Skills

You can manage your installed skills directly from the CLI:

* **List Installed** (`installed`): See all marketplace skills currently on your agent.
* **Update** (`update`): Upgrade a skill to a newer version.
  * The CLI checks for updates and lets you choose a new version.
  * You can also update environment variable configuration without changing versions.
* **Uninstall** (`uninstall`): Remove a skill and its configuration from your agent.

```bash theme={null}
lua marketplace skill installed --json
lua marketplace skill update --skill-name myCRMSkill --version-id v2
lua marketplace skill update --skill-name myCRMSkill --env-vars "STRIPE_KEY=sk_new"
lua marketplace skill uninstall --skill-name myCRMSkill --force
```

<Note>
  **Safety Check**: The CLI prevents you from installing a skill that is already present on your agent to avoid conflicts. Use `update` to modify existing installations.
</Note>

## Related

* [Marketplace Command reference](/cli/marketplace-command)
* [Publishing Skills](/marketplace/creator-guide)
* [Agent Templates](/marketplace/agent-templates)