btca

.agents/skills/btca-cli/SKILL.md

@@ -0,0 +1,64 @@
+---
+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/node@22.10.1 -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:react@19.0.0 -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`.

.agents/skills/btca-cli/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "BTCA CLI"
+  short_description: "Help with BTCA CLI setup and usage workflows"

btca.config.jsonc

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://btca.dev/btca.schema.json",
+  "resources": [
+    {
+      "type": "git",
+      "name": "bubbletea",
+      "url": "https://github.com/charmbracelet/bubbletea",
+      "branch": "main"
+    },
+    {
+      "type": "git",
+      "name": "lipgloss",
+      "url": "https://github.com/charmbracelet/lipgloss",
+      "branch": "main"
+    },
+    {
+      "type": "git",
+      "name": "bubbles",
+      "url": "https://github.com/charmbracelet/bubbles",
+      "branch": "main"
+    },
+    {
+      "type": "git",
+      "name": "glamour",
+      "url": "https://github.com/charmbracelet/glamour",
+      "branch": "main"
+    }
+  ],
+  "model": "claude-haiku-4-5",
+  "provider": "opencode"
+}

skills-lock.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "skills": {
+    "btca-cli": {
+      "source": "davis7dotsh/better-context",
+      "sourceType": "github",
+      "computedHash": "99bc5301f4f839a6f3be99d98955f32f1cd576c218731fa05fa54a003bd20e9b"
+    }
+  }
+}