---
name: agex-discover
description: Search the agex registry for rules, skills, MCP servers, hooks, and agents. Use when the user needs a new tool, config, or capability for their project. Automatically searches, evaluates, and installs via agex CLI.
---

# agex Discover

When the user needs a capability that isn't currently available in the project, search agex.dev for it.

## How to search

```bash
# Search by keyword
agex search "nextjs typescript rules"

# Search with filters (use --json for structured output)
agex search "mcp server postgres" --json
```

## How to evaluate

Before recommending an artifact, check:
1. **Vote count** — higher = more community trust
2. **Download count** — higher = actively used
3. **Description** — does it match what the user needs?
4. **Platform support** — does it work with the user's platform?
5. **Last updated** — is it actively maintained?

Use `agex info @user/slug` for full details including README and version history.

## How to install

```bash
# Add to agex.toml and sync to disk
agex add @user/artifact-slug

# For one-time use without installing
agex run @user/artifact-slug
```

## When to use this skill

- User says "I need a..." or "Is there a..."
- User is setting up a new project (`agex init` first)
- User wants to improve their agent setup
- A task would benefit from a skill/hook/MCP server that doesn't exist locally

## Important

- Always show the user what you found before installing
- Explain what each artifact does and why you recommend it
- Respect the user's agex.toml — don't install duplicates
- Suggest `agex run` for one-time use, `agex add` for permanent installation