Claude-skill-registry btca-bknd-repo-learn

Use btca (Better Context App) to efficiently query and learn from the bknd backend framework. Use when working with bknd for (1) Understanding data module and schema definitions, (2) Implementing authentication and authorization, (3) Setting up media file handling, (4) Configuring adapters (Node, Cloudflare, etc.), (5) Learning from bknd source code and examples, (6) Debugging bknd-specific issues

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/btca-bknd-repo-learn" ~/.claude/skills/majiayu000-claude-skill-registry-btca-bknd-repo-learn && rm -rf "$T"

manifest: skills/data/btca-bknd-repo-learn/SKILL.md

Query bknd with btca

btca is a CLI tool for asking questions about git repos. It clones repositories, indexes them, and answers queries using AI.

Quick Setup

# Install btca and OpenCode
bun add -g btca opencode-ai

# Configure model (Big Pickle: free, fast, surprisingly good)
btca config model --provider opencode --model big-pickle

# Add bknd as a resource
btca config resources add --name bknd --type git --url https://github.com/bknd-io/bknd --branch main

Or create

btca.config.jsonc

{
  "$schema": "https://btca.dev/btca.schema.json",
  "model": "big-pickle",
  "provider": "opencode",
  "providerTimeoutMs": 300000,
  "resources": [
    {
      "type": "git",
      "name": "bknd",
      "url": "https://github.com/bknd-io/bknd",
      "branch": "main"
    }
  ]
}

Core Commands

Ask a question

btca ask --resource bknd --question "How do I define a schema?"

Interactive chat

btca chat --resource bknd

Launch TUI

btca

Reference Files

For detailed information, see:

setup.md - Full installation, configuration options, resource management, troubleshooting setup issues
query-patterns.md - Specific query patterns for data, auth, media, adapters, and framework integration
advanced.md - Multi-resource queries, interactive workflows, performance optimization, debugging

Query Best Practices

Be specific - "How do I define a schema with a one-to-many relation?" vs "How do I use the data module?"
Provide context - "I'm using Cloudflare Workers. How do I configure the database adapter?"
Ask for examples - "Show me a complete example of setting up password authentication"
Reference specific files - "How does src/App.ts initialize the modules?"

Learning Workflow

Explore high-level: Ask about overall architecture and main modules
Module deep-dive: Use
```
btca chat --resource bknd
```
to focus on one module
Implementation details: Ask to see specific feature implementations
Examples & patterns: Query the examples directory for best practices

Resources

btca docs: https://btca.dev
bknd docs: https://docs.bknd.io
bknd repo: https://github.com/bknd-io/bknd