Skip to content

Instantly share code, notes, and snippets.

@aadishv
Created December 27, 2025 07:14
Show Gist options
  • Select an option

  • Save aadishv/61162107c276717d20ff1abf3e393c7f to your computer and use it in GitHub Desktop.

Select an option

Save aadishv/61162107c276717d20ff1abf3e393c7f to your computer and use it in GitHub Desktop.
name description
research-repo
Use an AI agent with full access to a certain external repository to research. Useful when writing code involving a library to get code examples and information. Use when the user suggests to research how to do something with a certain library.

Research repo

Use this guide for cloning and using AI to analyze the repository of a certain repository.

Example usecase: you're building an app using the Vercel AI SDK, but you're not sure how to create a custom provider. In this case, you can use this skill to clone the vercel/ai GitHub repo and ask an AI for examples of custom providers.

This is especially helpful when you need to know the gnarly aspects of a library without clogging up your own context window.

Steps

  1. Clone the repo into /tmp if it doesn't exist already.

In this case, you'd want to run cd /tmp && git clone [email protected]:vercel/ai.git which will automatically error if it already exists. Update the SSH path to clone a different repo.

  1. Ask a question.

You can use the Pi coding agent for this. Use Gemini 3 Flash, which is a fast and cheap model, for such queries. Use the google-antigravity provider. You'll also want to use the -p flag to run Pi in non-interactive mode and output raw Markdown. Restrict it to read-only tools. Here is a full example:

cd /tmp/ai && pi --provider google-antigravity --model gemini-3-flash --tools read,grep,find,ls -p "code examples for creating a custom provider"

This will run the coding agent, using Gemini 3 Flash, in the repository, using read-only tools (to ensure it does not run amok and run a misguided bash command), and return a Markdown response in stdout.

  1. Ask followup questions.

Use the --continue flag with Pi, which will resume the session history of the most recently active session in the given directory.

cd /tmp/ai && pi --continue --provider google-antigravity --model gemini-3-flash --tools read,grep,find,ls -p "how does the google provider implement thought signatures (opaque reasoning)"

This likely won't be needed in most cases.

Now, you can use the insights gleamed from this process to continue working on your main task.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment