Official agent skill

Principle Separate Before Serializing Shared State

by cursor in cursor/plugins

Apply when concurrent actors might write to the same file, branch, key, or state object.

OfficialNo licenceAuto-check passed

Install Principle Separate Before Serializing Shared State

skills CLI
$ npx skills add cursor/plugins --skill principle-separate-before-serializing-shared-state -a claude-code

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

GitHub CLI
$ gh skill install cursor/plugins principle-separate-before-serializing-shared-state --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/cursor/plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pstack/skills/principle-separate-before-serializing-shared-state .claude/skills/principle-separate-before-serializing-shared-state && 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
principle-separate-before-serializing-shared-state
GitHub stars
10k
Used in
8 other repos
Token cost
~392 tokens
SKILL.md length
180 words
Files
1
Skills in repo
99
Repo updated
First seen
Licence
None found

At a glance

Apply when concurrent actors might write to the same file, branch, key, or state object.

  • Works in 3 steps: Identify shared mutable state (files… → Default: eliminate the shared write… → Only when one shared write target is a…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Principle Separate Before Serializing Shared State is an agent skill from cursor/plugins, published by the product's own GitHub organization. Apply when concurrent actors might write to the same file, branch, key, or state object. Eliminate the sharing first; serialize structurally only when one shared writer is a real invariant.

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

The repository describes itself as: Cursor plugin specification and official plugins.

Example prompts

  • “/principle-separate-before-serializing-shared-state”

Workflow steps

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

  1. Identify shared mutable state (files both read and write, branches both push to, APIs both define and consume).
  2. Default: eliminate the shared write target. Ask: do these actors need one canonical object, or are they publishing independent facts? Give…
  3. Only when one shared write target is a real invariant, serialize access structurally (lockfiles, sequential phases, single-writer actor…

What it can do on your machine

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

    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

Principle Separate Before Serializing Shared State loads about 392 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 180 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 180 words (~392 tokens).

“When concurrent actors might share mutable state, first ask whether they need the same mutable object. If not, eliminate the sharing. When sharing is real, enforce serialization structurally: lockfiles, sequential phases, exclusive ownership. Instructions and conventions are not concurrency control.”

— opening of SKILL.md by cursor
name
principle-separate-before-serializing-shared-state
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in pstack/skills/principle-separate-before-serializing-shared-state of cursor/plugins.

Open the folder on GitHubat commit 9f451cf

Used in 8 other repositories

We found 8 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 8 other GitHub owners. This page covers the copy in cursor/plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Principle Separate Before Serializing Shared State 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.

Principle Separate Before Serializing Shared State compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Principle Separate Before Serializing Shared State this skillcursor/plugins10k8 repos~392Automated safety check: PassNone
Swift Concurrency 6 2affaan-m/ECC274k4 repos~2kAutomated safety check: PassMIT
Swift Concurrency 6 2affaan-m/ECC274k3 repos~1.4kAutomated safety check: PassMIT
Swift Actor Persistenceaffaan-m/ECC274k3 repos~871Automated safety check: PassMIT
Swift Actor Persistenceaffaan-m/ECC274k4 repos~1.2kAutomated safety check: PassMIT
Swift Concurrency Expertdavila7/claude-code-templates32k3 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Swift 6.2 Approachable Concurrency — single-threaded by default, @concurrent for explicit background offloading, isolated conformances for main actor types.

    274k GitHub starsUsed in 4 repos~2k tokens
    DevelopmentAuto-check passed
  • Swift 6.2 可接近的并发性 — 默认单线程,@concurrent 用于显式后台卸载,隔离一致性用于主 actor 类型。

    274k GitHub starsUsed in 3 repos~1.4k tokens
    MobileAuto-check passed
  • 在 Swift 中使用 actor 实现线程安全的数据持久化——基于内存缓存与文件支持的存储,通过设计消除数据竞争. An agent skill from affaan-m/ECC.

    274k GitHub starsUsed in 3 repos~871 tokens
    MobileAuto-check passed
  • Thread-safe data persistence in Swift using actors — in-memory cache with file-backed storage, eliminating data races by design.

    274k GitHub starsUsed in 4 repos~1.2k tokens
    MobileAuto-check passed
  • Swift Concurrency Expert

    davila7/claude-code-templates

    Review and fix Swift concurrency issues such as actor isolation and Sendable violations.

    32k GitHub starsUsed in 3 repos~1.1k tokens
    MobileAuto-check passed
  • Apify Actorization

    sickn33/agentic-awesome-skills

    Actorization converts existing software into reusable serverless applications compatible with the Apify platform.

    47k GitHub starsUsed in 2 repos~1.7k tokens
    Data & AnalyticsAuto-check passed

More from cursor/plugins

All 99 skills in this repo
  • Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    10k GitHub starsUsed in 9 repos~1.6k tokens
    Auto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    Auto-check passed
  • Official

    Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.

    10k GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • Official

    Applies four layers of technical-writing rules to docs, RFCs, readmes, PR descriptions and commit messages so a tired engineer follows them on the first read.

    10k GitHub starsUsed in 10 repos~2.4k tokens
    Auto-check passed
  • Advisor Mode

    cursor/plugins

    Official

    Adds a second, stronger model that the main agent consults before major decisions, when stuck and before finishing, controlled by /advisor commands.

    10k GitHub stars~2.6k tokensUpdated today
    Auto-check: notes
  • Official

    Prepare PRs for review by cleaning noisy history, improving PR descriptions, and adding reviewer guidance without changing code behavior.

    10k GitHub starsUsed in 3 repos~569 tokens
    Auto-check passed

Questions about Principle Separate Before Serializing Shared State

What does Principle Separate Before Serializing Shared State do?

Apply when concurrent actors might write to the same file, branch, key, or state object. Principle Separate Before Serializing Shared State is an agent skill from cursor/plugins, published by the product's own GitHub organization. Apply when concurrent actors might write to the same file, branch, key, or state object.

How do I install Principle Separate Before Serializing Shared State in Claude Code?

Run `npx skills add cursor/plugins --skill principle-separate-before-serializing-shared-state -a claude-code`. Or copy the skill folder (pstack/skills/principle-separate-before-serializing-shared-state in cursor/plugins) into .claude/skills/principle-separate-before-serializing-shared-state in your project. Claude Code loads it when a task matches its description.

How do I install Principle Separate Before Serializing Shared State in Codex?

Run `npx skills add cursor/plugins --skill principle-separate-before-serializing-shared-state -a codex`. Or copy the skill folder (pstack/skills/principle-separate-before-serializing-shared-state in cursor/plugins) into .agents/skills/principle-separate-before-serializing-shared-state in your project. Codex loads it when a task matches its description.

Can I use Principle Separate Before Serializing Shared State 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 cursor/plugins --skill principle-separate-before-serializing-shared-state -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/principle-separate-before-serializing-shared-state, .gemini/skills/principle-separate-before-serializing-shared-state, .github/skills/principle-separate-before-serializing-shared-state and .opencode/skills/principle-separate-before-serializing-shared-state in your project.

What does Principle Separate Before Serializing Shared State need to run?

SKILL.md names no scripts, command-line tools or credentials: Principle Separate Before Serializing Shared State is instructions for the agent only.

Does Principle Separate Before Serializing Shared State 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 Principle Separate Before Serializing Shared State 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 Principle Separate Before Serializing Shared State use?

No licence was found for Principle Separate Before Serializing Shared State or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Principle Separate Before Serializing Shared State use?

About 392 tokens (SKILL.md is roughly 1.6k 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 Principle Separate Before Serializing Shared State?

Skills that share tags, products or a category with Principle Separate Before Serializing Shared State: Swift Concurrency 6 2 (affaan-m/ECC, 274k stars), Swift Concurrency 6 2 (affaan-m/ECC, 274k stars), Swift Actor Persistence (affaan-m/ECC, 274k stars) and Swift Actor Persistence (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Principle Separate Before Serializing Shared State?

cursor (a GitHub organization, an official publisher) maintains it in cursor/plugins, which has 10,130 GitHub stars. The repository holds 99 skills in this directory. The repository was last updated on October 6, 2026.

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