skills.rest
samymity
samymityCOMMUNITY
Explore all skills by this author →
GitHub

content-hash-cache-pattern

Cache file processing results using SHA-256 content-hash keys.

1|Updated Mar 3, 2026
Search Tags:#caching#file processing#service layer#pdf parsing#pipeline optimization#sha-256
One-click install
npx skills add https://github.com/samymity/bridge-ventures-backend --skill content-hash-cache-pattern-samymity
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: content-hash-cache-pattern
Source: https://github.com/samymity/bridge-ventures-backend/tree/main/.claude/skills/content-hash-cache-pattern
Command: npx skills add https://github.com/samymity/bridge-ventures-backend --skill content-hash-cache-pattern-samymity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Expensive file processing (like parsing PDFs or extracting text) wastes time and compute when the same inputs are processed repeatedly across runs.

Core Features & Use Cases

  • Content-hash cache keys: Uses SHA-256 of file contents (not paths) so renames/moves still hit the cache and content changes auto-invalidate.
  • File-backed O(1) lookup: Stores each cached result as {hash}.json for simple, index-free retrieval.
  • Service-layer caching wrapper (SRP): Keeps core extraction functions pure while caching logic lives in a separate wrapper.
  • Corruption-safe behavior: Treats invalid or corrupted cache entries as misses to avoid crashes and ensure re-processing.

Quick Start

Instruct the system to implement a cache-enabled extraction wrapper that hashes the file with SHA-256, checks for a matching {hash}.json entry, and only runs the costly extraction when the cache is missing or invalidated.

Frequently Asked Questions about content-hash-cache-pattern

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

FAQPage Schema
How do I cache PDF parsing results to skip reprocessing the same files?▼

Cache PDF parsing results by generating a SHA-256 content-hash of the file and storing the output as a {hash}.json entry. This allows O(1) lookup on subsequent runs, skipping costly extraction when a matching cache file exists.

What is the best way to invalidate cached file processing results when content changes?▼

Content-hash caching provides automatic invalidation by using SHA-256 hashes of file contents instead of file paths. If the file content changes, the hash changes, ensuring the old cache is ignored and the file is reprocessed naturally.

How does content-hash caching handle large files in a processing pipeline?▼

Large files require chunked hashing to generate the SHA-256 cache key efficiently without loading the entire file into memory. This hash identifies existing cached results before running the extraction pipeline.

Can I add caching to my extraction pipeline without modifying the core processing function?▼

Yes, you can use a service-layer caching wrapper to preserve the purity of your core extraction function. The wrapper handles the SHA-256 hashing and cache lookup, keeping the underlying processing logic separate and cache-togglable.

What happens if a cached JSON file becomes corrupted during file processing?▼

Corrupted or invalid cache entries are treated as cache misses. The system safely ignores the invalid {hash}.json file and automatically re-runs the extraction process to generate a fresh, valid cached result without crashing.

Related Skills

Explore More Software Engineering Skills→
xxihxxih
1

content-hash-cache-pattern

Cache file processing results using SHA-256 content hashes and JSON files.

Community
Intermediate
bobvarkeybobvarkey
1

paperzilla

List, inspect, and export Paperzilla projects and paper feeds via the pz CLI.

Community
Intermediate
ConsiliencyConsiliency
8

spec-discovery

Parse specs to extract IDs, titles, and SHA-256 hashes into a JSON or TOON manifest.

Official
Basic
TakMczkTakMczk
1

swift-actor-persistence

Build thread-safe Swift data persistence layers using actor isolation.

Community
Intermediate