[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ERX8D60RCEZMFFCHK0PDFW":3,"skill-same:01M7ERX8D60RCEZMFFCHK0PDFW":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":14,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7ERX8D60RCEZMFFCHK0PDFW","idempotent-operations",null,"Apply when designing commands, jobs, startup steps or processing loops that can crash, restart or be retried. Make every state-changing operation converge to the same end state however many times it runs and wherever the last run stopped.","Ventorius\u002Fven-stack","Ventorius","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F5689509?v=4","01M7ERRDPQ5YXCNXJZWEKQNP50","Sebastian Basznianin","01M7ERRDQ9S0ZD9YMH1RN1WVP7",0,"MIT","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fidempotent-operations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: idempotent-operations\ndescription: \"Apply when designing commands, jobs, startup steps or processing loops that can crash, restart or be retried. Make every state-changing operation converge to the same end state however many times it runs and wherever the last run stopped.\"\nmetadata:\n  layer: L2\n  source: cursor\u002Fplugins@1e5c90a:pstack\u002Fskills\u002Fprinciple-make-operations-idempotent\u002FSKILL.md\n  license: MIT\n---\n\n# Idempotent Operations\n\nDesign every state-changing operation to reach the same correct end state no matter how many times it runs or where a previous run stopped.\n\n**Why:** Commands, jobs, startup sequences and loops run where crashes, restarts, timeouts and retries are normal. If leftover partial state changes what the next run does, every restart becomes a debugging session and every retry risks doing the work twice.\n\n**Pattern:**\n- **Converge on start.** Look at what exists, clean up stale artifacts, adopt work that is still live, then continue. Never assume a blank slate.\n- **Key the work, not the attempt.** Give each unit of work a stable key derived from its input and record completion under it, so a repeat is a no-op.\n- **Compare by content.** Decide whether something is done or a duplicate by what it contains, not by creation order, timestamps or counters.\n- **Order the effect and its record** so a crash between them leads to a safe redo, never a lost or doubled effect.\n- **Reclaim stale locks.** A lock carries its owner and age, so one left by a dead process is taken over instead of blocking forever.\n- **Retry from the input.** Failed work restarts as a fresh attempt from its input, never from someone's half-written output.\n- **Set, don't add.** \"Set the count to 5\" survives a repeat; \"add 1\" does not.\n\n**The test:**\n1. What happens if this runs twice in a row?\n2. What happens if the last run died at each possible point?\n3. Does running it again always land in the same end state?\n\nIf any answer is \"it depends on what was left behind\", add a reconciliation step that reads the current state and moves it to the target.\n\n**Stop:** Some effects can't be repeated safely, like sending a message or calling a third party with no deduplication. Put those behind a recorded key and check the key before acting.\n","# Idempotent Operations\n\nDesign every state-changing operation to reach the same correct end state no matter how many times it runs or where a previous run stopped.\n\n**Why:** Commands, jobs, startup sequences and loops run where crashes, restarts, timeouts and retries are normal. If leftover partial state changes what the next run does, every restart becomes a debugging session and every retry risks doing the work twice.\n\n**Pattern:**\n- **Converge on start.** Look at what exists, clean up stale artifacts, adopt work that is still live, then continue. Never assume a blank slate.\n- **Key the work, not the attempt.** Give each unit of work a stable key derived from its input and record completion under it, so a repeat is a no-op.\n- **Compare by content.** Decide whether something is done or a duplicate by what it contains, not by creation order, timestamps or counters.\n- **Order the effect and its record** so a crash between them leads to a safe redo, never a lost or doubled effect.\n- **Reclaim stale locks.** A lock carries its owner and age, so one left by a dead process is taken over instead of blocking forever.\n- **Retry from the input.** Failed work restarts as a fresh attempt from its input, never from someone's half-written output.\n- **Set, don't add.** \"Set the count to 5\" survives a repeat; \"add 1\" does not.\n\n**The test:**\n1. What happens if this runs twice in a row?\n2. What happens if the last run died at each possible point?\n3. Does running it again always land in the same end state?\n\nIf any answer is \"it depends on what was left behind\", add a reconciliation step that reads the current state and moves it to the target.\n\n**Stop:** Some effects can't be repeated safely, like sending a message or calling a third party with no deduplication. Put those behind a recorded key and check the key before acting.\n",{"name":5,"metadata":24,"description":7},{"layer":25,"source":26,"license":15},"L2","cursor\u002Fplugins@1e5c90a:pstack\u002Fskills\u002Fprinciple-make-operations-idempotent\u002FSKILL.md","main","e57e3dd5c8aec0fe40658397aee9fd9b1d77bb60","plugins\u002Fven\u002Fskills\u002Fidempotent-operations","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack","https:\u002F\u002Fgithub.com\u002FVentorius","Heavy testing believer. Workflow automation fan. Fullstack JS developer.","2026-11-04 04:05:46",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Ventorius\u002Fven-stack --skill idempotent-operations",{"tool":40,"command":41},"bunx","bunx skills add Ventorius\u002Fven-stack --skill idempotent-operations",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Ventorius\u002Fven-stack --skill idempotent-operations","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fidempotent-operations\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7ES1P06ZPAGTT7YS4V6MS32","yeet","Take every local change green through the repo's own checks, slice it into conventional commits, push, and with --pr open a pull request on the code host. Use only when the user explicitly asks to yeet, or to commit and push everything; never on your own initiative.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7ES1JHVQEN3YYMRZEBM2E79","write-docs","Write or update documentation from the code: gather facts, pick the shape for the reader, write it plain, and prove every command and path in it. Use when asked to document a repo, module or feature, or to bring stale docs up to date.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fwrite-docs\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7ES1DD3YVMF1MY7D51R6516","why","Find why code is shaped the way it is (design rationale, trade-offs, regressions, odd thresholds) from history, tickets, docs and chat, citing every claim and stating its confidence. Use for 'why does X work this way', 'why did we pick Y', or before changing code whose purpose is unclear.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7ES18XVRZGQ0V1BBZH63Q8W","verify","Prove a change works with the check that matches its type, do the read-back, and log the pass against the exact tree. Use when a change is ready to call done, before review, commit or stopping, and whenever ven-decisions end refuses an unverified tree.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fverify\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7ES15Z3W8QTJH4CRAJ53D2G","unslop","Cut AI writing tells (filler, model vocabulary, metaphor nouns, hedging, formatting tics) from text while keeping every fact. Use when editing or checking any prose before it ships: docs, PR bodies, reports, skill text.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7ES12GT9WD9NE2X3M1B29ZZ","type-discipline","Apply when designing types or data shapes, reviewing a signature, or handling outside data, in any language. Make wrong states fail early: in the compiler for typed languages, in validated runtime contracts for untyped ones.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Ftype-discipline\u002FSKILL.md",[],[]]