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

# Discover & Install Skills from the Marketplace

> Search ClawHub-compatible registries, switch China/international mirrors, and install skills with one click—enabled for chat immediately.

# Skill Discovery & Registry Mirror

## What you get

* **Discover tab** under **Settings → Skills**: search prebuilt and community skills, install with one click.
* **Registry mirror panel**: pick **International (clawhub.ai)**, **China (iFlytek SkillHub)**, or a **custom URL**. Settings are probed before save—unreachable registries are rejected with a clear toast.
* **Install → enabled**: successful installs show *Installed and enabled* and add the skill to your catalog—no need to edit agent allowlists for the default case.

## Steps

<Steps>
  <Step title="Open Discover">
    Go to **Settings → Skills → Discover**.
  </Step>

  <Step title="Choose your registry mirror (optional)">
    At the top of Discover, open **Skill market mirror**. Select international or China mirror, or enter a custom ClawHub-compatible base URL. Save only succeeds when the registry responds with valid JSON.
  </Step>

  <Step title="Search and install">
    Enter keywords in the search box, press Enter, then click **Install** on a skill card. Wait for the success toast.
  </Step>

  <Step title="Use in chat">
    Start or continue a conversation. Enabled skills are available through progressive skill loading—no extra toggle unless you use an explicit per-agent skill allowlist.
  </Step>

  <Step title="Enable built-in market tools (optional)">
    Under **Settings → Agent → Capabilities → Built-in tools**, `skill_market` and `skill_manage` are **off by default**. Turn them on when you need external marketplace search or skill management—saves Turn1 tokens. `/learn` automatically enables manage for that turn.
  </Step>
</Steps>

<Note>
  **Explicit allowlist**: If an agent uses a non-empty skill allowlist, Discover install automatically adds the new skill to that allowlist so it is available in chat on the next message. Set `mount_to_agent: false` on the install API to skip catalog enable and allowlist adoption.
</Note>

## Configure skill environment variables

Skills that call external services declare their secrets via `primary_env` / `requires.env` (e.g. `GOOGLE_API_KEY`). To fill them in:

1. Open **Settings → Skills**, click a skill to open its **detail sheet**.
2. Fill in the **Environment variables** section and save.

Your config is stored in a central **skill configuration** — not inside the SKILL.md file. On every agent build, Myrm **automatically reconciles** the saved config against the currently installed skills:

* **Installed skill** → its env vars are injected at runtime.
* **Uninstalled / removed skill** → its env vars are cleaned up automatically — no stale or orphaned secrets.
* **Renamed skill** → the config follows the new runtime name automatically.

Secrets are injected as environment variables and never appear in chat context.

## Related

* [Skill Creation](/docs/tutorials/skill-creation) — turn a conversation into a reusable skill
* [Skill Evolution](/docs/core-concepts/skill-evolution) — auto-improve skills after installation