[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DDC20K62P5VRPFF9FE32SN":3,"skill-same:01M7DDC20K62P5VRPFF9FE32SN":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":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7DDC20K62P5VRPFF9FE32SN","bise-testing",null,"Read before you write, change or delete a test in the bise repo. Says which test to write for what you check (a Bend law, a Rust unit test, a desktop feature test, a TUI render test, and an end-to-end test only when nothing else can see the break), where it goes, how to run it fast and its time budget. Use for every new test, every test fix, and every time you think \"I need an e2e for this\".","gvergnaud\u002Fbise","gvergnaud","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9265418?v=4","01M7DDBF4P9FC0JR6BJDMX1Q2J","Gabriel Vergnaud","01M7DDBF5FKMW0JNE71GV5SKBN",51,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fbise-testing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bise-testing\ndescription: Read before you write, change or delete a test in the bise repo. Says which test to write for what you check (a Bend law, a Rust unit test, a desktop feature test, a TUI render test, and an end-to-end test only when nothing else can see the break), where it goes, how to run it fast and its time budget. Use for every new test, every test fix, and every time you think \"I need an e2e for this\".\n---\n\n# bise-testing\n\nThe fast loop decides how fast we ship. An agent that waits 10 minutes for a\ncheck makes 6 tries an hour; at 10 seconds it makes 300. So every test you\nwrite must be as cheap as it can be while it still fails on the break.\n\nThe rule: **pick the cheapest test that can fail on the break.** End-to-end\ntests are slow, flaky and run only after the land: use one only for a path\nacross real processes that nothing else can see. Anything else gets a cheaper\ntest.\n\n## Which test\n\n| you want to check | the test | where | run it alone | budget |\n|---|---|---|---|---|\n| who is woken, told, queued; an invariant of the hub or the runtime | a Bend law and its proof | `bend\u002Flaws\u002F\u003Carea>.bend`, proof in `bend\u002Fproofs\u002F\u003Carea>.bend` | `python3 tests\u002Fproof_run.py . 4 $TMPDIR\u002Fproof` | a proofs file \u003C 30 s |\n| a pure function of a Rust crate (parse, pick, format, a state step) | a Rust unit test, next to the module | `rust\u002F\u003Ccrate>\u002Fsrc\u002F\u003Cmod>_tests.rs` or a `#[cfg(test)]` mod | `cd rust && cargo test -q -p \u003Ccrate> --lib \u003Cname>` | \u003C 1 s per test |\n| what the TUI draws for a state, a key's effect on its state | a TUI render test on ratatui's `TestBackend` (`sb::bench::test_app()`) | `rust\u002Ftui\u002Fsrc\u002F*_tests.rs` (e.g. `feed_render_tests.rs`) | `cd rust && cargo test -q -p bend-tui --lib \u003Cname>` | \u003C 1 s per test |\n| what a desktop screen shows and sends for given core\u002Fhub events and his gestures | a desktop feature test on typed inputs | `apps\u002Fdesktop\u002Ftests\u002Ffeature\u002F\u003Cscreen>.feature.test.ts` (`feature().given(...).does(...)`, then `view.\u003Cscreen>()` and `sent()`; inputs from `inputs.ts`, shaped like `rust\u002Fproto\u002Ffixtures`) | `pnpm -C apps\u002Fdesktop exec vitest run tests\u002Ffeature\u002F\u003Cfile>` | \u003C 1 s the file's tests |\n| a desktop pure module (a model, a sort, a reducer), a component | a vitest unit test, next to the module (a DOM one starts with `\u002F\u002F @vitest-environment happy-dom`) | `apps\u002Fdesktop\u002Fsrc\u002F**\u002F\u003Cmod>.test.ts(x)` | `pnpm -C apps\u002Fdesktop exec vitest run src\u002F\u003Cpath>.test.ts` | \u003C 1 s the file's tests |\n| the same fact drawn the same by the TUI and the window | one test: the same proto fixture into both renderers, the outputs compared | the feature test + the TUI's `TestBackend` | both commands above | as above |\n| a wire format between Rust, Bend and TS | a codec test on a fixture | `rust\u002Fproto\u002Ffixtures\u002F*.jsonl`, `rust\u002Fproto\u002Ftests\u002Fcore_fixtures.rs` | `cd rust && cargo test -q -p bise-proto` | \u003C 1 s per test |\n| a repo script (gate, heavy-run, pick, release tools) | a Python unit test with no process it does not own | `tests\u002F\u003Cscript>_test.py` | `python3 tests\u002F\u003Cscript>_test.py` | \u003C 5 s the file |\n| a path across real processes that nothing above can see (list below) | an end-to-end test | Playwright `apps\u002Fdesktop\u002Ftests\u002Fchecks\u002F`, `tests\u002F*_tmux.py`, `tests\u002F*_e2e.py`, as-he-does | not before a land: the tip gate runs it | \u003C 30 s each |\n\nThe quick gate (`tests\u002Fgate.sh quick`: seconds warm, minutes under load) runs the cheap layers of\nwhat you changed. Iterate with the single-test commands, then the quick gate,\nthen `sb land`.\n\n## When an end-to-end test is the right one\n\nA **KEEP** (docs\u002Ftest-plan-min.md's word): a real path across processes that\nno unit or integration test can see. Only these:\n\n- hub ↔ REPL ↔ TUI across a real socket or PTY (a message sent, delivered,\n  answered; a stall, a flood, an interrupt, a restart of one side);\n- app ↔ core ↔ hub (a real core process dies and comes back; nothing lost\n  across a quit and relaunch on the same userData);\n- install, update, release, version skew between an older and a newer side;\n- signing, the keychain, socket auth, the sandbox;\n- the window server and the Mac itself: notifications, the badge, keys, the\n  capsule, dictation, a real Electron frame and its CSP.\n\nEverything else is a **TRANSFORM**: what it asserts can be checked without\nlaunching the app, the hub or tmux. A screen fed with hub data is a feature\ntest on fixtures; the hub's decision is a law. A **DELETE** duplicates\nanother test or a law, or checks nothing that matters. Unsure between KEEP\nand something cheaper: ask yourself which process boundary the break lives\non. No boundary, no e2e. The kept list, test by test, is the KEEP rows of\ndocs\u002Ftest-plan-min.md; a new e2e test adds its row there with its reason.\n\nA pure look (a pixel, a gap, a color) is not a check: it goes to the\ndesigner's shots after the land, or comes back as a computed check of its\nown (a measured box in a feature test), never as a new Playwright spec.\n\n## Rules\n\n1. **No real world in a unit test**: no `sleep`, no real process, socket,\n   PTY, tmux, Electron, network or wall clock. Time is an input (`later(ms)`,\n   a clock you pass in); a process is a fake that answers from a fixture.\n2. **Time budget**: each test stays under its row's budget. Over it, make\n   it smaller or move its loop out (a fuzz or exhaustive run is cut to a\n   few hundred cases per commit; the full count runs on main, `FUZZ_RUNS`).\n3. **Each test fails on its break**: once, before you land it, break the\n   code it guards on purpose (flip a condition, drop a line) and see it go\n   red, then put the code back. Still green: fix the test until that break\n   turns it red; if it can't, delete it (never kept \"for coverage\"). Say\n   the mutation in your commit body.\n4. **Test what he sees or what crosses a seam**, through the module's own\n   function (a feature test reads `view.\u003Cscreen>()` and `sent()`), never a\n   copy of the logic re-derived in the test.\n5. **Fake data only**: fixtures, the fake provider, a throwaway hub. Never\n   the user's real accounts, hub or browser.\n6. **One fact, one place**: before you add a test, look for the law or the\n   test that already checks it (`rg` its words). A second check of the same\n   fact is a DELETE.\n7. **E2E only on main** (AGENTS.md, docs\u002Floop-speed.md §0 rule 11): before a\n   land, `tests\u002Fgate.sh quick` and nothing end-to-end, even when a brief\n   names one. The tip gate runs run_all's e2e and tmux tests on main's tip;\n   the desktop Playwright checks, their coverage map and as-he-does run in\n   the nightly and before a release, on its exact sha. Put your land sha in\n   your report and watch the tip gate's result for it. Red on your sha:\n   revert on main first, then fix and land again.\n8. **A flaky test is a bug**, never a retry loop or a longer sleep: find the\n   race (the order of two events, a clock) and make it an input. A line in\n   `tests\u002Fknown_reds.txt` needs a measured why (green alone at N load, or\n   the cause), an owner who agreed, and review-gates' sign; it leaves when\n   fixed. It is never where a red goes to be forgotten.\n9. **No UI words hard-coded past their count** (`tests\u002Fword_lint.py`): read\n   the word from the module that owns it.\n","# bise-testing\n\nThe fast loop decides how fast we ship. An agent that waits 10 minutes for a\ncheck makes 6 tries an hour; at 10 seconds it makes 300. So every test you\nwrite must be as cheap as it can be while it still fails on the break.\n\nThe rule: **pick the cheapest test that can fail on the break.** End-to-end\ntests are slow, flaky and run only after the land: use one only for a path\nacross real processes that nothing else can see. Anything else gets a cheaper\ntest.\n\n## Which test\n\n| you want to check | the test | where | run it alone | budget |\n|---|---|---|---|---|\n| who is woken, told, queued; an invariant of the hub or the runtime | a Bend law and its proof | `bend\u002Flaws\u002F\u003Carea>.bend`, proof in `bend\u002Fproofs\u002F\u003Carea>.bend` | `python3 tests\u002Fproof_run.py . 4 $TMPDIR\u002Fproof` | a proofs file \u003C 30 s |\n| a pure function of a Rust crate (parse, pick, format, a state step) | a Rust unit test, next to the module | `rust\u002F\u003Ccrate>\u002Fsrc\u002F\u003Cmod>_tests.rs` or a `#[cfg(test)]` mod | `cd rust && cargo test -q -p \u003Ccrate> --lib \u003Cname>` | \u003C 1 s per test |\n| what the TUI draws for a state, a key's effect on its state | a TUI render test on ratatui's `TestBackend` (`sb::bench::test_app()`) | `rust\u002Ftui\u002Fsrc\u002F*_tests.rs` (e.g. `feed_render_tests.rs`) | `cd rust && cargo test -q -p bend-tui --lib \u003Cname>` | \u003C 1 s per test |\n| what a desktop screen shows and sends for given core\u002Fhub events and his gestures | a desktop feature test on typed inputs | `apps\u002Fdesktop\u002Ftests\u002Ffeature\u002F\u003Cscreen>.feature.test.ts` (`feature().given(...).does(...)`, then `view.\u003Cscreen>()` and `sent()`; inputs from `inputs.ts`, shaped like `rust\u002Fproto\u002Ffixtures`) | `pnpm -C apps\u002Fdesktop exec vitest run tests\u002Ffeature\u002F\u003Cfile>` | \u003C 1 s the file's tests |\n| a desktop pure module (a model, a sort, a reducer), a component | a vitest unit test, next to the module (a DOM one starts with `\u002F\u002F @vitest-environment happy-dom`) | `apps\u002Fdesktop\u002Fsrc\u002F**\u002F\u003Cmod>.test.ts(x)` | `pnpm -C apps\u002Fdesktop exec vitest run src\u002F\u003Cpath>.test.ts` | \u003C 1 s the file's tests |\n| the same fact drawn the same by the TUI and the window | one test: the same proto fixture into both renderers, the outputs compared | the feature test + the TUI's `TestBackend` | both commands above | as above |\n| a wire format between Rust, Bend and TS | a codec test on a fixture | `rust\u002Fproto\u002Ffixtures\u002F*.jsonl`, `rust\u002Fproto\u002Ftests\u002Fcore_fixtures.rs` | `cd rust && cargo test -q -p bise-proto` | \u003C 1 s per test |\n| a repo script (gate, heavy-run, pick, release tools) | a Python unit test with no process it does not own | `tests\u002F\u003Cscript>_test.py` | `python3 tests\u002F\u003Cscript>_test.py` | \u003C 5 s the file |\n| a path across real processes that nothing above can see (list below) | an end-to-end test | Playwright `apps\u002Fdesktop\u002Ftests\u002Fchecks\u002F`, `tests\u002F*_tmux.py`, `tests\u002F*_e2e.py`, as-he-does | not before a land: the tip gate runs it | \u003C 30 s each |\n\nThe quick gate (`tests\u002Fgate.sh quick`: seconds warm, minutes under load) runs the cheap layers of\nwhat you changed. Iterate with the single-test commands, then the quick gate,\nthen `sb land`.\n\n## When an end-to-end test is the right one\n\nA **KEEP** (docs\u002Ftest-plan-min.md's word): a real path across processes that\nno unit or integration test can see. Only these:\n\n- hub ↔ REPL ↔ TUI across a real socket or PTY (a message sent, delivered,\n  answered; a stall, a flood, an interrupt, a restart of one side);\n- app ↔ core ↔ hub (a real core process dies and comes back; nothing lost\n  across a quit and relaunch on the same userData);\n- install, update, release, version skew between an older and a newer side;\n- signing, the keychain, socket auth, the sandbox;\n- the window server and the Mac itself: notifications, the badge, keys, the\n  capsule, dictation, a real Electron frame and its CSP.\n\nEverything else is a **TRANSFORM**: what it asserts can be checked without\nlaunching the app, the hub or tmux. A screen fed with hub data is a feature\ntest on fixtures; the hub's decision is a law. A **DELETE** duplicates\nanother test or a law, or checks nothing that matters. Unsure between KEEP\nand something cheaper: ask yourself which process boundary the break lives\non. No boundary, no e2e. The kept list, test by test, is the KEEP rows of\ndocs\u002Ftest-plan-min.md; a new e2e test adds its row there with its reason.\n\nA pure look (a pixel, a gap, a color) is not a check: it goes to the\ndesigner's shots after the land, or comes back as a computed check of its\nown (a measured box in a feature test), never as a new Playwright spec.\n\n## Rules\n\n1. **No real world in a unit test**: no `sleep`, no real process, socket,\n   PTY, tmux, Electron, network or wall clock. Time is an input (`later(ms)`,\n   a clock you pass in); a process is a fake that answers from a fixture.\n2. **Time budget**: each test stays under its row's budget. Over it, make\n   it smaller or move its loop out (a fuzz or exhaustive run is cut to a\n   few hundred cases per commit; the full count runs on main, `FUZZ_RUNS`).\n3. **Each test fails on its break**: once, before you land it, break the\n   code it guards on purpose (flip a condition, drop a line) and see it go\n   red, then put the code back. Still green: fix the test until that break\n   turns it red; if it can't, delete it (never kept \"for coverage\"). Say\n   the mutation in your commit body.\n4. **Test what he sees or what crosses a seam**, through the module's own\n   function (a feature test reads `view.\u003Cscreen>()` and `sent()`), never a\n   copy of the logic re-derived in the test.\n5. **Fake data only**: fixtures, the fake provider, a throwaway hub. Never\n   the user's real accounts, hub or browser.\n6. **One fact, one place**: before you add a test, look for the law or the\n   test that already checks it (`rg` its words). A second check of the same\n   fact is a DELETE.\n7. **E2E only on main** (AGENTS.md, docs\u002Floop-speed.md §0 rule 11): before a\n   land, `tests\u002Fgate.sh quick` and nothing end-to-end, even when a brief\n   names one. The tip gate runs run_all's e2e and tmux tests on main's tip;\n   the desktop Playwright checks, their coverage map and as-he-does run in\n   the nightly and before a release, on its exact sha. Put your land sha in\n   your report and watch the tip gate's result for it. Red on your sha:\n   revert on main first, then fix and land again.\n8. **A flaky test is a bug**, never a retry loop or a longer sleep: find the\n   race (the order of two events, a clock) and make it an input. A line in\n   `tests\u002Fknown_reds.txt` needs a measured why (green alone at N load, or\n   the cause), an owner who agreed, and review-gates' sign; it leaves when\n   fixed. It is never where a red goes to be forgotten.\n9. **No UI words hard-coded past their count** (`tests\u002Fword_lint.py`): read\n   the word from the module that owns it.\n",{"name":5,"description":7},"main","7c09ce329eff2caff1dc3e4d44dfd6c236a282ce",".agents\u002Fskills\u002Fbise-testing",9,"https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise","https:\u002F\u002Fbise.dev","https:\u002F\u002Fgithub.com\u002Fgvergnaud","https:\u002F\u002Ftype-level-typescript.com","Building agents at Mistral — Author of bise, type-level-typescript.com, TS-Pattern, HOTScript...","2026-11-15 04:07:17",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add gvergnaud\u002Fbise --skill bise-testing",{"tool":40,"command":41},"bunx","bunx skills add gvergnaud\u002Fbise --skill bise-testing",{"tool":43,"command":44},"pnpm","pnpm dlx skills add gvergnaud\u002Fbise --skill bise-testing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fbise-testing\u002FSKILL.md",true,[],[49,56,63,70,77,83],{"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},"01M7DDF53D28NXA17HZP08094A","greet","Greet someone the hello-plugin way. Use when asked for a hello-plugin greeting.","https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Frust\u002Fplugins\u002Ftests\u002Ffixtures\u002Fhello-plugin\u002Fskills\u002Fgreet\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},"01M7DDF3V0J5P7VEWAS7NM458P","triage","triage Linear issues","https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Frust\u002Fplugins\u002Ftests\u002Ffixtures\u002Fadd\u002Fcodex-linear\u002Fin\u002Fskills\u002Ftriage\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},"01M7DDF1EPY3GMFG4WG368B3Q8","jot","jot a note","https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Frust\u002Fplugins\u002Ftests\u002Ffixtures\u002Fadd\u002Fclaude-notes\u002Fin\u002Fskills\u002Fjot\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},"01M7DDETP44AE35MSDENY1THS9","bise-demo","Run bise's built-in demo, a short role-play where a small product team (a pm, a designer, a dev) starts, talks like colleagues, asks the user one question and one agent is dropped, with no file or git change. Use when the user asks to see what bise or you can do, for a demo, a tour or your features (show me what you can do, give me a demo, what can you do?, demo all your features), in any language.","https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fprompts\u002Fskills\u002Fbise-demo\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7DDERQ5JJHVR314X762FD5K","bise-pages","https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fprompts\u002Fskills-all\u002Fbise-pages\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7DDEMV9FHB1HTNWY9W5RXAZ","slides","Make, read or edit a PowerPoint deck (.pptx) - a review, a pitch, a status deck, slides with tables and charts - with a TypeScript script run by `bise office run`. Use when the user asks for slides, a deck or a pptx, sends one, or leaves notes on a pptx artifact.","https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fplugins\u002Fslides\u002Fskills\u002Fslides\u002FSKILL.md",[],[]]