agent-runtime-cache-benchmark

Benchmarks prompt-cache reuse by comparing two JSON agent-run artifacts and outputs a Markdown or JSON report locally.

325|60|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/Prompthon-IO/agent-systems-handbook --skill agent-runtime-cache-benchmark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-runtime-cache-benchmark
Source: https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/skills/agent-runtime-cache-benchmark
Command: npx skills add https://github.com/Prompthon-IO/agent-systems-handbook --skill agent-runtime-cache-benchmark

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Benchmark and explain prompt-cache reuse by comparing two agent-run artifacts (cold vs warm) to determine whether caching improves performance and where it may break.

Core Features & Use Cases

  • Compare two structured run artifacts to quantify cache hits, latency delta, and hash stability.
  • Identify likely cache-break events when system prompts, tool manifests, or history change between runs.
  • Produce a concise local Markdown or JSON report for operator review.

Quick Start

Collect two JSON run artifacts (cold and warm) and run the helper to generate the report.

Frequently Asked Questions about agent-runtime-cache-benchmark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose why prompt caching is not improving latency between agent runs?

Diagnose prompt caching reuse by comparing two structured JSON run artifacts to quantify cache hits, latency delta, and hash stability. The tool flags likely cache-break events when system prompts, tool manifests, or history change between runs.

What is prompt-cache reuse benchmarking and when do I need it?

Prompt-cache reuse benchmarking measures whether caching improves performance by comparing cold versus warm agent-run artifacts. You need it when verifying if system prompts, tool manifests, or history affect caching across operator workflow runs.

Can I benchmark prompt caching using JSON artifacts from my agent runs?

Yes, you can benchmark prompt caching by feeding two JSON run artifacts into the helper script. It computes cache shares, flags likely cache-break fields, and outputs a local Markdown or JSON report for operator review.

What is the best way to compare cold and warm agent runs for cache stability?

The best way to compare cold and warm agent runs is using a benchmarking script that reads two JSON artifacts, computes cache shares, and flags cache-break fields. It generates a concise Markdown or JSON report locally for review.

Why does prompt caching fail when tool manifests or history change across runs?

Prompt caching fails when system prompts, tool manifests, or history change between runs, breaking hash stability. The benchmarking tool identifies these likely cache-break events by comparing two structured run artifacts and quantifying the cache share delta.

Do I need dependencies to generate a prompt-cache benchmark report locally?

No external dependencies are required to generate a prompt-cache benchmark report locally. The tool uses bundled scripts and references to read two JSON run artifacts, compute cache shares, and output a Markdown or JSON report directly.