/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.mdContext 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
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
- List view — All entries displayed in a searchable list. Type to filter by ID, name, description, tags, or author.
- Detail view — Select an entry to see its full description, use cases, metadata (tags, category, author, license), and file list.
- Agent selection — For agent skills, choose a target agent (Claude Code, Cursor, Codex, or GitHub Copilot).
- 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.
| Flag | Description | Default |
|---|---|---|
-f, --format <format> | Output format: text or json | text |
brv hub install <id>
Install a skill or bundle by its entry ID.
| 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 |
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 (
~).
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 |
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.- Fork the repository
- Add your skill in
skills/<id>/or bundle inbundles/<id>/with the required files (manifest.json,README.md, and a content file) - Validate locally with
npm run validate - Open a Pull Request — automated checks run on every PR, followed by a maintainer review
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