[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DGP9FCA72GJ976CF0NE3XA":3,"skill-same:01M7DGP9FCA72GJ976CF0NE3XA":46},{"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":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7DGP9FCA72GJ976CF0NE3XA","zakwas",null,"Use when the user wants to add or remove an agent plugin, permission rule, MCP server, Homebrew package or mise tool pin, or when you are about to edit agent config (~\u002F.claude, ~\u002F.codex, ~\u002F.config\u002Fopencode, ~\u002F.agents, ~\u002F.gemini, ~\u002F.copilot), zakwas.yaml, a Brewfile or a mise config. zakwas manages these files; change them by proposing, never by editing.","Automaat\u002Fzakwas","Automaat","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9156357?v=4","01M7DGP2YPHEHJZQB2X8JDDV52","Marcin Skalski","01M7DGP2ZG426NXFTCN2ECHX6J",0,"MIT","https:\u002F\u002Fgithub.com\u002FAutomaat\u002Fzakwas\u002Fblob\u002Fmain\u002Fplugins\u002Fzakwas\u002Fskills\u002Fzakwas\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: zakwas\ndescription: Use when the user wants to add or remove an agent plugin, permission rule, MCP server, Homebrew package or mise tool pin, or when you are about to edit agent config (~\u002F.claude, ~\u002F.codex, ~\u002F.config\u002Fopencode, ~\u002F.agents, ~\u002F.gemini, ~\u002F.copilot), zakwas.yaml, a Brewfile or a mise config. zakwas manages these files; change them by proposing, never by editing.\n---\n\n# zakwas\n\nzakwas converges this machine (macOS or Linux) to a `zakwas.yaml` in a config repo. It owns agent settings, plugins, permissions, MCP servers, hooks, Brewfile entries and mise pins. A hand edit to a managed file is reverted by the next `zakwas apply`, and agents are denied `apply`. Propose the change instead; the user approves it.\n\n## Never\n\n- Edit agent config: `~\u002F.claude\u002Fsettings.json`, `~\u002F.claude.json`, `~\u002F.codex\u002Fconfig.toml`, `~\u002F.codex\u002Frules\u002F`, `~\u002F.config\u002Fopencode\u002Fopencode.json`, `~\u002F.agents\u002F`, `~\u002F.gemini\u002F`, `~\u002F.copilot\u002F`.\n- Edit `zakwas.yaml`, the Brewfile or the mise config in the config repo.\n- Run `zakwas apply`, `upgrade`, `approve`, `self-update`, `mcp` or `layer`. The guard denies them, and a workaround (`sh -c`, a script, another tool) defeats the point of the approval.\n- Run `claude plugin install`, `codex plugin add`, `brew install`, `mise use` or similar to get the same result outside zakwas.\n\n## Propose a change\n\n1. Read the current state: `zakwas_config` (its `layers` lists the registered local layers) and `zakwas_plan`, or `zakwas plan` in a shell. Skip an operation the config already covers.\n2. Save related changes as one proposal: call `zakwas_propose` with `{\"ops\": [operation, ...]}`, or run `zakwas propose -json batch operations.json` (a JSON array; `-` reads stdin). Each target may be edited only once; order a new marketplace before its plugins. The whole batch gets one diff, plan and risk tier, and any high-risk operation requires terminal approval. Single changes retain their existing form. Prefer the MCP tool `zakwas_propose`; without the zakwas MCP server, run `zakwas propose -json OPERATION ...` in a shell. Proposing changes nothing on disk except the saved proposal.\n3. Report the proposal's `id`, `tier`, `summary` and `reasons` to the user, then follow the tier below.\n4. Remove a proposal the user no longer wants with `zakwas_discard`, or `zakwas proposals` to list them.\n5. To record what the user installed or approved in an agent by hand, call `zakwas_capture` (or `zakwas capture` in a shell) and pass the `ops` it returns as `{\"ops\": [...]}` to `zakwas_propose` for one proposal; the user can also run `zakwas capture --write` for one proposal. Never copy a value the scan skipped as a credential.\n6. Say \"proposed\", not \"installed\", until the user has applied it. Confirm afterwards with `zakwas_check`.\n\n| Operation | MCP `kind` | Shell |\n|---|---|---|\n| add a plugin marketplace | `add-marketplace`, `name`, `source` | `zakwas propose add-marketplace NAME SOURCE` |\n| add an agent plugin | `add-plugin`, `name: NAME@MARKETPLACE` | `zakwas propose add-plugin NAME@MARKETPLACE` |\n| add a permission rule | `add-permission`, `decision`, `command` | `zakwas propose add-permission allow\\|review\\|deny COMMAND...` |\n| remove a permission rule | `remove-permission`, `decision`, `command` | `zakwas propose remove-permission allow\\|review\\|deny COMMAND...` |\n| add a Homebrew package | `add-brew`, `name`, `cask` | `zakwas propose add-brew NAME [--cask]` |\n| pin a mise tool | `pin-mise`, `name`, `version` | `zakwas propose pin-mise TOOL VERSION` |\n| add an MCP server | `add-mcp`, `name`, `server` | `zakwas propose add-mcp NAME --command CMD [--arg A] \\| --url URL [--oauth-client-id ID [--oauth-callback-port PORT] [--oauth-scope SCOPES]]` |\n\nAn `add-mcp` server with a pre-registered OAuth client takes `server.oauth` with `client_id` and optionally `callback_port` and `scope`. Never pass a client secret; there is no field for one.\n\n## Layers\n\nA machine may have local layers: extra config repos (a work repo next to a private one) merged into the config. Propose into the right repo:\n\n- Pass `layer` (MCP) or `--layer NAME` (shell, before the operation) to send an addition to that layer's `zakwas.yaml`, to the Brewfile it sets with `brew.file` or to the mise config it sets with `mise.config`. Without it an addition goes to the main config's repo. In `{\"ops\": [...]}`, a top-level `layer` is the default for the operations that name none.\n- Ask which repo the user means when the entry could live in either, such as a work-only plugin or tool: a layer name never comes from your guess.\n- A removal or a version bump needs no `layer`: it goes to the file that holds the entry. Naming a different layer than the one that holds it is refused.\n- One proposal edits one repo: the main config's or a single layer's. Propose the halves of a mixed change separately.\n- The proposal's `layer` field shows where it goes, and `zakwas approve ID` commits there. A layer name that isn't in `zakwas_config` fails with a one-line error: report it, do not register the layer (`zakwas layer` is denied to you).\n- A main-config plugin cannot come from a marketplace only a layer declares: add the plugin to that layer.\n\n`providers` limits an entry to some of `claude`, `codex`, `opencode`, `gemini` and `copilot`; leave it out unless the user names one. In the shell form, put every flag of zakwas (`-json`, `-c PATH`, `--providers`) before `--`, and every dash-prefixed word of a command after it: `zakwas propose -json add-permission review -- git log --oneline`.\n\n## Tiers\n\n- `low`: the plan touches nothing sensitive. If the MCP server offers `zakwas_apply`, call it with the id; zakwas shows the user a form with the diff and plan, and only a yes applies it. Without that tool, give the user the command below.\n- `high`: only a person at a terminal applies it. Give the user this command and stop; never call `zakwas_apply` for it and never retry with a different operation to get a lower tier:\n\n  ```\n  zakwas approve ID\n  ```\n\n- When the proposal result has a `next` field, relay its command to the user as written.\n- Add a plugin only from a marketplace already in `zakwas.yaml`; `zakwas_config` shows it. `allow` rules, casks, tap formulae, mise backend tools, marketplaces and MCP servers are always `high`.\n\n## When a proposal is refused\n\n- Marketplace not declared, flow-style YAML (`plugins: [a@m]`), a duplicate entry or an invalid result: tell the user the exact reason and the edit they would need to make in `zakwas.yaml`. Do not make it.\n- Layer not registered, a layer without `brew.file` or `mise.config` for a package or tool, or an entry held by another layer: tell the user the exact reason; registering a layer or setting its file is their edit.\n- No operation covers the request (a hook, a profile): describe the `zakwas.yaml` change and let the user make it.\n- A proposal older than 7 days expires; propose again.\n","# zakwas\n\nzakwas converges this machine (macOS or Linux) to a `zakwas.yaml` in a config repo. It owns agent settings, plugins, permissions, MCP servers, hooks, Brewfile entries and mise pins. A hand edit to a managed file is reverted by the next `zakwas apply`, and agents are denied `apply`. Propose the change instead; the user approves it.\n\n## Never\n\n- Edit agent config: `~\u002F.claude\u002Fsettings.json`, `~\u002F.claude.json`, `~\u002F.codex\u002Fconfig.toml`, `~\u002F.codex\u002Frules\u002F`, `~\u002F.config\u002Fopencode\u002Fopencode.json`, `~\u002F.agents\u002F`, `~\u002F.gemini\u002F`, `~\u002F.copilot\u002F`.\n- Edit `zakwas.yaml`, the Brewfile or the mise config in the config repo.\n- Run `zakwas apply`, `upgrade`, `approve`, `self-update`, `mcp` or `layer`. The guard denies them, and a workaround (`sh -c`, a script, another tool) defeats the point of the approval.\n- Run `claude plugin install`, `codex plugin add`, `brew install`, `mise use` or similar to get the same result outside zakwas.\n\n## Propose a change\n\n1. Read the current state: `zakwas_config` (its `layers` lists the registered local layers) and `zakwas_plan`, or `zakwas plan` in a shell. Skip an operation the config already covers.\n2. Save related changes as one proposal: call `zakwas_propose` with `{\"ops\": [operation, ...]}`, or run `zakwas propose -json batch operations.json` (a JSON array; `-` reads stdin). Each target may be edited only once; order a new marketplace before its plugins. The whole batch gets one diff, plan and risk tier, and any high-risk operation requires terminal approval. Single changes retain their existing form. Prefer the MCP tool `zakwas_propose`; without the zakwas MCP server, run `zakwas propose -json OPERATION ...` in a shell. Proposing changes nothing on disk except the saved proposal.\n3. Report the proposal's `id`, `tier`, `summary` and `reasons` to the user, then follow the tier below.\n4. Remove a proposal the user no longer wants with `zakwas_discard`, or `zakwas proposals` to list them.\n5. To record what the user installed or approved in an agent by hand, call `zakwas_capture` (or `zakwas capture` in a shell) and pass the `ops` it returns as `{\"ops\": [...]}` to `zakwas_propose` for one proposal; the user can also run `zakwas capture --write` for one proposal. Never copy a value the scan skipped as a credential.\n6. Say \"proposed\", not \"installed\", until the user has applied it. Confirm afterwards with `zakwas_check`.\n\n| Operation | MCP `kind` | Shell |\n|---|---|---|\n| add a plugin marketplace | `add-marketplace`, `name`, `source` | `zakwas propose add-marketplace NAME SOURCE` |\n| add an agent plugin | `add-plugin`, `name: NAME@MARKETPLACE` | `zakwas propose add-plugin NAME@MARKETPLACE` |\n| add a permission rule | `add-permission`, `decision`, `command` | `zakwas propose add-permission allow\\|review\\|deny COMMAND...` |\n| remove a permission rule | `remove-permission`, `decision`, `command` | `zakwas propose remove-permission allow\\|review\\|deny COMMAND...` |\n| add a Homebrew package | `add-brew`, `name`, `cask` | `zakwas propose add-brew NAME [--cask]` |\n| pin a mise tool | `pin-mise`, `name`, `version` | `zakwas propose pin-mise TOOL VERSION` |\n| add an MCP server | `add-mcp`, `name`, `server` | `zakwas propose add-mcp NAME --command CMD [--arg A] \\| --url URL [--oauth-client-id ID [--oauth-callback-port PORT] [--oauth-scope SCOPES]]` |\n\nAn `add-mcp` server with a pre-registered OAuth client takes `server.oauth` with `client_id` and optionally `callback_port` and `scope`. Never pass a client secret; there is no field for one.\n\n## Layers\n\nA machine may have local layers: extra config repos (a work repo next to a private one) merged into the config. Propose into the right repo:\n\n- Pass `layer` (MCP) or `--layer NAME` (shell, before the operation) to send an addition to that layer's `zakwas.yaml`, to the Brewfile it sets with `brew.file` or to the mise config it sets with `mise.config`. Without it an addition goes to the main config's repo. In `{\"ops\": [...]}`, a top-level `layer` is the default for the operations that name none.\n- Ask which repo the user means when the entry could live in either, such as a work-only plugin or tool: a layer name never comes from your guess.\n- A removal or a version bump needs no `layer`: it goes to the file that holds the entry. Naming a different layer than the one that holds it is refused.\n- One proposal edits one repo: the main config's or a single layer's. Propose the halves of a mixed change separately.\n- The proposal's `layer` field shows where it goes, and `zakwas approve ID` commits there. A layer name that isn't in `zakwas_config` fails with a one-line error: report it, do not register the layer (`zakwas layer` is denied to you).\n- A main-config plugin cannot come from a marketplace only a layer declares: add the plugin to that layer.\n\n`providers` limits an entry to some of `claude`, `codex`, `opencode`, `gemini` and `copilot`; leave it out unless the user names one. In the shell form, put every flag of zakwas (`-json`, `-c PATH`, `--providers`) before `--`, and every dash-prefixed word of a command after it: `zakwas propose -json add-permission review -- git log --oneline`.\n\n## Tiers\n\n- `low`: the plan touches nothing sensitive. If the MCP server offers `zakwas_apply`, call it with the id; zakwas shows the user a form with the diff and plan, and only a yes applies it. Without that tool, give the user the command below.\n- `high`: only a person at a terminal applies it. Give the user this command and stop; never call `zakwas_apply` for it and never retry with a different operation to get a lower tier:\n\n  ```\n  zakwas approve ID\n  ```\n\n- When the proposal result has a `next` field, relay its command to the user as written.\n- Add a plugin only from a marketplace already in `zakwas.yaml`; `zakwas_config` shows it. `allow` rules, casks, tap formulae, mise backend tools, marketplaces and MCP servers are always `high`.\n\n## When a proposal is refused\n\n- Marketplace not declared, flow-style YAML (`plugins: [a@m]`), a duplicate entry or an invalid result: tell the user the exact reason and the edit they would need to make in `zakwas.yaml`. Do not make it.\n- Layer not registered, a layer without `brew.file` or `mise.config` for a package or tool, or an entry held by another layer: tell the user the exact reason; registering a layer or setting its file is their edit.\n- No operation covers the request (a hook, a profile): describe the `zakwas.yaml` change and let the user make it.\n- A proposal older than 7 days expires; propose again.\n",{"name":5,"description":7},"main","80a41cd13c6a15802002aaa86413881b97730cce","plugins\u002Fzakwas\u002Fskills\u002Fzakwas","https:\u002F\u002Fgithub.com\u002FAutomaat\u002Fzakwas","https:\u002F\u002Fgithub.com\u002FAutomaat","mskalski.dev","I am Software Engineer. I am passionate about infrastructure and networking, especially Service Mesh. ","2026-11-14 03:46:47",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add Automaat\u002Fzakwas --skill zakwas",{"tool":38,"command":39},"bunx","bunx skills add Automaat\u002Fzakwas --skill zakwas",{"tool":41,"command":42},"pnpm","pnpm dlx skills add Automaat\u002Fzakwas --skill zakwas","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FAutomaat\u002Fzakwas\u002Fblob\u002Fmain\u002Fplugins\u002Fzakwas\u002Fskills\u002Fzakwas\u002FSKILL.md",true,[],[47,54],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7DGP7CZVB13C9AB1V6N31XH","review","Review a diff for bugs, missing tests and unclear names. Use when asked to review a change.","https:\u002F\u002Fgithub.com\u002FAutomaat\u002Fzakwas\u002Fblob\u002Fmain\u002Fexamples\u002Fdotfiles\u002Fagents\u002Fskills\u002Freview\u002FSKILL.md",[],[],{"skillNo":55,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7DGP59ABP3ZD3KSY4SCEZK0","https:\u002F\u002Fgithub.com\u002FAutomaat\u002Fzakwas\u002Fblob\u002Fmain\u002Fdocs\u002Fdemo\u002Fagents\u002Fskills\u002Freview\u002FSKILL.md",[],[]]