[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DDDWWFGGFF49C2MRFQG2MH":3,"skill-same:01M7DDDWWFGGFF49C2MRFQG2MH":70},{"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},"01M7DDDWWFGGFF49C2MRFQG2MH","docs",null,"Make, read or edit a Word document (.docx) - a memo, a report, a contract, a letter - with comments, replies and tracked changes, through a TypeScript script run by `bise office run`. Use when the user asks for a Word doc or a docx, sends one to edit or review, or leaves notes on a docx artifact.","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\u002Fplugins\u002Fdocs\u002Fskills\u002Fdocs\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: docs\ndescription: Make, read or edit a Word document (.docx) - a memo, a report, a contract, a letter - with comments, replies and tracked changes, through a TypeScript script run by `bise office run`. Use when the user asks for a Word doc or a docx, sends one to edit or review, or leaves notes on a docx artifact.\n---\n\n# Docs (docx)\n\nYou write a short TypeScript script against `@bise\u002Foffice` and run it with\n`bise office run`. The script reads and writes the document; you never\nunzip or hand-edit XML. Each write of a file that is an artifact is its\nnext version, and the user sees it in the side panel.\n\n## Quick start\n\n```sh\nbise office inspect memo.docx    # the outline as JSON: paragraphs in order, with ids\nbise office check memo.docx      # the problems as JSON ([] when none)\nbise office run \"$TMPDIR\u002Fmemo.ts\"\n```\n\n```ts\n\u002F\u002F $TMPDIR\u002Fmemo.ts: an ES module, top-level await, no other import\nimport { docs, run } from \"@bise\u002Foffice\";\n\nconst doc = await docs.create({ title: \"Q3 memo\" });\ndoc.add({ kind: \"title\", text: \"Q3: revenue up 4%\" });\ndoc.add({ kind: \"para\", text: \"North carried the quarter; South was flat.\" });\ndoc.add({ kind: \"heading\", text: \"What we do next\", level: 1 });\ndoc.add({ kind: \"bullet\", text: \"Renewal plan for the three November accounts\" });\nconsole.log(JSON.stringify(doc.check()));\nconsole.log(await run.write(\"q3-memo.docx\", await doc.save(), { artifact: true }));\n```\n\n`{ artifact: true }` on the first write of a new file, so it shows in the\npanel; later writes to the same path are its next versions without it.\n\nThe script runs in a closed box: `run.read` and `run.write` reach your\nworktree and `$TMPDIR` only (a file elsewhere: `cp` it into `$TMPDIR`\nfirst), files up to 50 MB, 5 minutes, no network, no timers, no `fs`,\nno `process`. `console.log` prints a line. Keep scripts in `$TMPDIR`, not\nin the repo.\n\n## The loop\n\n1. **Inspect.** `bise office inspect \u003Cfile>`, `doc.inspect()`, or\n   `doc.text()` for the plain text. Each paragraph has an `id` (8 hex\n   digits, Word's own paragraph id) and an `anchor`; `props.style` says\n   Title, Heading1, ListParagraph...; a table is a `table` node with its\n   cells' paragraphs as children. `doc.find(\"4%\")` gives the anchors of a\n   phrase.\n2. **Edit by id.** `doc.at(anchor)` (or `doc.at({ kind: \"para\", para: id })`):\n   `setText`, `replace`, `insert`, `format`, `style`, `align`, `comment`,\n   `add` (a block after it), `remove`. Tables: `doc.table(anchor)`. Edits\n   keep the format of the text around them.\n3. **Save.** `await run.write(path, await doc.save())`, to the same path:\n   that path is the artifact. Print what `run.write` returns.\n4. **Check.** `doc.check()` before the write, `bise office check` after.\n5. **Fix** each `error` and `warning`: a TODO left in, a skipped heading\n   level, a tracked change left open, a table with a short row. Or say in\n   your reply why one stays.\n\nDone means: saved, checked, the problems fixed or named.\n\n## Edit his document: track it\n\nA document someone else wrote: make your edits tracked changes, so he\nsees each one in Word and accepts or rejects it. `doc.tracking = true`\nafter opening, or `{ track: true }` on one edit. Set `docs.open(bytes,\n{ author: \"bise\" })` so the changes say who made them. A document you made\nfor him from scratch: no tracking. Comments, replies, resolving, and\naccepting changes: `comments.md`.\n\n## Notes and selections from the user\n\nHe can point at a paragraph or words in it in the viewer. Two shapes\nreach you:\n\n- a message `you sent N notes on \"memo.docx\" (artifact \u003Cid> vN, ...)` with\n  an `\u003Cartifact-notes artifact=\"\u003Cid>\" version=\"N\">[...]\u003C\u002Fartifact-notes>`\n  block: a JSON list of `{id, anchor, text}`;\n- an `\u003Cartifact-selection artifact=\"\u003Cid>\" version=\"N\">` block inside his\n  own message: the first line is an anchor's JSON, the lines after are\n  what he saw selected.\n\nAn anchor here is `{\"kind\": \"para\", \"para\": \"3F2A1B0C\", \"quote\": \"up 4%\"}`.\nPass it as it is: `doc.at(anchor)` gives the paragraph, and `.quote` where\nhis words are in it; `format`, `comment` and `replace` work on that quote.\nIf Word renamed the paragraph's id, `at()` finds it by its quote. Do each\nnote, save once to the artifact's path (`sb artifact list` shows it), then\nreply one or two lines per note: what you changed, or why not. The new\nversion marks the notes done. `at()` throws `not_found` when the\nparagraph and its quote are both gone: say so.\n\n## Errors\n\nThe SDK throws `OfficeError` with a `code` and words that say what to do:\n`not_found`, `bad_arg` (it shows the shape it takes),\n`anchor_kind_mismatch`. A refused path names the folders you may use.\n\n## Read next\n\n- `api.md`: every call, its arguments, the outline's fields.\n- `recipes.md`: a memo from a brief, a table, edit his doc with tracked\n  changes, answer notes, replace a term everywhere.\n- `comments.md`: comments, replies, resolve; tracked changes, accept and\n  reject; reviewing a document.\n- `style.md`: how a document should read and look.\n- `check.md`: each problem code, what it means, how to fix it.\n","# Docs (docx)\n\nYou write a short TypeScript script against `@bise\u002Foffice` and run it with\n`bise office run`. The script reads and writes the document; you never\nunzip or hand-edit XML. Each write of a file that is an artifact is its\nnext version, and the user sees it in the side panel.\n\n## Quick start\n\n```sh\nbise office inspect memo.docx    # the outline as JSON: paragraphs in order, with ids\nbise office check memo.docx      # the problems as JSON ([] when none)\nbise office run \"$TMPDIR\u002Fmemo.ts\"\n```\n\n```ts\n\u002F\u002F $TMPDIR\u002Fmemo.ts: an ES module, top-level await, no other import\nimport { docs, run } from \"@bise\u002Foffice\";\n\nconst doc = await docs.create({ title: \"Q3 memo\" });\ndoc.add({ kind: \"title\", text: \"Q3: revenue up 4%\" });\ndoc.add({ kind: \"para\", text: \"North carried the quarter; South was flat.\" });\ndoc.add({ kind: \"heading\", text: \"What we do next\", level: 1 });\ndoc.add({ kind: \"bullet\", text: \"Renewal plan for the three November accounts\" });\nconsole.log(JSON.stringify(doc.check()));\nconsole.log(await run.write(\"q3-memo.docx\", await doc.save(), { artifact: true }));\n```\n\n`{ artifact: true }` on the first write of a new file, so it shows in the\npanel; later writes to the same path are its next versions without it.\n\nThe script runs in a closed box: `run.read` and `run.write` reach your\nworktree and `$TMPDIR` only (a file elsewhere: `cp` it into `$TMPDIR`\nfirst), files up to 50 MB, 5 minutes, no network, no timers, no `fs`,\nno `process`. `console.log` prints a line. Keep scripts in `$TMPDIR`, not\nin the repo.\n\n## The loop\n\n1. **Inspect.** `bise office inspect \u003Cfile>`, `doc.inspect()`, or\n   `doc.text()` for the plain text. Each paragraph has an `id` (8 hex\n   digits, Word's own paragraph id) and an `anchor`; `props.style` says\n   Title, Heading1, ListParagraph...; a table is a `table` node with its\n   cells' paragraphs as children. `doc.find(\"4%\")` gives the anchors of a\n   phrase.\n2. **Edit by id.** `doc.at(anchor)` (or `doc.at({ kind: \"para\", para: id })`):\n   `setText`, `replace`, `insert`, `format`, `style`, `align`, `comment`,\n   `add` (a block after it), `remove`. Tables: `doc.table(anchor)`. Edits\n   keep the format of the text around them.\n3. **Save.** `await run.write(path, await doc.save())`, to the same path:\n   that path is the artifact. Print what `run.write` returns.\n4. **Check.** `doc.check()` before the write, `bise office check` after.\n5. **Fix** each `error` and `warning`: a TODO left in, a skipped heading\n   level, a tracked change left open, a table with a short row. Or say in\n   your reply why one stays.\n\nDone means: saved, checked, the problems fixed or named.\n\n## Edit his document: track it\n\nA document someone else wrote: make your edits tracked changes, so he\nsees each one in Word and accepts or rejects it. `doc.tracking = true`\nafter opening, or `{ track: true }` on one edit. Set `docs.open(bytes,\n{ author: \"bise\" })` so the changes say who made them. A document you made\nfor him from scratch: no tracking. Comments, replies, resolving, and\naccepting changes: `comments.md`.\n\n## Notes and selections from the user\n\nHe can point at a paragraph or words in it in the viewer. Two shapes\nreach you:\n\n- a message `you sent N notes on \"memo.docx\" (artifact \u003Cid> vN, ...)` with\n  an `\u003Cartifact-notes artifact=\"\u003Cid>\" version=\"N\">[...]\u003C\u002Fartifact-notes>`\n  block: a JSON list of `{id, anchor, text}`;\n- an `\u003Cartifact-selection artifact=\"\u003Cid>\" version=\"N\">` block inside his\n  own message: the first line is an anchor's JSON, the lines after are\n  what he saw selected.\n\nAn anchor here is `{\"kind\": \"para\", \"para\": \"3F2A1B0C\", \"quote\": \"up 4%\"}`.\nPass it as it is: `doc.at(anchor)` gives the paragraph, and `.quote` where\nhis words are in it; `format`, `comment` and `replace` work on that quote.\nIf Word renamed the paragraph's id, `at()` finds it by its quote. Do each\nnote, save once to the artifact's path (`sb artifact list` shows it), then\nreply one or two lines per note: what you changed, or why not. The new\nversion marks the notes done. `at()` throws `not_found` when the\nparagraph and its quote are both gone: say so.\n\n## Errors\n\nThe SDK throws `OfficeError` with a `code` and words that say what to do:\n`not_found`, `bad_arg` (it shows the shape it takes),\n`anchor_kind_mismatch`. A refused path names the folders you may use.\n\n## Read next\n\n- `api.md`: every call, its arguments, the outline's fields.\n- `recipes.md`: a memo from a brief, a table, edit his doc with tracked\n  changes, answer notes, replace a term everywhere.\n- `comments.md`: comments, replies, resolve; tracked changes, accept and\n  reject; reviewing a document.\n- `style.md`: how a document should read and look.\n- `check.md`: each problem code, what it means, how to fix it.\n",{"name":5,"description":7},"main","7c09ce329eff2caff1dc3e4d44dfd6c236a282ce","plugins\u002Fdocs\u002Fskills\u002Fdocs",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 docs",{"tool":40,"command":41},"bunx","bunx skills add gvergnaud\u002Fbise --skill docs",{"tool":43,"command":44},"pnpm","pnpm dlx skills add gvergnaud\u002Fbise --skill docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fplugins\u002Fdocs\u002Fskills\u002Fdocs\u002FSKILL.md",true,[48,54,58,62,66],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"api.md","REFERENCE","参考文档",6038,"https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fplugins\u002Fdocs\u002Fskills\u002Fdocs\u002Fapi.md",{"path":55,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":56,"sourceHtmlUrl":57},"check.md",2926,"https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fplugins\u002Fdocs\u002Fskills\u002Fdocs\u002Fcheck.md",{"path":59,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":60,"sourceHtmlUrl":61},"comments.md",3022,"https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fplugins\u002Fdocs\u002Fskills\u002Fdocs\u002Fcomments.md",{"path":63,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":64,"sourceHtmlUrl":65},"recipes.md",5065,"https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fplugins\u002Fdocs\u002Fskills\u002Fdocs\u002Frecipes.md",{"path":67,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":68,"sourceHtmlUrl":69},"style.md",2489,"https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fplugins\u002Fdocs\u002Fskills\u002Fdocs\u002Fstyle.md",[71,78,85,92,99,105],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"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":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"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":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"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":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"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":100,"name":101,"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":102,"categories":103,"keywords":104,"publishedAt":19},"01M7DDERQ5JJHVR314X762FD5K","bise-pages","https:\u002F\u002Fgithub.com\u002Fgvergnaud\u002Fbise\u002Fblob\u002Fmain\u002Fprompts\u002Fskills-all\u002Fbise-pages\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"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",[],[]]