Claude-skill-registry btr-list

Browse LOCAL BTR context tree (NOT ByteRover/brv). Use when the user asks "what contexts do we have", "show all domains", "list topics in auth", "list BTR contexts", "show BTR domains", "browse BTR", or wants to explore available knowledge.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/btr-list" ~/.claude/skills/majiayu000-claude-skill-registry-btr-list && rm -rf "$T"

manifest: skills/data/btr-list/SKILL.md

BTR List

⚠️ CRITICAL: BTR ≠ ByteRover

This skill uses

btr

(local context tree), NOT
brv
(ByteRover CLI).

Command Tool Syntax

✓ CORRECT

btr

btr query "search term"

btr list

btr stats

✗ WRONG

brv

Different tool, different syntax, requires auth

PREFER MCP tools when available:

```
mcp__btr__query_context
```
- For searching
```
mcp__btr__list_contexts
```
- For browsing
```
mcp__btr__get_stats
```
- For statistics

Only use Bash

btr

commands if MCP tools are unavailable.

Browse and visualize the context tree structure.

Quick Start

# List all domains
btr list

# List topics in a specific domain
btr list <domain>

# Show full details
btr list --verbose

Instructions

Run the appropriate list command based on user request
Present the tree structure in a readable format
Offer to drill down into specific domains
Suggest relevant queries based on what's available

Output Format

BTR Context Tree
=======================
auth (3 topics)
  ├── jwt-validation
  ├── oauth-google
  └── session-management

api (2 topics)
  ├── rate-limiting
  └── error-responses

database (1 topic)
  └── connection-pooling

Total: 6 contexts across 3 domains

Command Variations

List All Domains

btr list

Shows all domains with topic counts.

List Topics in a Domain

btr list auth

Shows all topics within the specified domain with their metadata.

Verbose Listing

btr list --verbose

Shows full details including:

Topic descriptions
Tags
Creation date
Last accessed date
Retrieval count

JSON Output

btr list --format json

Outputs structured JSON for programmatic use.

Example Workflows

Explore Before Querying

List all domains to see what's available:
```
btr list
```
Drill into a relevant domain:
```
btr list auth
```

Query for specific content:

btr query "JWT refresh token flow" --domain auth

Audit Context Coverage

Use verbose listing to identify gaps:

btr list --verbose --format json | jq '.domains | map({name: .name, count: .topics | length})'

Find Recently Added Contexts

btr list --sort created --limit 10

Tips

Use
```
btr list
```
regularly to stay aware of available context
When a domain has many topics, use
```
--filter
```
to narrow down
Combine with
```
btr stats
```
to see which contexts are most valuable