Btca Local

davis7dotsh/better-context/skills/btca-local

by davis7dotsh864e5ba452566c318d60f75229882233b2a5c120No licenseListed Oct 9, 2026Updated Oct 9, 2026

Invoke this skill when the user says "use btca"

Instructions onlySoftware Development
AI-generated overview

Searches git repositories cloned locally to answer questions with cited code examples.

What it does
BTCA Local is an instruction-only skill that defines a search workflow over git repositories kept in a local sandbox directory. It clones or updates the requested repositories, searches them for the needed information, and produces an answer with citations and complete code snippets. When invoked without a question, it lists the repositories already present in the sandbox.
When to use it
Use it when a question should be answered by searching git repositories available on the local machine. It fits requests that name a repository link or that can be matched to a repository from context.
Requirements
A local working directory at ~/.btca/agent/sandbox, git access to clone or update repositories, and network access for cloning. No scripts are shipped; the skill is instructions only.

BTCA Local

BTCA Local, aka "The Better Context App Local" is a simple app defined as a skill file. The purpose of this app is to search git repos cloned onto this machine.

the BTCA Search Workflow

<guidelines>

<guideline>    if the user includes a direct like to a github repo, always load and reference that</guideline><guideline>    if the user doesn't include any specific links/repos they want you to use, do your best to guess based on the context provided</guideline><guideline>    always include links/citations in your answers explaining what you found</guideline><guideline>    include very clear and complete code snippets. don't leave out stuff like imports, that's important context</guideline><guideline>    when answering use lots of bulleted/numbered lists to keep things readable and clear</guideline>

</guidelines>

<workflow>

<step name="work dir setup">    use ~/.btca/agent/sandbox as the place where you clone/search repos</step><step name="load">    if the repo(s) are already in the work dir ~/.btca/agent/sandbox update them, otherwise clone them. clone the main branch by default, unless the user asks for something else</step><step name="search">    search the repo for the information you need. make sure to follow the guidelines</step>

<workflow>

<end_goal>

a clear, concise answer to the question with code examples

</end_goal>

Startup Cases:

This skill can be invoked in a couple different ways, and your behavior should reflect that:

user invoked without extra context/question

this is the "app startup" state, almost as if a terminal app was booted up.

Your job is to search the working directory ~/.btca/agent/sandbox at the top level, just to get a list of all the repos that have been previously cloned

Then you should simply output the following markdown (filling in the existing repos):

md
# BTCA Local
_use your coding agent to search any git repo locally_
Previously searched:
- repo 1- ...
Give me a question and the link to a git repo to get started!(we can also clean out or pre-load some resources to this list...)

you invoked because of user's prompt

in this case, your job is to answer/execute the users prompt faithfully, just while also using the btca search workflow when needed to better execute your task

user invoked while also giving a prompt/questions

this one's simple, simply answer the users prompt with the btca search workflow

Source and attribution

Source:davis7dotsh/better-contextinskills/btca-localat commit864e5ba

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal