whatisgithub

What is prompt-cache-skills?

onlyterp/prompt-cache-skills — explained in plain English

Analysis updated 2026-05-18

78PythonAudience · developerComplexity · 2/5Setup · easy

In one sentence

A collection of drop-in fixes that turn on and correct prompt caching in popular AI coding agents like Cline, Roo Code, Continue, Aider, and OpenCode, cutting their API costs.

Mindmap

mindmap
  root((repo))
    What it does
      Fixes caching bugs
      Cuts API costs
      Applies via skill files
    Tech stack
      Python
      SKILL.md format
    Use cases
      Fix Cline caching
      Fix Aider caching
      Audit new agents
    Audience
      AI coding agent users
      Tool maintainers
    Coverage
      13 verified bugs
      Five tools patched
      Several tools audited clean

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Apply the Cline skill to fix a missing OpenAI cache key and volatile message ordering.

USE CASE 2

Turn on default caching in Aider and extend its cache TTL to save on API spend.

USE CASE 3

Audit whether your own AI coding agent already caches correctly using the included scripts.

USE CASE 4

Fix Roo Code's AWS Bedrock ARN handling so caching works on Bedrock deployments.

What is it built with?

PythonMarkdownSKILL.md

How does it compare?

onlyterp/prompt-cache-skillsa2328275243/mempalace-evolveanthonykhayesaudsrx50512/flash-usdt-sender
Stars787878
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity2/53/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Point an AI coding agent at the repo and have it read and apply the relevant SKILL.md files.

The explanation does not state a license for this repository.

So what is it?

This repository is a collection of drop-in fixes for a specific problem: most popular open-source AI coding agents (tools like Cline, Roo Code, Continue, Aider, and OpenCode) are not taking full advantage of prompt caching, a feature offered by AI providers like Anthropic and OpenAI that can cut API costs by 30 to 90 percent. The bugs are subtle: some agents have caching turned off by default, some have their cache breakpoints placed in the wrong spots, and some handle certain cloud providers (like AWS Bedrock or Google Cloud Vertex) incorrectly. The project calls its fixes "skills," meaning self-contained instruction files each named SKILL.md that an AI coding agent can read and apply on its own. You point your agent at this repository, tell it to apply every skill that matches the tools you use, and the agent reads each file, checks whether the fix is relevant to your project, applies the code change, and then verifies the result by checking that cached token counts actually appear in API responses. You do not need to understand the underlying code changes yourself. The repository covers 13 specific, verified bugs across five coding tools. Cline gets fixes for volatile message ordering and a missing OpenAI cache key. Roo Code gets a volatile message fix and a correction for custom AWS Bedrock ARNs. Continue gets default caching enabled, volatile message handling, and explicit Gemini caching. Aider gets caching turned on by default and a longer cache TTL. OpenCode gets proxy detection fixes and a Bedrock document-block correction. Several other agents including Claude Desktop Code, Codex CLI, and Grok CLI were audited and found to already work correctly. The folder also includes audit write-ups for every tool reviewed, reference documentation on how each AI provider implements caching, a list of 16 common pitfalls, and scripts you can run to confirm that caching is actually working in your setup.

Copy-paste prompts

Prompt 1
Point this agent at OnlyTerp/prompt-cache-skills, read every SKILL.md, and apply any that match the coding tools I use.
Prompt 2
Check whether Cline's prompt caching is misconfigured using the fixes described in this repository.
Prompt 3
Use the audit scripts in this repo to verify that my AI coding agent's API responses show cached tokens.
Prompt 4
Explain which of the 13 bugs fixed in this repo apply to Aider and walk me through applying that fix.

Frequently asked questions

What is prompt-cache-skills?

A collection of drop-in fixes that turn on and correct prompt caching in popular AI coding agents like Cline, Roo Code, Continue, Aider, and OpenCode, cutting their API costs.

What language is prompt-cache-skills written in?

Mainly Python. The stack also includes Python, Markdown, SKILL.md.

What license does prompt-cache-skills use?

The explanation does not state a license for this repository.

How hard is prompt-cache-skills to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is prompt-cache-skills for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.