- Installs
- 1K
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/davis7dotsh/better-context --skill btca-local- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads btca-local automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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):
# 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
FAQ
What does the btca-local skill do?
Invoke this skill when the user says "use btca"
How do I install btca-local?
Run npx skills add https://github.com/davis7dotsh/better-context --skill btca-local in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/btca-local/ (personal) or .claude/skills/btca-local/ (project).
Which AI agents can use btca-local?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is btca-local safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains btca-local?
It is published by davis7dotsh in davis7dotsh/better-context. It has 1,032 recorded installs.
More from davis7dotsh/better-context
btca-cli
davis7dotsh/better-context
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.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.