skillwiki 0.10.30 → 0.10.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.30",
+  "version": "0.10.32",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js",

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.30",
+  "version": "0.10.32",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 19 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.30",
+  "version": "0.10.32",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 19 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.10.30",
+  "version": "0.10.32",
   "private": true,
   "files": [
     "wiki-*",
     "proj-*",
     "using-skillwiki",
     "skills",
+    "agents",
     ".claude-plugin",
     ".codex-plugin",
     "hooks",

package/skills/proj-decide/SKILL.md

@@ -8,10 +8,16 @@ description: Write an Architectural Decision Record (ADR). If the decision gener
 ## Model routing
 
 `proj-decide` authors architectural decisions and ADRs, so its companion
-agent must run at the invoking main-agent model. Keep `model: inherit` in
-`packages/skills/agents/proj-decide.md`; do not pin decision-making work to
-`sonnet`, `haiku`, or `opus`. Do not add a `model` field to this `SKILL.md`
-frontmatter.
+agent must run at the invoking main-agent model. Keep `model: inherit` in the
+plugin-root agent definition `agents/proj-decide.md` (repository canonical
+source: `packages/skills/agents/proj-decide.md`; root `agents/proj-decide.md` is
+a materialized install mirror). Do not pin decision-making work to `sonnet`,
+`haiku`, or `opus`. Do not add a `model` field to this `SKILL.md` frontmatter.
+
+After plugin install the runtime path is
+`<installed-plugin-root>/agents/proj-decide.md` (for example
+`~/.grok/installed-plugins/.../agents/proj-decide.md`). Refresh a stale Grok
+install with `grok plugin update skillwiki`, not `skillwiki install`.
 
 ## When to invoke
 - User commits to an architectural decision worth recording for future reference.

package/skills/proj-work/SKILL.md

@@ -8,9 +8,16 @@ description: Open or run a work item under projects/{slug}/work/YYYY-MM-DD-{slug
 ## Model routing
 
 `proj-work` authors implementation specifications and plans, so its companion
-agent must run at the invoking main-agent model. Keep `model: inherit` in
-`packages/skills/agents/proj-work.md`; do not pin planning work to `sonnet`,
-`haiku`, or `opus`. Do not add a `model` field to this `SKILL.md` frontmatter.
+agent must run at the invoking main-agent model. Keep `model: inherit` in the
+plugin-root agent definition `agents/proj-work.md` (repository canonical source:
+`packages/skills/agents/proj-work.md`; root `agents/proj-work.md` is a
+materialized install mirror). Do not pin planning work to `sonnet`, `haiku`, or
+`opus`. Do not add a `model` field to this `SKILL.md` frontmatter.
+
+After plugin install the runtime path is
+`<installed-plugin-root>/agents/proj-work.md` (for example
+`~/.grok/installed-plugins/.../agents/proj-work.md`). Refresh a stale Grok
+install with `grok plugin update skillwiki`, not `skillwiki install`.
 
 ## When to invoke
 - User starts a feature, issue, refactor, or decision inside an existing project.

package/skills/skills/proj-decide/SKILL.md

@@ -8,10 +8,16 @@ description: Write an Architectural Decision Record (ADR). If the decision gener
 ## Model routing
 
 `proj-decide` authors architectural decisions and ADRs, so its companion
-agent must run at the invoking main-agent model. Keep `model: inherit` in
-`packages/skills/agents/proj-decide.md`; do not pin decision-making work to
-`sonnet`, `haiku`, or `opus`. Do not add a `model` field to this `SKILL.md`
-frontmatter.
+agent must run at the invoking main-agent model. Keep `model: inherit` in the
+plugin-root agent definition `agents/proj-decide.md` (repository canonical
+source: `packages/skills/agents/proj-decide.md`; root `agents/proj-decide.md` is
+a materialized install mirror). Do not pin decision-making work to `sonnet`,
+`haiku`, or `opus`. Do not add a `model` field to this `SKILL.md` frontmatter.
+
+After plugin install the runtime path is
+`<installed-plugin-root>/agents/proj-decide.md` (for example
+`~/.grok/installed-plugins/.../agents/proj-decide.md`). Refresh a stale Grok
+install with `grok plugin update skillwiki`, not `skillwiki install`.
 
 ## When to invoke
 - User commits to an architectural decision worth recording for future reference.

package/skills/skills/proj-work/SKILL.md

@@ -8,9 +8,16 @@ description: Open or run a work item under projects/{slug}/work/YYYY-MM-DD-{slug
 ## Model routing
 
 `proj-work` authors implementation specifications and plans, so its companion
-agent must run at the invoking main-agent model. Keep `model: inherit` in
-`packages/skills/agents/proj-work.md`; do not pin planning work to `sonnet`,
-`haiku`, or `opus`. Do not add a `model` field to this `SKILL.md` frontmatter.
+agent must run at the invoking main-agent model. Keep `model: inherit` in the
+plugin-root agent definition `agents/proj-work.md` (repository canonical source:
+`packages/skills/agents/proj-work.md`; root `agents/proj-work.md` is a
+materialized install mirror). Do not pin planning work to `sonnet`, `haiku`, or
+`opus`. Do not add a `model` field to this `SKILL.md` frontmatter.
+
+After plugin install the runtime path is
+`<installed-plugin-root>/agents/proj-work.md` (for example
+`~/.grok/installed-plugins/.../agents/proj-work.md`). Refresh a stale Grok
+install with `grok plugin update skillwiki`, not `skillwiki install`.
 
 ## When to invoke
 - User starts a feature, issue, refactor, or decision inside an existing project.

package/skills/skills/using-skillwiki/SKILL.md

@@ -246,10 +246,12 @@ skillwiki has multiple distribution channels that can drift:
 | npm skills | `/usr/local/lib/node_modules/skillwiki/skills/` | `skillwiki install` only for standalone CLI skill copies; defers when the plugin channel is active |
 | Claude plugin | `~/.claude/plugins/cache/llm-wiki/` | `claude plugin update skillwiki@llm-wiki` |
 | Codex plugin | `~/.codex/plugins/cache/llm-wiki/` | `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed |
+| Grok plugin | `~/.grok/installed-plugins/` (marketplace cache under `~/.grok/marketplace-cache/`) | `grok plugin update skillwiki`, then start a new session or reload plugins |
 | Local git dev | source repo checkout | `npm link ./packages/cli` (from repo root) |
-**Check versions:** `skillwiki doctor` reports Plugin/CLI version mismatch warnings when installed channels disagree.
-**Plugin channel rule:** Plugin-managed skills are not refreshed with `skillwiki install`. When Claude or Codex plugin is installed and enabled, the plugin cache is the skill provider; `skillwiki install` is only a legacy/standalone copier for `~/.claude/skills/`.
-**Agent update rule:** Do not run `skillwiki install` just to refresh plugin-managed skills. If `skillwiki install` reports `deferred_to_plugin: true`, stop there and update the active plugin channel instead: Claude uses `claude plugin update skillwiki@llm-wiki`; Codex uses `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed. Only use `skillwiki install --force` when the user explicitly wants duplicate CLI-managed copies under `~/.claude/skills/` and accepts that `skillwiki doctor` may report overlap.
+**Check versions:** `skillwiki doctor` reports Plugin/CLI version mismatch warnings when installed channels disagree. For Grok, also inspect `~/.grok/installed-plugins/*/.claude-plugin/plugin.json` version and agent frontmatter under `agents/*.md`.
+**Plugin channel rule:** Plugin-managed skills and agents are not refreshed with `skillwiki install`. When Claude, Codex, or Grok plugin is installed and enabled, the plugin install root is the skill/agent provider; `skillwiki install` is only a legacy/standalone copier for `~/.claude/skills/`.
+**Agent path model:** Runtime agents live at `<plugin-root>/agents/<name>.md` (plugin-dev convention: `agents/` at the plugin root). In this repository the canonical sources are `packages/skills/agents/*.md`; root `agents/` is a materialized mirror for direct root installs. After install there is no `packages/skills/` nesting under the Grok install root — the install root is flattened and typically contains top-level skill folders, nested `skills/` (Codex-compat mirror), `agents/`, `hooks/`, `bin/`, and plugin manifests.
+**Agent update rule:** Do not run `skillwiki install` just to refresh plugin-managed skills or agents. If `skillwiki install` reports `deferred_to_plugin: true`, stop there and update the active plugin channel instead: Claude uses `claude plugin update skillwiki@llm-wiki`; Codex uses `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed; Grok uses `grok plugin update skillwiki`. Only use `skillwiki install --force` when the user explicitly wants duplicate CLI-managed copies under `~/.claude/skills/` and accepts that `skillwiki doctor` may report overlap.
 **Authoring rule:** `SKILL.md` frontmatter follows the Agent Skills schema: top-level `name` and `description` plus optional schema fields such as `metadata`. Do not put release version fields at the top level of `SKILL.md`; plugin and package release versions live in `plugin.json` and `package.json`.
 **Fix:** If developing locally, use the repo source plus `npm link`. If using released versions, update the relevant plugin or npm channel; do not infer release freshness from `SKILL.md` frontmatter.
 

package/skills/skills/using-skillwiki/activation.md

@@ -53,5 +53,6 @@ If `skillwiki doctor` mentions a version newer than this file, re-read the full
 
 ## Canonical Paths
 
-- Full skill: `packages/skills/using-skillwiki/SKILL.md`
+- Full skill (logical): invoke `/using-skillwiki` or read the installed plugin skill at `<plugin-root>/using-skillwiki/SKILL.md` (repository source: `packages/skills/using-skillwiki/SKILL.md`)
 - Vault schema: `SCHEMA.md` at the vault root (run `skillwiki path` to resolve)
+- Frontier agents (`proj-work`, `proj-decide`): plugin-root `agents/<name>.md` with `model: inherit` — refresh with the active plugin channel (`grok plugin update skillwiki` on Grok)

package/skills/using-skillwiki/SKILL.md

@@ -246,10 +246,12 @@ skillwiki has multiple distribution channels that can drift:
 | npm skills | `/usr/local/lib/node_modules/skillwiki/skills/` | `skillwiki install` only for standalone CLI skill copies; defers when the plugin channel is active |
 | Claude plugin | `~/.claude/plugins/cache/llm-wiki/` | `claude plugin update skillwiki@llm-wiki` |
 | Codex plugin | `~/.codex/plugins/cache/llm-wiki/` | `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed |
+| Grok plugin | `~/.grok/installed-plugins/` (marketplace cache under `~/.grok/marketplace-cache/`) | `grok plugin update skillwiki`, then start a new session or reload plugins |
 | Local git dev | source repo checkout | `npm link ./packages/cli` (from repo root) |
-**Check versions:** `skillwiki doctor` reports Plugin/CLI version mismatch warnings when installed channels disagree.
-**Plugin channel rule:** Plugin-managed skills are not refreshed with `skillwiki install`. When Claude or Codex plugin is installed and enabled, the plugin cache is the skill provider; `skillwiki install` is only a legacy/standalone copier for `~/.claude/skills/`.
-**Agent update rule:** Do not run `skillwiki install` just to refresh plugin-managed skills. If `skillwiki install` reports `deferred_to_plugin: true`, stop there and update the active plugin channel instead: Claude uses `claude plugin update skillwiki@llm-wiki`; Codex uses `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed. Only use `skillwiki install --force` when the user explicitly wants duplicate CLI-managed copies under `~/.claude/skills/` and accepts that `skillwiki doctor` may report overlap.
+**Check versions:** `skillwiki doctor` reports Plugin/CLI version mismatch warnings when installed channels disagree. For Grok, also inspect `~/.grok/installed-plugins/*/.claude-plugin/plugin.json` version and agent frontmatter under `agents/*.md`.
+**Plugin channel rule:** Plugin-managed skills and agents are not refreshed with `skillwiki install`. When Claude, Codex, or Grok plugin is installed and enabled, the plugin install root is the skill/agent provider; `skillwiki install` is only a legacy/standalone copier for `~/.claude/skills/`.
+**Agent path model:** Runtime agents live at `<plugin-root>/agents/<name>.md` (plugin-dev convention: `agents/` at the plugin root). In this repository the canonical sources are `packages/skills/agents/*.md`; root `agents/` is a materialized mirror for direct root installs. After install there is no `packages/skills/` nesting under the Grok install root — the install root is flattened and typically contains top-level skill folders, nested `skills/` (Codex-compat mirror), `agents/`, `hooks/`, `bin/`, and plugin manifests.
+**Agent update rule:** Do not run `skillwiki install` just to refresh plugin-managed skills or agents. If `skillwiki install` reports `deferred_to_plugin: true`, stop there and update the active plugin channel instead: Claude uses `claude plugin update skillwiki@llm-wiki`; Codex uses `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed; Grok uses `grok plugin update skillwiki`. Only use `skillwiki install --force` when the user explicitly wants duplicate CLI-managed copies under `~/.claude/skills/` and accepts that `skillwiki doctor` may report overlap.
 **Authoring rule:** `SKILL.md` frontmatter follows the Agent Skills schema: top-level `name` and `description` plus optional schema fields such as `metadata`. Do not put release version fields at the top level of `SKILL.md`; plugin and package release versions live in `plugin.json` and `package.json`.
 **Fix:** If developing locally, use the repo source plus `npm link`. If using released versions, update the relevant plugin or npm channel; do not infer release freshness from `SKILL.md` frontmatter.
 

package/skills/using-skillwiki/activation.md

@@ -53,5 +53,6 @@ If `skillwiki doctor` mentions a version newer than this file, re-read the full
 
 ## Canonical Paths
 
-- Full skill: `packages/skills/using-skillwiki/SKILL.md`
+- Full skill (logical): invoke `/using-skillwiki` or read the installed plugin skill at `<plugin-root>/using-skillwiki/SKILL.md` (repository source: `packages/skills/using-skillwiki/SKILL.md`)
 - Vault schema: `SCHEMA.md` at the vault root (run `skillwiki path` to resolve)
+- Frontier agents (`proj-work`, `proj-decide`): plugin-root `agents/<name>.md` with `model: inherit` — refresh with the active plugin channel (`grok plugin update skillwiki` on Grok)