New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Local Cache Idempotency Fallback

by divinevideo in divinevideo/divine-mobile

Use database cache when external APIs aren't reliably idempotent.

MPL-2.0Auto-check passed

Install Local Cache Idempotency Fallback

skills CLI
$ npx skills add divinevideo/divine-mobile --skill local-cache-idempotency-fallback -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install divinevideo/divine-mobile local-cache-idempotency-fallback --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/divinevideo/divine-mobile.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/local-cache-idempotency-fallback .claude/skills/local-cache-idempotency-fallback && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
local-cache-idempotency-fallback
GitHub stars
265
Token cost
~1.1k tokens
SKILL.md length
300 words
Files
1
Skills in repo
103
Repo updated
First seen
Licence
MPL-2.0

At a glance

Use database cache when external APIs aren't reliably idempotent.

  • Works in 5 steps: Check local first: Always query your… → Use cached values: If found, use local… → Only create when missing: External API… → …
  • External API claims idempotency but returns different values for same input
  • SKILL.md covers Problem, Context / Trigger Conditions, Solution and Verification, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Local Cache Idempotency Fallback is an agent skill from divinevideo/divine-mobile. Use database cache when external APIs aren't reliably idempotent. Use when: (1) External API claims idempotency but returns different values for same input, (2) Re-running a script creates duplicate resources, (3) Need stable identifiers across runs but external service generates new ones. Pattern: check database cache first, only call external API for genuinely new items, cache the result.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The licence is MPL-2.0.

When your agent uses it

  • External API claims idempotency but returns different values for same input
  • Re-running a script creates duplicate resources
  • Need stable identifiers across runs but external service generates new ones

Example prompts

  • “/local-cache-idempotency-fallback”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Check local first: Always query your database before calling external API
  2. Use cached values: If found, use local values even if stale
  3. Only create when missing: External API called only for genuinely new items
  4. Cache immediately: Save result right after successful API call
  5. Log the source: Indicate whether value is "(cached)" or "(new)" for debugging

What it can do on your machine

Read from SKILL.md and the folder at commit 8d5fbf2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Local Cache Idempotency Fallback loads about 1.1k tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 300 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from divinevideo/divine-mobile at commit 8d5fbf2, republished under its MPL-2.0 licence (© divinevideo). 300 words, ~1,058 tokens.

Download SKILL.mdSave it as .claude/skills/local-cache-idempotency-fallback/SKILL.md (or your agent's skills folder).
name
local-cache-idempotency-fallback
description
Use database cache when external APIs aren't reliably idempotent. Use when: (1) External API claims idempotency but returns different values for same input, (2) Re-running a script creates duplicate resources, (3) Need stable identifiers across runs but external service generates new ones. Pattern: check database cache first, only call external API for genuinely new items, cache the result.
author
Claude Code
version
1.0.0
date
2026-01-25

Local Cache as Idempotency Fallback

Problem

External APIs that should be idempotent (same input = same output) sometimes aren't. This causes problems when re-running scripts:

  • Duplicate resources created
  • Identifiers change between runs
  • State becomes inconsistent across systems

Context / Trigger Conditions

  • Re-running a script creates new resources instead of finding existing ones
  • External API "fixed" idempotency but still returns different values
  • Need stable identifiers (pubkeys, user IDs, resource IDs) across runs
  • Script works once but fails on subsequent runs due to changed IDs

Solution

Use database cache as the source of truth for idempotency:

typescript
// BEFORE: Always calls external API (brittle)
const { pubkey, token } = await externalApi.createUser(userId, username);
await db.saveUser({ userId, pubkey, token });

// AFTER: Check cache first (robust)
const cached = await db.getUser(userId);
let pubkey: string;
let token: string;

if (cached) {
  // Use cached values - stable across runs
  pubkey = cached.pubkey;
  token = cached.token;
  console.log(`Using cached pubkey: ${pubkey}`);
} else {
  // Only call external API for genuinely new items
  const result = await externalApi.createUser(userId, username);
  pubkey = result.pubkey;
  token = result.token;

  // Cache immediately for next run
  await db.saveUser({ userId, pubkey, token });
  console.log(`Created new pubkey: ${pubkey}`);
}
Key Pattern
  1. Check local first: Always query your database before calling external API
  2. Use cached values: If found, use local values even if stale
  3. Only create when missing: External API called only for genuinely new items
  4. Cache immediately: Save result right after successful API call
  5. Log the source: Indicate whether value is "(cached)" or "(new)" for debugging

Verification

  • Re-run script multiple times
  • Same identifier used each time (from cache)
  • No duplicate resources created in external system
  • Script is idempotent regardless of external API behavior

Example

Real-world application - Keycast account creation:

typescript
// Check if we have a cached account first (local DB is source of truth)
const cached = await db.getImportedUser(creator.user_id);
let pubkey: string;
let token: string;

if (cached) {
  // Use cached account - pubkey is stable
  pubkey = cached.pubkey;
  token = cached.token;
  console.log(`Pubkey: ${pubkey} (cached)`);
} else {
  // Create new account via external API
  const result = await keycast.createPreloadedUser(
    creator.user_id,
    username,
    displayName
  );
  pubkey = result.pubkey;
  token = result.token;
  console.log(`Pubkey: ${pubkey} (new)`);

  // Cache account in database immediately
  await db.saveImportedUser({
    vine_user_id: creator.user_id,
    username: creator.username,
    pubkey,
    token,
  });
}

Notes

  • This pattern works even when the external API claims to be idempotent
  • Database schema should use the input identifier as primary key (prevents duplicates)
  • Consider adding timestamps to track when cached values were created
  • For critical systems, add reconciliation logic to detect/fix drift
  • The cache becomes your source of truth - treat it accordingly
  • Upsert on conflict: Use ON CONFLICT DO UPDATE to handle race conditions
  • Soft delete: Keep old records to track history of changes
  • Cache invalidation: Add TTL or manual refresh if external values can legitimately change
  • stale-cache-external-service-recovery: What to do when external service loses data and cached identifiers no longer exist (detect 404, delete cache, recreate)

© divinevideo, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/local-cache-idempotency-fallback of divinevideo/divine-mobile.

Open the folder on GitHubat commit 8d5fbf2

Compare with similar skills

Local Cache Idempotency Fallback next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Local Cache Idempotency Fallback compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local Cache Idempotency Fallback this skilldivinevideo/divine-mobile265—~1.1kAutomated safety check: PassMPL-2.0
Prompt Cachingdavila7/claude-code-templates32k5 repos~452Automated safety check: PassMIT
Turborepo Cachingwshobson/agents40k8 repos~2kAutomated safety check: NotesMIT
OmniRoute LLM Cachediegosouzapw/OmniRoute74k1 repos~529Automated safety check: PassMIT
Cachingzebbern/claude-code-guide4.6k—~1.5kAutomated safety check: PassMIT
Content-Hash File Cache Patternaffaan-m/ECC274k5 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Prompt Caching

    davila7/claude-code-templates

    Caching strategies for LLM prompts including Anthropic prompt caching, response caching, and CAG (Cache Augmented Generation) Use when: prompt caching, cache prompt, response cache, cag, cache…

    32k GitHub starsUsed in 5 repos~452 tokens
    Backend & APIsAuto-check passed

  • Turborepo Caching

    wshobson/agents

    Configures Turborepo pipelines and local or remote caching for monorepo builds, including Vercel remote cache, a self-hosted cache and cache-miss debugging.

    40k GitHub starsUsed in 8 repos~2k tokens
    DevelopmentAuto-check: notes

  • OmniRoute LLM Cache

    diegosouzapw/OmniRoute

    Documents OmniRoute's cache endpoints for reading cache statistics and clearing entries, statistics or the reasoning cache, with notes on TTL and similarity settings.

    74k GitHub starsUsed in 1 repo~529 tokens
    Backend & APIsAuto-check passed

  • Caching

    zebbern/claude-code-guide

    Caching strategies — invalidation, TTL guidelines, cache keys, cache layers, and when not to cache.

    4.6k GitHub stars~1.5k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Content-Hash File Cache Pattern

    affaan-m/ECC

    Caches slow file processing results in Python keyed by a SHA-256 hash of the file content, so renames still hit the cache and edits invalidate it automatically.

    274k GitHub starsUsed in 5 repos~1.4k tokens
    DevelopmentAuto-check passed

  • Browser Caching

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Enable browser caching.

    74k GitHub stars~399 tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from divinevideo/divine-mobile

All 103 skills in this repo

  • Argocd Externalsecret Namespace Permission

    divinevideo/divine-mobile

    Fix ArgoCD ExternalSecret deployment failing with "namespace X is not permitted in project Y".

    265 GitHub stars~931 tokensUpdated today
    Auto-check passed

  • Art Direct

    divinevideo/divine-mobile

    Art direction for any content — reads text, PDF, Word, HTML, PPT, then proposes 2-3 creative directions with photography style, mood, and visual language.

    265 GitHub stars~4.8k tokensUpdated today
    Auto-check passed

  • Async Await Null Race Condition

    divinevideo/divine-mobile

    Fix "Null check operator used on a null value" errors when an object is set to null during an async await.

    265 GitHub stars~881 tokensUpdated today
    Auto-check passed

  • AWS V4 Signing Custom Headers Gcs

    divinevideo/divine-mobile

    Add custom metadata headers (x-amz-meta-) to AWS v4 signed requests for GCS S3-compatible API.

    265 GitHub stars~1k tokensUpdated today
    Auto-check passed

  • Bash Herestring Newline Secrets

    divinevideo/divine-mobile

    Fix password/secret authentication failures caused by trailing newlines when creating Google Cloud secrets (or similar) with bash here-strings.

    265 GitHub stars~791 tokensUpdated today
    Auto-check passed

  • Blossom Content Addressed URL Filtering

    divinevideo/divine-mobile

    Fix silent video/media processing failures caused by URL extraction code that filters on file extensions (.mp4, .webm, .webp).

    265 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Local Cache Idempotency Fallback

What does Local Cache Idempotency Fallback do?

Use database cache when external APIs aren't reliably idempotent. Local Cache Idempotency Fallback is an agent skill from divinevideo/divine-mobile. Use database cache when external APIs aren't reliably idempotent.

When should I use Local Cache Idempotency Fallback?

Local Cache Idempotency Fallback fits situations like: external API claims idempotency but returns different values for same input; re-running a script creates duplicate resources; need stable identifiers across runs but external service generates new ones.

How do I install Local Cache Idempotency Fallback in Claude Code?

Run `npx skills add divinevideo/divine-mobile --skill local-cache-idempotency-fallback -a claude-code`. Or copy the skill folder (.agents/skills/local-cache-idempotency-fallback in divinevideo/divine-mobile) into .claude/skills/local-cache-idempotency-fallback in your project. Claude Code loads it when a task matches its description.

How do I install Local Cache Idempotency Fallback in Codex?

Run `npx skills add divinevideo/divine-mobile --skill local-cache-idempotency-fallback -a codex`. Or copy the skill folder (.agents/skills/local-cache-idempotency-fallback in divinevideo/divine-mobile) into .agents/skills/local-cache-idempotency-fallback in your project. Codex loads it when a task matches its description.

Can I use Local Cache Idempotency Fallback in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add divinevideo/divine-mobile --skill local-cache-idempotency-fallback -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/local-cache-idempotency-fallback, .gemini/skills/local-cache-idempotency-fallback, .github/skills/local-cache-idempotency-fallback and .opencode/skills/local-cache-idempotency-fallback in your project.

What does Local Cache Idempotency Fallback need to run?

SKILL.md names no scripts, command-line tools or credentials: Local Cache Idempotency Fallback is instructions for the agent only.

Does Local Cache Idempotency Fallback access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Local Cache Idempotency Fallback safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Local Cache Idempotency Fallback use?

Local Cache Idempotency Fallback is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Local Cache Idempotency Fallback use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Local Cache Idempotency Fallback?

Skills that share tags, products or a category with Local Cache Idempotency Fallback: Prompt Caching (davila7/claude-code-templates, 32k stars), Turborepo Caching (wshobson/agents, 40k stars), OmniRoute LLM Cache (diegosouzapw/OmniRoute, 74k stars) and Caching (zebbern/claude-code-guide, 4.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local Cache Idempotency Fallback?

divinevideo (a GitHub organization) maintains it in divinevideo/divine-mobile, which has 265 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.

Source: divinevideo/divine-mobile on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.