btca-cli — скилл для Claude Code: установка и работа
Управляет btca для поиска по добавленным исходникам, каталогам и npm-пакетам. Нужен, когда агенту требуется ответ с опорой на выбранные ресурсы.
npx skills add davis7dotsh/better-context --skill btca-cli -a claude-codeЧто делает btca-cli
Скилл работает с CLI btca: добавляет git-репозитории, локальные каталоги и npm-пакеты в контекст для поиска. Затем можно задавать вопросы по одному ресурсу или нескольким, получая ответы, привязанные к их содержимому.
Ресурсы сохраняются в конфигурации проекта btca.config.jsonc или в глобальном файле ~/.config/btca/btca.config.jsonc. Конфигурация проекта имеет приоритет и задаёт провайдер, модель и набор ресурсов. Для разовых исследований btca ask принимает ресурс напрямую, не сохраняя его в конфиге.
Перед вопросами подключите провайдера через btca connect. Пока провайдер не подключён, запросы не выполнятся, поэтому это стоит проверить до настройки набора ресурсов.
Какие задачи решает
- добавить git-репозиторий в поисковый контекст
- подключить локальный каталог с документацией
- задать вопрос по нескольким ресурсам
- проверить имена настроенных ресурсов
- исследовать npm-пакет без сохранения в конфиге
Примеры запросов агенту
- Используй btca: добавь npm-пакет
npm:@types/[email protected]как ресурсnode-types. - Используй btca и задай вопрос по ресурсам
reactиtypescript. - Используй btca: проверь настроенные ресурсы командой
btca resources.
Как установить btca-cli
1Через Skills CLI (Vercel)
npx skills add davis7dotsh/better-context --skill btca-cli -a claude-code2Вручную: положить файлы
~/.claude/skills/btca-cli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/btca-cli/
1Через Skills CLI (Vercel)
npx skills add davis7dotsh/better-context --skill btca-cli -a codex2Вручную: положить файлы
.agents/skills/btca-cli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add davis7dotsh/better-context --skill btca-cli -a cursor2Вручную: положить файлы
.cursor/skills/btca-cli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davis7dotsh/better-context btca-cli2Вручную: положить файлы
.github/skills/btca-cli/SKILL.md1Через Skills CLI (Vercel)
npx skills add davis7dotsh/better-context --skill btca-cli -a gemini-cli2Командой платформы
gemini skills install https://github.com/davis7dotsh/better-context --path skills/btca-cliВручную: положить файлы
.devin/skills/btca-cli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add davis7dotsh/better-context --skill btca-cli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о btca-cli
Как установить btca-cli в Claude Code?
Выполните npx skills add davis7dotsh/better-context --skill btca-cli -a claude-code, затем повторите npx skills add davis7dotsh/better-context --skill btca-cli -a claude-code. Файл скилла размещается в ~/.claude/skills/btca-cli/SKILL.md.
Что делает btca-cli?
Скилл управляет CLI btca для добавления ресурсов и поиска по их содержимому. Он помогает задавать вопросы по git-репозиториям, локальным каталогам и npm-пакетам.
Где btca-cli хранит конфигурацию ресурсов?
Проектная конфигурация находится в btca.config.jsonc, глобальная — в ~/.config/btca/btca.config.jsonc. Конфигурация проекта перекрывает глобальную.
Исходный текст
SKILL.md · MIT
--- name: btca-cli description: Operate the btca CLI for local resources and source-first answers. Use when setting up btca in a project, connecting a provider, adding or managing resources, and asking questions via btca commands. Invoke this skill when the user says "use btca" or needs to do more detailed research on a specific library or framework. --- # btca CLI `btca` is a source-first research CLI. It hydrates resources (git, local, npm) into searchable context, then answers questions grounded in those sources. Use configured resources for ongoing work, or one-off anonymous resources directly in `btca ask`. Full CLI reference: https://docs.btca.dev/guides/cli-reference Add resources: ```bash # Git resource btca add -n svelte-dev https://github.com/sveltejs/svelte.dev # Local directory btca add -n my-docs -t local /absolute/path/to/docs # npm package btca add npm:@types/[email protected] -n node-types -t npm ``` Verify resources: ```bash btca resources ``` Ask a question: ```bash btca ask -r svelte-dev -q "How do I define remote functions?" ``` ## Common Tasks - Ask with multiple resources: ```bash btca ask -r react -r typescript -q "How do I type useState?" ``` - Ask with anonymous one-off resources (not saved to config): ```bash # One-off git repo btca ask -r https://github.com/sveltejs/svelte -q "Where is the implementation of writable stores?" # One-off npm package btca ask -r npm:[email protected] -q "How is useTransition exported?" ``` ## Config Overview - Config lives in `btca.config.jsonc` (project) and `~/.config/btca/btca.config.jsonc` (global). - Project config overrides global and controls provider/model and resources. ## Troubleshooting - "No resources configured": add resources with `btca add ...` and re-run `btca resources`. - "Provider not connected": run `btca connect` and follow the prompts. - "Unknown resource": use `btca resources` for configured names, or pass a valid HTTPS git URL / `npm:<package>` as an anonymous one-off in `btca ask`.
© davis7dotsh · MIT · davis7dotsh/better-context
