Overview

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

BRV Hub 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

• Agent Skills — Reusable workflow instructions installed into agent-specific skill directories. Require selecting a target agent during installation.

  Installed file(s): SKILL.md

• Context Bundles — 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)

Quick Start

Step 1: Browse available content

brv hub list

Step 2: Install a skill

brv hub install byterover-review --agent "Claude Code"

Step 3: Install a bundle

brv hub install typescript-kickstart

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.

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.

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.

brv hub install <id>

Install a skill or bundle by its entry ID.

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 for the full list.

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

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 for the latest catalog. New skills and bundles are added regularly.

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.

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 and manifest spec in the repository for directory structure, naming rules, required fields, and examples.

Next Steps

• Custom Registries — Host and distribute custom skills and bundles with custom registries

• Agent Connectors — Learn about the agent connector system and supported agents

• Contribute — Submit your own skills and bundles to the community marketplace