[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ERC347YQFQHGKC5CVQJHGG":3,"skill-same:01M7ERC347YQFQHGKC5CVQJHGG":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":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7ERC347YQFQHGKC5CVQJHGG","create-formal-verification-skill",null,"Generate a project-local skill that formally verifies the code where a bug costs most and tests reach least. Use for 'model-check this race', 'prove this invariant', or concurrency, retries, state machines and parsers that need more than tests.","JoshuaHayesWasHere\u002Fjstack","JoshuaHayesWasHere","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F78288453?v=4","01M7EQPZP0GDYN3SYY9SZZHFJE","Joshua Hayes","01M7EQPZPQKJDZR99NG512A8X2",1,"MIT","https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack\u002Fblob\u002Fmain\u002Ffeatures\u002Fskill-library\u002Fskills\u002Fcreate-formal-verification-skill\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: create-formal-verification-skill\ndescription: \"Generate a project-local skill that formally verifies the code where a bug costs most and tests reach least. Use for 'model-check this race', 'prove this invariant', or concurrency, retries, state machines and parsers that need more than tests.\"\ntip: finds the part of the code where a bug costs most and tests reach least, and verifies it | model-check this race | prove this invariant | formally verify | formal verification\ncard: \"Distrust the change | 5 | Finds the part of the code where a bug costs the most and tests reach the least, verifies one property of it with the tool that fits, and leaves a project-local skill that rechecks it on every change. | Reach for it when a race, a retry, a state machine, a parser or unsafe code needs more than tests. | op: the operator\"\n---\n\n# Create a formal verification skill\n\nSource: pstack, `pstack\u002Fskills\u002Fcreate-formal-verification-skill\u002FSKILL.md`\n\nA test checks the cases that someone thought to write. Formal verification checks every case in a stated scope: every order of steps in a model, every input up to a bound, or every input. This skill finds the part of the repo where that matters most, verifies one property of it, and leaves a project-local skill that lets the next agent check a change against that property. Write that skill for an agent who reads it cold, mid-change, and has never seen your work. The user must be able to trust the result and act on it without learning the verification language.\n\n## Where it runs\n\nRun this in a durable thread, never in a subagent, whose context ends with its answer: the model, the checks and the scratch break take many turns, and the generated skill is the part that has to outlive them. A crewmate under a brief does all of it, in its own worktree, and every file this skill writes lands there. A scout under a brief may do the first two sections, read-only, and report the target, the tool and why, since a scout changes nothing in the repo: the crewmate that follows writes the verification, the skill and the proof. The Result (or the scout's Report) carries what the hand-off below asks for.\n\n## Choose the target from the code\n\nAnswer from the codebase, and ask the user only what you cannot observe. If the user named an area or a bug, start there.\n\nA good target is a promise the code makes, where a break harms users and tests rarely reach the case that breaks it. Choose the strongest such target in the repo, not the one that is easiest to verify.\n\n## Let the question choose the tool\n\nPick the tool that answers the question at the lowest cost: a model checker, a proof assistant, an SMT-backed verifier, or another tool.\nWhether events can happen in a bad order usually suits a model checker over a small model of the design, and TLA+ is the default for that in any language.\nWhether the code itself behaves for every input, as with memory safety, overflow, or a data-structure invariant, usually suits a verifier that runs on the code.\nIf no verifier runs on this language, say so, and test the real code with generated inputs, not a hand model of the function.\nA property that must hold at every size, where a bound is not enough, can need a proof.\nPrefer a tool that the repo's developers can install and run, and tell the user why you chose it.\n\n## What makes it good\n\n- **True to the code.** Every part of the model or proof points to code that a reviewer can open. What the verification treats as one indivisible step is one indivisible step in the code. Names come from this repo.\n- **Able to fail.** A check that you have never seen fail proves nothing. Show each property failing on a broken variant of the code it guards, such as a removed check or a reordered step.\n- **Findings stay findings.** When the current code breaks the property, report it with the counterexample in the code's terms. Do not weaken the property or the model until it passes, and do not change product code unless the user asks.\n- **Honest about scope.** Say what is verified, under which bounds and assumptions, and what is left out. A pass covers the model or the bound, not the whole system.\n- **Readable without the tool.** State the property and the harm in one plain sentence each. Tell a counterexample as a short sequence of steps in the code's words.\n- **Cheap to rerun.** One command, a reproducible tool version, and a run short enough that the next agent will use it on every relevant change.\n- **Kept in step with the code.**\n  Record which files and functions each check covers, and the commit at which you last confirmed that the verification describes them.\n  When the covered code changes after that commit, the next agent can see that the verification needs another look.\n\n## Generate the verify skill\n\nWrite a project-local skill with frontmatter that names the area and says when to use it.\nWithout frontmatter, the skill never registers.\nFrom the skill alone, the next agent must be able to tell whether a change touches the verified code, run the check, tell a real bug from a modeling error, and update the verification when a change is intended.\nPut the coverage record and the sync commit in the skill, and tell the next agent to move the sync commit forward only after it confirms that the verification describes the code at the new commit.\nUse this repo's real commands, paths, and nouns, and leave no placeholders.\nIn jstack the skill is a project skill of the feature that owns the verified code, `features\u002F\u003Cfeature>\u002Fproject-skill\u002Fverify-\u003Carea>\u002FSKILL.md`, named in that feature's `feature.json` under `projectSkills` as `features\u002Fjbus\u002Fproject-skill\u002Fverify-main-red` is, and `make trees` lists it in `skills.json`.\nThe install links it into a checkout's `.claude\u002Fskills` and `.cursor\u002Fskills`, and it is not under `skills\u002F`, which holds the skills that ship with jstack.\nIn another repo it goes in that repo's own project-skill folder.\n\n## Prove it before you hand off\n\nFollow the generated skill once, as the next agent would, on a scratch change that breaks the property in the real code. Make the scratch change in this thread's own worktree, never in the main checkout or in a worktree that another thread uses, and leave it uncommitted so that dropping it cannot reach a commit. It must catch the break. Then drop the scratch change (`git restore` the files it touched) and confirm that the check is back where it started: passing, or failing only on the findings you will report. A verify skill that was never run is a draft. If the skill misses the break or a step does not run, fix the skill or the verification, not the scratch change.\n\n## Hand off\n\nTell the user what you verified, which tool you used and why, the bounds, what the check found in plain words, how to run it, and what it does not cover.\nSuggest a second target only if you found a close one.\nPoint the user at `\u002Fmaintain-formal-verification-skill` for bringing the verification back in line after changes that did not recheck it.\n","# Create a formal verification skill\n\nSource: pstack, `pstack\u002Fskills\u002Fcreate-formal-verification-skill\u002FSKILL.md`\n\nA test checks the cases that someone thought to write. Formal verification checks every case in a stated scope: every order of steps in a model, every input up to a bound, or every input. This skill finds the part of the repo where that matters most, verifies one property of it, and leaves a project-local skill that lets the next agent check a change against that property. Write that skill for an agent who reads it cold, mid-change, and has never seen your work. The user must be able to trust the result and act on it without learning the verification language.\n\n## Where it runs\n\nRun this in a durable thread, never in a subagent, whose context ends with its answer: the model, the checks and the scratch break take many turns, and the generated skill is the part that has to outlive them. A crewmate under a brief does all of it, in its own worktree, and every file this skill writes lands there. A scout under a brief may do the first two sections, read-only, and report the target, the tool and why, since a scout changes nothing in the repo: the crewmate that follows writes the verification, the skill and the proof. The Result (or the scout's Report) carries what the hand-off below asks for.\n\n## Choose the target from the code\n\nAnswer from the codebase, and ask the user only what you cannot observe. If the user named an area or a bug, start there.\n\nA good target is a promise the code makes, where a break harms users and tests rarely reach the case that breaks it. Choose the strongest such target in the repo, not the one that is easiest to verify.\n\n## Let the question choose the tool\n\nPick the tool that answers the question at the lowest cost: a model checker, a proof assistant, an SMT-backed verifier, or another tool.\nWhether events can happen in a bad order usually suits a model checker over a small model of the design, and TLA+ is the default for that in any language.\nWhether the code itself behaves for every input, as with memory safety, overflow, or a data-structure invariant, usually suits a verifier that runs on the code.\nIf no verifier runs on this language, say so, and test the real code with generated inputs, not a hand model of the function.\nA property that must hold at every size, where a bound is not enough, can need a proof.\nPrefer a tool that the repo's developers can install and run, and tell the user why you chose it.\n\n## What makes it good\n\n- **True to the code.** Every part of the model or proof points to code that a reviewer can open. What the verification treats as one indivisible step is one indivisible step in the code. Names come from this repo.\n- **Able to fail.** A check that you have never seen fail proves nothing. Show each property failing on a broken variant of the code it guards, such as a removed check or a reordered step.\n- **Findings stay findings.** When the current code breaks the property, report it with the counterexample in the code's terms. Do not weaken the property or the model until it passes, and do not change product code unless the user asks.\n- **Honest about scope.** Say what is verified, under which bounds and assumptions, and what is left out. A pass covers the model or the bound, not the whole system.\n- **Readable without the tool.** State the property and the harm in one plain sentence each. Tell a counterexample as a short sequence of steps in the code's words.\n- **Cheap to rerun.** One command, a reproducible tool version, and a run short enough that the next agent will use it on every relevant change.\n- **Kept in step with the code.**\n  Record which files and functions each check covers, and the commit at which you last confirmed that the verification describes them.\n  When the covered code changes after that commit, the next agent can see that the verification needs another look.\n\n## Generate the verify skill\n\nWrite a project-local skill with frontmatter that names the area and says when to use it.\nWithout frontmatter, the skill never registers.\nFrom the skill alone, the next agent must be able to tell whether a change touches the verified code, run the check, tell a real bug from a modeling error, and update the verification when a change is intended.\nPut the coverage record and the sync commit in the skill, and tell the next agent to move the sync commit forward only after it confirms that the verification describes the code at the new commit.\nUse this repo's real commands, paths, and nouns, and leave no placeholders.\nIn jstack the skill is a project skill of the feature that owns the verified code, `features\u002F\u003Cfeature>\u002Fproject-skill\u002Fverify-\u003Carea>\u002FSKILL.md`, named in that feature's `feature.json` under `projectSkills` as `features\u002Fjbus\u002Fproject-skill\u002Fverify-main-red` is, and `make trees` lists it in `skills.json`.\nThe install links it into a checkout's `.claude\u002Fskills` and `.cursor\u002Fskills`, and it is not under `skills\u002F`, which holds the skills that ship with jstack.\nIn another repo it goes in that repo's own project-skill folder.\n\n## Prove it before you hand off\n\nFollow the generated skill once, as the next agent would, on a scratch change that breaks the property in the real code. Make the scratch change in this thread's own worktree, never in the main checkout or in a worktree that another thread uses, and leave it uncommitted so that dropping it cannot reach a commit. It must catch the break. Then drop the scratch change (`git restore` the files it touched) and confirm that the check is back where it started: passing, or failing only on the findings you will report. A verify skill that was never run is a draft. If the skill misses the break or a step does not run, fix the skill or the verification, not the scratch change.\n\n## Hand off\n\nTell the user what you verified, which tool you used and why, the bounds, what the check found in plain words, how to run it, and what it does not cover.\nSuggest a second target only if you found a close one.\nPoint the user at `\u002Fmaintain-formal-verification-skill` for bringing the verification back in line after changes that did not recheck it.\n",{"tip":24,"card":25,"name":5,"description":7},"finds the part of the code where a bug costs most and tests reach least, and verifies it | model-check this race | prove this invariant | formally verify | formal verification","Distrust the change | 5 | Finds the part of the code where a bug costs the most and tests reach the least, verifies one property of it with the tool that fits, and leaves a project-local skill that rechecks it on every change. | Reach for it when a race, a retry, a state machine, a parser or unsafe code needs more than tests. | op: the operator","main","daff051d2674b46e2eb8a333bbd3f3e40f8d1cea","features\u002Fskill-library\u002Fskills\u002Fcreate-formal-verification-skill",0,"https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack","https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere","Software Engineer @ Markel\r\n","2026-11-15 11:25:06",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add JoshuaHayesWasHere\u002Fjstack --skill create-formal-verification-skill",{"tool":40,"command":41},"bunx","bunx skills add JoshuaHayesWasHere\u002Fjstack --skill create-formal-verification-skill",{"tool":43,"command":44},"pnpm","pnpm dlx skills add JoshuaHayesWasHere\u002Fjstack --skill create-formal-verification-skill","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack\u002Fblob\u002Fmain\u002Ffeatures\u002Fskill-library\u002Fskills\u002Fcreate-formal-verification-skill\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},"01M7ERF9GXMY62V7QTVAR6G8DG","no-key","A skill its skills.json lists as hidden that a model may still call by itself, kept broken so the lint is seen to catch it.","https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack\u002Fblob\u002Fmain\u002Ftesting\u002Ftests\u002Ffixtures\u002Fskills\u002Fno-key\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},"01M7ERF83ZG3XKJ2SB8MJHCZ8H","fake-skill","A FAKE skill in a FAKE tree, named for its folder until the test renames the folder.","https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack\u002Fblob\u002Fmain\u002Ftesting\u002Ftests\u002Ffixtures\u002Fskills\u002Fnamed-tree\u002Fskills\u002Ffake-skill\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},"01M7ERF698RV4VF8QCDF8H8DA4","extra-key","A skill its skills.json does not list as hidden that a model still cannot call, kept broken so the lint is seen to catch it.","https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack\u002Fblob\u002Fmain\u002Ftesting\u002Ftests\u002Ffixtures\u002Fskills\u002Fextra-key\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},"01M7ERF2V8N73X9T0Y9PJ4SFV6","unslop","Cut AI tells from writing. Use when the user says text reads like AI, asks to unslop it, or before prose ships to people.","https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack\u002Fblob\u002Fmain\u002Ffeatures\u002Fwriting\u002Fskills\u002Funslop\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},"01M7EREWM67WX934XKABM4XCSZ","technical-writing","Write or review docs, READMEs, RFCs, PR descriptions and commit messages to a layered standard: Diataxis structure, Google developer style, STE rules and Global English.","https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack\u002Fblob\u002Fmain\u002Ffeatures\u002Fwriting\u002Fskills\u002Ftechnical-writing\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},"01M7EREMHJS9JY10AM5EKVX3GP","why","Find why code is the way it is, from its history and every evidence source this session can query, with citations. Use for 'why does X work this way', 'why did we pick Y', regressions and postmortems. Use how for runtime behavior.","https:\u002F\u002Fgithub.com\u002FJoshuaHayesWasHere\u002Fjstack\u002Fblob\u002Fmain\u002Ffeatures\u002Fwhy\u002FSKILL.md",[],[]]