How do I install the Btr List skill?

Run npx skillmds@latest add aibot88/btr-list in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Btr List safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Btr List?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Btr List free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Btr List?

aibot88 (@aibot88) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Btr List by aibot88 — Agent Skill

Name: Btr List
Rating: 4.2 (5 reviews)
Author: aibot88

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.

aibot88 Updated Sep 9, 2026 3 repo stars

File contents

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

---name: btr-listdescription: 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.--- # 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 ```bash # List all domains btr list # List topics in a specific domain btr list <domain> # Show full details btr list --verbose ``` ## Instructions 1. Run the appropriate list command based on user request 2. Present the tree structure in a readable format 3. Offer to drill down into specific domains 4. 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 ```bash btr list ``` Shows all domains with topic counts. ### List Topics in a Domain ```bash btr list auth ``` Shows all topics within the specified domain with their metadata. ### Verbose Listing ```bash btr list --verbose ``` Shows full details including: - Topic descriptions - Tags - Creation date - Last accessed date - Retrieval count ### JSON Output ```bash btr list --format json ``` Outputs structured JSON for programmatic use. ## Example Workflows ### Explore Before Querying 1. List all domains to see what's available: ```bash btr list ``` 2. Drill into a relevant domain: ```bash btr list auth ``` 3. Query for specific content: ```bash btr query "JWT refresh token flow" --domain auth ``` ### Audit Context Coverage Use verbose listing to identify gaps: ```bash btr list --verbose --format json | jq '.domains | map({name: .name, count: .topics | length})' ``` ### Find Recently Added Contexts ```bash 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

Frequently asked questions