skillwiki 0.8.1 → 0.8.2

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 18 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.8.1",
+  "version": "0.8.2",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 18 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "private": true,
   "files": [
     "wiki-*",

package/skills/proj-decide/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: proj-decide
 description: Write an Architectural Decision Record (ADR). If the decision generalizes, also create a concepts/ page.
 ---

package/skills/proj-distill/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: proj-distill
 description: 2-step distillation (E4) — analyze project compound entry, then generate a vault concept page with provenance.
 ---

package/skills/proj-init/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: proj-init
 description: Bootstrap a project workspace at projects/{slug}/ with README, requirements/, architecture/, work/, compound/.
 ---

package/skills/proj-work/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: proj-work
 description: Open or run a work item under projects/{slug}/work/YYYY-MM-DD-{slug}/. Redirects brainstorming/writing-plans output paths.
 ---

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

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: proj-decide
 description: Write an Architectural Decision Record (ADR). If the decision generalizes, also create a concepts/ page.
 ---

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

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: proj-distill
 description: 2-step distillation (E4) — analyze project compound entry, then generate a vault concept page with provenance.
 ---

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

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: proj-init
 description: Bootstrap a project workspace at projects/{slug}/ with README, requirements/, architecture/, work/, compound/.
 ---

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

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: proj-work
 description: Open or run a work item under projects/{slug}/work/YYYY-MM-DD-{slug}/. Redirects brainstorming/writing-plans output paths.
 ---

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

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: using-skillwiki
 description: Invoke at session start or when knowledge-base tasks arise — maps skillwiki skills, dev-loop alignment, and PRD/TDD routing with plan-mode gate checks
 ---
@@ -122,16 +121,17 @@ For longer-running project work, use `proj-init` → `proj-work` → `proj-disti
 Maintenance: **Archive** (`wiki-archive`) superseded pages, **Drift** (`wiki-reingest`) to detect stale sources, **Adapter** (`wiki-adapter-prd`) for foreign PRD format ingestion.
 
 ## Troubleshooting Version Drift
-skillwiki has three distribution channels that can drift:
+skillwiki has multiple distribution channels that can drift:
 | Channel | Location | Update Command |
 |---------|----------|----------------|
 | npm CLI | `/usr/local/bin/skillwiki` | `npm install -g skillwiki@latest` |
 | npm skills | `/usr/local/lib/node_modules/skillwiki/skills/` | `skillwiki install` (copies to `~/.claude/skills/`) |
 | Claude plugin | `~/.claude/plugins/cache/llm-wiki/` | `claude plugin update skillwiki@llm-wiki` |
-| Local git dev | `~/.hermes/skills/llm-wiki/` | `npm link ./packages/cli` (from repo root) |
-**Check versions:** `skillwiki doctor` reports "Plugin/CLI version" mismatch warnings.
-**Common issue:** npm package ships SKILL.md files with older `version:` frontmatter than CLI code. This creates false-positive "version warnings" in `skillwiki doctor` — the CLI is newer but skills report older version.
-**Fix:** If developing locally, use `npm link` from the git repo. If using released versions, wait for maintainer to bump SKILL.md versions in source and republish.
+| Codex plugin | `~/.codex/plugins/cache/llm-wiki/` | `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed |
+| 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.
+**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.
 
 ## Multi-Wiki Profiles
 skillwiki supports named wiki profiles for working with multiple vaults. Set `WIKI_DEFAULT` to control which wiki all skills target by default.

package/skills/skills/wiki-adapter-prd/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-adapter-prd
 description: Map foreign PRD formats (CodeStable, RFCs, structured markdown) into skillwiki raw + typed-knowledge pages.
 ---

package/skills/skills/wiki-add-task/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: wiki-add-task
 description: Capture ad-hoc ideas, bugs, tasks, or notes into the vault with ad-hoc capture frontmatter and descriptive filenames.
 ---

package/skills/skills/wiki-archive/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-archive
 description: Archive a superseded typed-knowledge page. Moves page to _archive/, removes from index.md, logs the action.
 ---

package/skills/skills/wiki-audit/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-audit
 description: Verify per-page that every ^[raw/...] resolves and sources frontmatter matches the body.
 ---

package/skills/skills/wiki-canvas/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-canvas
 description: Generate an Obsidian Canvas visualization of the vault graph. Runs skillwiki graph build then skillwiki canvas generate.
 ---

package/skills/skills/wiki-crystallize/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-crystallize
 description: Distill the current working session into a typed-knowledge page with provenance.
 ---

package/skills/skills/wiki-gate-plan-mode/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-gate-plan-mode
 description: Toggle EnterPlanMode gating — force superpowers planning skills instead of built-in plan mode
 ---

package/skills/skills/wiki-ingest/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-ingest
 description: Convert URLs, files, or pasted text into typed-knowledge pages with raw provenance. Supports single and batch mode.
 ---

package/skills/skills/wiki-init/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-init
 description: Bootstrap a CodeWiki vault — domain-aware SCHEMA.md, index.md, log.md, and ~/.skillwiki/.env binding. Use when starting a fresh vault.
 ---

package/skills/skills/wiki-lint/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: wiki-lint
 description: Vault health check via the umbrella `skillwiki lint` subcommand. Read-only by default; rotation requires explicit user consent.
 ---

package/skills/skills/wiki-query/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: wiki-query
 description: Search the vault and synthesize an answer with E2 4-signal ranking. Optional file to queries/ or comparisons/.
 ---

package/skills/skills/wiki-reingest/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-reingest
 description: Detect and act on source drift. Runs skillwiki drift, reviews changes, archives old raw + ingests new content.
 ---

package/skills/skills/wiki-sync/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.6.1
 name: wiki-sync
 description: Safely sync the vault git repository — multi-session safe via advisory lockfile. Handles rebase conflict storms from archive-commit × snapshot-stream patterns. Runs skillwiki sync status, then guides push or pull with lint guards and conflict resolution.
 ---

package/skills/using-skillwiki/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: using-skillwiki
 description: Invoke at session start or when knowledge-base tasks arise — maps skillwiki skills, dev-loop alignment, and PRD/TDD routing with plan-mode gate checks
 ---
@@ -122,16 +121,17 @@ For longer-running project work, use `proj-init` → `proj-work` → `proj-disti
 Maintenance: **Archive** (`wiki-archive`) superseded pages, **Drift** (`wiki-reingest`) to detect stale sources, **Adapter** (`wiki-adapter-prd`) for foreign PRD format ingestion.
 
 ## Troubleshooting Version Drift
-skillwiki has three distribution channels that can drift:
+skillwiki has multiple distribution channels that can drift:
 | Channel | Location | Update Command |
 |---------|----------|----------------|
 | npm CLI | `/usr/local/bin/skillwiki` | `npm install -g skillwiki@latest` |
 | npm skills | `/usr/local/lib/node_modules/skillwiki/skills/` | `skillwiki install` (copies to `~/.claude/skills/`) |
 | Claude plugin | `~/.claude/plugins/cache/llm-wiki/` | `claude plugin update skillwiki@llm-wiki` |
-| Local git dev | `~/.hermes/skills/llm-wiki/` | `npm link ./packages/cli` (from repo root) |
-**Check versions:** `skillwiki doctor` reports "Plugin/CLI version" mismatch warnings.
-**Common issue:** npm package ships SKILL.md files with older `version:` frontmatter than CLI code. This creates false-positive "version warnings" in `skillwiki doctor` — the CLI is newer but skills report older version.
-**Fix:** If developing locally, use `npm link` from the git repo. If using released versions, wait for maintainer to bump SKILL.md versions in source and republish.
+| Codex plugin | `~/.codex/plugins/cache/llm-wiki/` | `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed |
+| 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.
+**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.
 
 ## Multi-Wiki Profiles
 skillwiki supports named wiki profiles for working with multiple vaults. Set `WIKI_DEFAULT` to control which wiki all skills target by default.

package/skills/wiki-adapter-prd/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-adapter-prd
 description: Map foreign PRD formats (CodeStable, RFCs, structured markdown) into skillwiki raw + typed-knowledge pages.
 ---

package/skills/wiki-add-task/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: wiki-add-task
 description: Capture ad-hoc ideas, bugs, tasks, or notes into the vault with ad-hoc capture frontmatter and descriptive filenames.
 ---

package/skills/wiki-archive/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-archive
 description: Archive a superseded typed-knowledge page. Moves page to _archive/, removes from index.md, logs the action.
 ---

package/skills/wiki-audit/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-audit
 description: Verify per-page that every ^[raw/...] resolves and sources frontmatter matches the body.
 ---

package/skills/wiki-canvas/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-canvas
 description: Generate an Obsidian Canvas visualization of the vault graph. Runs skillwiki graph build then skillwiki canvas generate.
 ---

package/skills/wiki-crystallize/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-crystallize
 description: Distill the current working session into a typed-knowledge page with provenance.
 ---

package/skills/wiki-gate-plan-mode/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-gate-plan-mode
 description: Toggle EnterPlanMode gating — force superpowers planning skills instead of built-in plan mode
 ---

package/skills/wiki-ingest/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-ingest
 description: Convert URLs, files, or pasted text into typed-knowledge pages with raw provenance. Supports single and batch mode.
 ---

package/skills/wiki-init/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-init
 description: Bootstrap a CodeWiki vault — domain-aware SCHEMA.md, index.md, log.md, and ~/.skillwiki/.env binding. Use when starting a fresh vault.
 ---

package/skills/wiki-lint/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: wiki-lint
 description: Vault health check via the umbrella `skillwiki lint` subcommand. Read-only by default; rotation requires explicit user consent.
 ---

package/skills/wiki-query/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.2
 name: wiki-query
 description: Search the vault and synthesize an answer with E2 4-signal ranking. Optional file to queries/ or comparisons/.
 ---

package/skills/wiki-reingest/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.2.1
 name: wiki-reingest
 description: Detect and act on source drift. Runs skillwiki drift, reviews changes, archives old raw + ingests new content.
 ---

package/skills/wiki-sync/SKILL.md

@@ -1,5 +1,4 @@
 ---
-version: 0.6.1
 name: wiki-sync
 description: Safely sync the vault git repository — multi-session safe via advisory lockfile. Handles rebase conflict storms from archive-commit × snapshot-stream patterns. Runs skillwiki sync status, then guides push or pull with lint guards and conflict resolution.
 ---