From f2799641077d12b01999e9ed1cc2686bbb7abe82 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ond=C5=99ej=20H=C3=A1na?= Date: Sun, 12 Apr 2026 14:39:22 +0200 Subject: [PATCH] Clear and concise grammar tends to perform better with agents Refine language for clarity and conciseness in guidelines and workflow. --- skills/btca-local/SKILL.md | 40 ++++++++++++++++++-------------------- 1 file changed, 19 insertions(+), 21 deletions(-) diff --git a/skills/btca-local/SKILL.md b/skills/btca-local/SKILL.md index 4fb82dca..e5a21098 100644 --- a/skills/btca-local/SKILL.md +++ b/skills/btca-local/SKILL.md @@ -5,55 +5,51 @@ description: Invoke this skill when the user says "use btca" # 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. +BTCA Local, aka "The Better Context App Local" is a simple app defined as a skill file. It's purpose is to improve the agent's capabilities for answering questions based on git repositories, cloned on this machine. ## the BTCA Search Workflow - if the user includes a direct like to a github repo, always load and reference that + If the user includes a direct like to a github repo, always load and reference that. - 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 + If the user doesn't include any specific links/repos, do your best to guess based on the provided context. - always include links/citations in your answers explaining what you found + Always include links and citations in your answers explaining what you found. - include very clear and complete code snippets. don't leave out stuff like imports, that's important context + Include very clear and complete code snippets. Don't leave out imports and error handling, that's an important context. - when answering use lots of bulleted/numbered lists to keep things readable and clear + Be extremly concise in all interactions. Sacrifice grammer for the sake of concision. - use ~/.btca/agent/sandbox as the place where you clone/search repos + Store your cloned repositories into `~/.btca/agent/sandbox`. - 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 + If the repository is already inside your working directory `~/.btca/agent/sandbox`, update it, otherwise clone it. Clone the main branch, unless the user specifies otherwise. - search the repo for the information you need. make sure to follow the guidelines + Search the repository for the required information. Make sure you follow the guidelines. -a clear, concise answer to the question with code examples + A clear and concise answer to the question with code examples. ## Startup Cases: -This skill can be invoked in a couple different ways, and your behavior should reflect that: +This skill can be invoked in the following ways. Make sure your behaviour reflects that. -### user invoked without extra context/question +### User invoked you without a 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): +Start by searching inside the top level of your working directory `~/.btca/agent/sandbox` to get a list of all previously cloned repositories. Then output the following markdown: ```md # BTCA Local @@ -69,10 +65,12 @@ 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 +This is an "app startup" state, similar to being launched inside as a terminal application. + +### You have been invoked because of the 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 +Answer and execute the user's prompt. Use the BTCA search workflow to improve your understanding of the users context. -### user invoked while also giving a prompt/questions +### User manually invoked you while providing a question or prompt -this one's simple, simply answer the users prompt with the btca search workflow +Answer the prompt using the BTCA search workflow.