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

# Overview

> Browse, install, and manage agent skills and context bundles from the BRV Hub community marketplace

[BRV Hub](https://hub.byterover.dev/) is a community marketplace for pre-built **agent skills** and **context bundles**. Browse and install content from the official registry without authentication, using the interactive TUI (`/hub`) or the standalone CLI (`brv hub`).

## Content Types

<CardGroup cols={2}>
  <Card title="Agent Skills" icon="zap">
    Reusable workflow instructions installed into agent-specific skill directories. Require selecting a target agent during installation.

    Installed file(s): `SKILL.md`
  </Card>

  <Card title="Context Bundles" icon="package">
    Curated knowledge packs installed directly to your project's context tree (`.brv/context-tree/`). No agent selection needed.

    Installed files vary by bundle (e.g., `context.md`)
  </Card>
</CardGroup>

## Quick Start

<Steps>
  <Step title="Browse available content">
    ```bash theme={null}
    brv hub list
    ```
  </Step>

  <Step title="Install a skill">
    ```bash theme={null}
    brv hub install byterover-review --agent "Claude Code"
    ```
  </Step>

  <Step title="Install a bundle">
    ```bash theme={null}
    brv hub install typescript-kickstart
    ```
  </Step>
</Steps>

## Interactive Browser

In the ByteRover TUI, type `/hub` to open the interactive hub browser. This provides a searchable, scrollable interface for browsing, previewing, and installing entries.

### Browsing Flow

1. **List view** — All entries displayed in a searchable list. Type to filter by ID, name, description, tags, or author.
2. **Detail view** — Select an entry to see its full description, use cases, metadata (tags, category, author, license), and file list.
3. **Agent selection** — For agent skills, choose a target agent (Claude Code, Cursor, Codex, or GitHub Copilot).
4. **Install** — The skill or bundle downloads and installs to the appropriate directory.

{/* [Screenshot: hub-agent-selection.png] - TUI agent selection step for skill installation */}

### Keybinds

| Key     | Action                     |
| ------- | -------------------------- |
| `Enter` | Install the selected entry |
| `o`     | Open entry in browser      |
| `Esc`   | Go back / cancel           |

## CLI Commands

### `brv hub list`

List all available skills and bundles from configured registries.

```bash theme={null}
brv hub list [OPTIONS]
```

| Flag                    | Description                     | Default |
| ----------------------- | ------------------------------- | ------- |
| `-f, --format <format>` | Output format: `text` or `json` | `text`  |

The text output displays a table with columns: **ID**, **Type**, **Version**, **Description**, **Category**, and **Registry** (shown when multiple registries are configured).

<Tip>
  Use `--format json` for machine-readable output in scripts and CI pipelines.
</Tip>

### `brv hub install <id>`

Install a skill or bundle by its entry ID.

```bash theme={null}
brv hub install <id> [OPTIONS]
```

| Argument / Flag         | Description                                                   | Required                |
| ----------------------- | ------------------------------------------------------------- | ----------------------- |
| `id`                    | Entry ID to install                                           | Yes                     |
| `-a, --agent <agent>`   | Target agent for skill install                                | For skills              |
| `-r, --registry <name>` | Registry to install from                                      | No                      |
| `-s, --scope <scope>`   | Install scope: `global` (home dir) or `project` (current dir) | No (default: `project`) |
| `-f, --format <format>` | Output format: `text` or `json`                               | No                      |

**Supported agents:** Any agent with a Skill connector — including Claude Code, Cursor, Codex, Github Copilot, Windsurf, Gemini CLI, Kilo Code, Roo Code, Amp, Kiro, Junie, and more. See [Agent Connectors](/connectors/overview) for the full list.

```bash theme={null}
# Install a skill for Claude Code
brv hub install byterover-review --agent "Claude Code"

# Install a skill for Cursor
brv hub install byterover-plan --agent Cursor

# Install a bundle (no agent needed)
brv hub install typescript-kickstart

# Install from a specific registry
brv hub install byterover-review --registry myco --agent "Claude Code"
```

<Tip>
  Agent skills require the `--agent` flag. If omitted, the CLI returns an error. Context bundles install directly without needing an agent.
</Tip>

## Agent Install Paths

When you install an agent skill, files are written to an agent-specific directory:

| Agent          | Install Path                           | Scope        |
| -------------- | -------------------------------------- | ------------ |
| Claude Code    | `.claude/skills/byterover/<skill-id>/` | Project      |
| Cursor         | `.cursor/skills/byterover/<skill-id>/` | Project      |
| Codex          | `.agents/skills/byterover/<skill-id>/` | Global (`~`) |
| GitHub Copilot | `.github/skills/byterover/<skill-id>/` | Project      |

* **Project scope** — Files are written relative to your project root directory.
* **Global scope** — Files are written relative to your home directory (`~`).

Each installed skill includes a `SKILL.md` file containing the full skill definition with workflow phases and instructions.

Context bundles install to `.brv/context-tree/` in your project directory.

## Available Skills

The official registry includes 10 agent skills covering the full development lifecycle:

| ID                    | Name                   | Category     | Description                                                                                               |
| --------------------- | ---------------------- | ------------ | --------------------------------------------------------------------------------------------------------- |
| `byterover-review`    | Code Review            | code-quality | Review code changes against stored conventions, patterns, architecture decisions, and security standards  |
| `byterover-plan`      | Context-Aware Planning | productivity | Create structured implementation plans informed by existing knowledge using goal-backward analysis        |
| `byterover-explore`   | Codebase Exploration   | analysis     | Systematically explore a codebase and curate findings into ByteRover's context tree                       |
| `byterover-audit`     | Knowledge Audit        | analysis     | Audit knowledge freshness and coverage, identify stale entries and gaps, and provide remediation commands |
| `byterover-milestone` | Milestone Planning     | productivity | Define project milestones with goals, scoped requirements, phased roadmaps, and implementation decisions  |
| `byterover-execute`   | Phase Execution        | productivity | Execute a phase plan task by task with verification, atomic commits, and progress tracking                |
| `byterover-onboard`   | Project Onboarding     | learning     | Interactive knowledge-driven project onboarding with structured overview and gap identification           |
| `byterover-progress`  | Project Progress       | productivity | Check project progress, resume paused work, and route to the next action intelligently                    |
| `byterover-ship`      | Ship & Handoff         | productivity | Complete milestones with retrospective and archival, or pause work with resumable handoff context         |
| `byterover-debug`     | Systematic Debugging   | debugging    | Investigate bugs using scientific method with persistent knowledge and hypothesis-driven analysis         |

## Available Bundles

Context bundles provide curated knowledge packs for specific domains:

| ID                     | Name                 | Category     | Description                                                              |
| ---------------------- | -------------------- | ------------ | ------------------------------------------------------------------------ |
| `typescript-kickstart` | TypeScript Kickstart | productivity | Context bundle for bootstrapping TypeScript projects with best practices |

<Tip>
  Run `brv hub list` or browse [hub.byterover.dev](https://hub.byterover.dev) for the latest catalog. New skills and bundles are added regularly.
</Tip>

## Contributing

BRV Hub is open to community contributions. You can submit your own agent skills or context bundles to the marketplace by contributing to the [BRV Hub repository](https://github.com/campfirein/brv-hub).

1. **Fork** the repository
2. **Add** your skill in `skills/<id>/` or bundle in `bundles/<id>/` with the required files (`manifest.json`, `README.md`, and a content file)
3. **Validate** locally with `npm run validate`
4. **Open a Pull Request** — automated checks run on every PR, followed by a maintainer review

<Info>
  See the full [contributing guide](https://github.com/campfirein/brv-hub/blob/main/docs/contributing.md) and [manifest spec](https://github.com/campfirein/brv-hub/blob/main/docs/manifest-spec.md) in the repository for directory structure, naming rules, required fields, and examples.
</Info>

## Next Steps

<CardGroup cols={3}>
  <Card title="Custom Registries" icon="lock" href="/brv-hub/registries">
    Host and distribute custom skills and bundles with custom registries
  </Card>

  <Card title="Agent Connectors" icon="plug" href="/connectors/overview">
    Learn about the agent connector system and supported agents
  </Card>

  <Card title="Contribute" icon="git-pull-request" href="https://github.com/campfirein/brv-hub">
    Submit your own skills and bundles to the community marketplace
  </Card>
</CardGroup>