Agent skill

Persistence

by AHS12 in AHS12/thoth-blueprint

Safely change browser-local persistence, Dexie schemas, store synchronization, backups, trash, restore, or checkpoints.

GPL-3.0Auto-check passedDevOps & Cloud

Install Persistence

skills CLI
$ npx skills add AHS12/thoth-blueprint --skill persistence -a claude-code

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

GitHub CLI
$ gh skill install AHS12/thoth-blueprint persistence --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/AHS12/thoth-blueprint.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/persistence .claude/skills/persistence && 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
persistence
GitHub stars
626
Token cost
~463 tokens
SKILL.md length
222 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
GPL-3.0

At a glance

Safely change browser-local persistence, Dexie schemas, store synchronization, backups, trash, restore, or checkpoints.

  • Works in 7 steps: Treat src/lib/db.ts as an append-only… → Add upgrade logic for old records when a… → Preserve existing debounce and… → …
  • IndexedDB behavior changes
  • SKILL.md covers Read First, Change Rules and Verification
  • Calls pnpm

What it does

Persistence is an agent skill from AHS12/thoth-blueprint. Safely change browser-local persistence, Dexie schemas, store synchronization, backups, trash, restore, or checkpoints. Use when diagram data or IndexedDB behavior changes.

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

It sits in DevOps & Cloud, covering Backup and disaster recovery. It works with Zustand and pnpm. The repository describes itself as: Design databases the way you think. Create unlimited schemas, import existing designs, visualize relationships, export to multiple formats, and generate framework migrations… The licence is GPL-3.0.

When your agent uses it

  • IndexedDB behavior changes
  • Tasks that involve Backup and disaster recovery

Example prompts

  • “/persistence”

Workflow steps

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

  1. Treat src/lib/db.ts as an append-only schema history. Add a new version() for persisted schema/index changes; do not rewrite old migrations.
  2. Add upgrade logic for old records when a new required field cannot be safely defaulted at read time.
  3. Preserve existing debounce and transaction behavior. Account for the fact that an immediate IndexedDB read after a mutation can observe…
  4. Check all lifecycle paths for changed fields: create, import, duplicate, trash, restore, permanent delete, checkpoint, backup export, and…
  5. Keep diagrams and diagramsMap synchronized in Zustand. Avoid direct partial state updates that leave the map stale.
  6. If a change affects backups, update validation and date rehydration deliberately. Backups currently cover diagrams, selected diagram…
  7. Use Dexie transactions for multi-table replacement or clear-and-restore operations.

What it can do on your machine

Read from SKILL.md and the folder at commit 075e0e3. 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

    Shell commands in SKILL.md call:

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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

Persistence loads about 463 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 222 words of instructions outside code blocks.

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

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 AHS12/thoth-blueprint at commit 075e0e3, republished under its GPL-3.0 licence (© AHS12). 222 words, ~463 tokens.

Download SKILL.mdSave it as .claude/skills/persistence/SKILL.md (or your agent's skills folder).
name
persistence
description
Safely change browser-local persistence, Dexie schemas, store synchronization, backups, trash, restore, or checkpoints. Use when diagram data or IndexedDB behavior changes.

Persistence

Read First

  • src/lib/db.ts for the current Dexie version and upgrade history.
  • src/store/store.ts for debounced position/full saves and state initialization.
  • src/lib/backup.ts for .thot export/import behavior.
  • src/lib/types.ts for persisted shapes.

Change Rules

  1. Treat src/lib/db.ts as an append-only schema history. Add a new version() for persisted schema/index changes; do not rewrite old migrations.
  2. Add upgrade logic for old records when a new required field cannot be safely defaulted at read time.
  3. Preserve existing debounce and transaction behavior. Account for the fact that an immediate IndexedDB read after a mutation can observe the previous value.
  4. Check all lifecycle paths for changed fields: create, import, duplicate, trash, restore, permanent delete, checkpoint, backup export, and backup import.
  5. Keep diagrams and diagramsMap synchronized in Zustand. Avoid direct partial state updates that leave the map stale.
  6. If a change affects backups, update validation and date rehydration deliberately. Backups currently cover diagrams, selected diagram state, and AI chat sessions, not every local table.
  7. Use Dexie transactions for multi-table replacement or clear-and-restore operations.

Verification

  • Test a fresh database and representative existing records when adding a migration.
  • Verify reload persistence after normal edits, position-only edits, imports, restores, and deletion.
  • Check backup round trips and confirm invalid backup input does not partially replace local data.
  • Run pnpm run type-check, pnpm run lint, and pnpm run build.

© AHS12, GPL-3.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/persistence of AHS12/thoth-blueprint.

Open the folder on GitHubat commit 075e0e3

Compare with similar skills

Persistence 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.

Persistence compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Persistence this skillAHS12/thoth-blueprint626—~463Automated safety check: PassGPL-3.0
Container Devyansongda/pay5.4k—~968Automated safety check: PassMIT
Pymobiledevice3 Device Operatordoronz88/pymobiledevice32.8k—~1.8kAutomated safety check: NotesGPL-3.0
Desktop Release Sync LandingEynzof/Hermes-CN-Desktop1.7k—~1.3kAutomated safety check: PassCustom licence
CI GitHub Actionsgnomeria/usbtree688—~1.4kAutomated safety check: PassMIT
Check Deps SyncHyk260/PureChat546—~594Automated safety check: PassMIT

Similar skills

  • Container Dev

    yansongda/pay

    A skill your agent uses when local PHP environment is unavailable.

    5.4k GitHub stars~968 tokensUpdated 9 days ago
    DevOps & CloudAuto-check passed
  • Pymobiledevice3 Device Operator

    doronz88/pymobiledevice3

    Operate iOS and iPadOS devices with pymobiledevice3, from a local checkout or straight from PyPI via uvx on a fresh workstation.

    2.8k GitHub stars~1.8k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Desktop Release Sync Landing

    Eynzof/Hermes-CN-Desktop

    Use only for stable/public Hermes Agent CN Desktop releases that should be visible to all users.

    1.7k GitHub stars~1.3k tokensUpdated 16 days ago
    DevOps & CloudAuto-check passed
  • CI GitHub Actions

    gnomeria/usbtree

    GitHub Actions CI pipeline conventions — job shape, caching, permissions, and action pinning.

    688 GitHub stars~1.4k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Check Deps Sync

    Hyk260/PureChat

    Check if package.json files are in sync with pnpm-lock.yaml.

    546 GitHub stars~594 tokensUpdated 20 days ago
    DevOps & CloudAuto-check passed
  • Webspatial Release

    webspatial/webspatial-sdk

    WebSpatial SDK 仓库的版本发布与 Changesets 使用规范. An agent skill from webspatial/webspatial-sdk.

    153 GitHub stars~836 tokensUpdated 5 days ago
    DevOps & CloudAuto-check passed

More from AHS12/thoth-blueprint

  • AI Assistant

    AHS12/thoth-blueprint

    Safely change the schema AI assistant, cloud or local providers, credentials, context construction, streamed patches, retries, validation, or atomic diagram application.

    626 GitHub stars~534 tokensUpdated 1 mo ago
    Auto-check passed
  • Diagram Editor

    AHS12/thoth-blueprint

    Safely change the React Flow database diagram editor, including table, note, zone, relationship, selection, locking, layout, keyboard, and viewport behavior.

    626 GitHub stars~506 tokensUpdated 1 mo ago
    Auto-check passed
  • Import Export

    AHS12/thoth-blueprint

    Change SQL, SQLite worker, DBML, JSON, Mermaid, SVG, or database export/import flows while preserving diagram semantics and round trips.

    626 GitHub stars~499 tokensUpdated 1 mo ago
    Auto-check passed
  • Pwa Release

    AHS12/thoth-blueprint

    Safely change Vite, service-worker, offline fallback, cache, Docker, Vercel, or release-distribution behavior.

    626 GitHub stars~505 tokensUpdated 1 mo ago
    Auto-check passed
  • Migration Codegen

    AHS12/thoth-blueprint

    Change Laravel, TypeORM, or Django migration generation and generated SQL parsing.

    626 GitHub stars~425 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Persistence

What does Persistence do?

Safely change browser-local persistence, Dexie schemas, store synchronization, backups, trash, restore, or checkpoints. Persistence is an agent skill from AHS12/thoth-blueprint. Safely change browser-local persistence, Dexie schemas, store synchronization, backups, trash, restore, or checkpoints.

When should I use Persistence?

Persistence fits situations like: indexedDB behavior changes; tasks that involve Backup and disaster recovery.

How do I install Persistence in Claude Code?

Run `npx skills add AHS12/thoth-blueprint --skill persistence -a claude-code`. Or copy the skill folder (.agents/skills/persistence in AHS12/thoth-blueprint) into .claude/skills/persistence in your project. Claude Code loads it when a task matches its description.

How do I install Persistence in Codex?

Run `npx skills add AHS12/thoth-blueprint --skill persistence -a codex`. Or copy the skill folder (.agents/skills/persistence in AHS12/thoth-blueprint) into .agents/skills/persistence in your project. Codex loads it when a task matches its description.

Can I use Persistence 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 AHS12/thoth-blueprint --skill persistence -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/persistence, .gemini/skills/persistence, .github/skills/persistence and .opencode/skills/persistence in your project.

What does Persistence need to run?

Going by SKILL.md and its folder, Persistence needs the command-line tools its instructions call (pnpm).

Does Persistence 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 Persistence 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 Persistence use?

Persistence is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Persistence use?

About 463 tokens (SKILL.md is roughly 1.9k 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 Persistence?

Skills that share tags, products or a category with Persistence: Container Dev (yansongda/pay, 5.4k stars), Pymobiledevice3 Device Operator (doronz88/pymobiledevice3, 2.8k stars), Desktop Release Sync Landing (Eynzof/Hermes-CN-Desktop, 1.7k stars) and CI GitHub Actions (gnomeria/usbtree, 688 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Persistence?

AHS12 (a GitHub user) maintains it in AHS12/thoth-blueprint, which has 626 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on August 12, 2026.

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