# Catalog Browse

> Browse the community catalog for new skills, agent templates, and org templates. Discover what is available and recommend useful items to the user.

- Skill: `grandamenium/catalog-browse` (Agent Skill)
- Install (CLI): `npx skillmds@latest add grandamenium/catalog-browse`
- Raw SKILL.md: https://api.skillmd.com/api/skills/grandamenium/catalog-browse/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: grandamenium (https://skillmd.com/u/grandamenium)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/grandamenium/catalog-browse

---


# Catalog Browse

Discover new skills, agent templates, and org templates from the community catalog. Recommend useful items to the user and install with approval.

## When to Run

- Weekly cron (configured via `cortextos bus add-cron`)
- When user asks about available skills
- When an agent needs a capability that might exist in the catalog

## Workflow

### Step 1: Browse the catalog

```bash
# Browse all items
RESULT=$(cortextos bus browse-catalog)

# Filter by type
RESULT=$(cortextos bus browse-catalog --type skill)

# Filter by tag
RESULT=$(cortextos bus browse-catalog --type skill --tag email)

# Search by keyword
RESULT=$(cortextos bus browse-catalog --search "content")
```

### Step 2: Review results

The output includes:
- Item name, description, author
- Type (skill, agent, org)
- Tags and dependencies
- Whether already installed

### Step 3: Recommend to user

For items that look useful:
- Explain what the skill does
- Which agent would benefit
- Send recommendation via Telegram

### Step 4: Install (with approval)

```bash
# Dry run first
cortextos bus install-community-item <item-name> --dry-run

# Install after user approves
cortextos bus install-community-item <item-name>
```

## Config

Requires `ecosystem.catalog_browse.enabled: true` in config.json.

## Notes

- The catalog is fetched during upstream sync (`cortextos bus check-upstream`) and lives at `community/catalog.json` in the framework root
- Items are reviewed by the community before being listed
- Always dry-run before installing