@iowarp/clio-coder 0.4.6 → 0.4.7

package/library/skills/README.md

@@ -0,0 +1,120 @@
+# Clio skill packages
+
+This tree contains reviewed skill instructions and authoring evidence. Complete
+packages participate in the same [library](../../docs/guide/resource-library.md) as
+plugins, agents, prompts and fleets. Nothing in this source tree loads merely
+because it ships with Clio.
+
+`library/skills/` is the canonical source for Clio Coder's curated skills. The npm
+package includes this tree, `library/plugins/`, and the `library/registry.yaml` index.
+The index points to these bundled directories relative to its own location,
+so discovery and installation work from a source checkout or an installed
+package without fetching the library from GitHub. Skill provenance URLs point
+back to this repository; they do not replace the bundled package source.
+
+## Install and use
+
+```bash
+clio-coder library search research --kind skill
+clio-coder library install skill:grill-me --project --dry-run
+clio-coder library install skill:grill-me --project
+clio-coder library skills --all --json
+clio-coder library update skill:grill-me --project
+clio-coder library disable skill:grill-me --project
+clio-coder library remove skill:grill-me --project
+```
+
+In a session, `/library skill` browses skill packages and `/skill <name> [task]`
+activates one. Installed skill packages live beneath the selected scope's
+`plugins/<name>/`, with one complete-tree digest and the common package state.
+Unmanaged local `SKILL.md` files still load from established Clio and foreign
+resource roots. Foreign project imports and interop-adopted resources retain
+their trust requirements. Plugin resource roots are the packaged resource tier;
+harness extensions do not contribute skills.
+
+Installations, updates and active resource trees belong to the operator. Models
+may draft outside active roots and inspect or validate the result, but recognized
+model shell mutations of library packages are refused at every autonomy level.
+Interactive offers commit only after the bound operator answer. Skill tool
+restrictions last for the session until replaced or cleared with `/skill off`;
+worker activations remain scoped to their run. A skill can narrow tools but never
+grant authority the host disallows.
+
+## Source organization
+
+| Directory | Subject |
+| --- | --- |
+| `coding/` | Implementation, structural search, prototyping and tests |
+| `context/` | Repository orientation and task handoff |
+| `git/` | Tickets, patches, worktrees and review closeout |
+| `meta/` | Skill authoring, Clio development, credentials and external tools |
+| `planning/` | Product intent, architecture, requirements and backlog |
+| `research/` | Literature, experiments, scientific debugging and modernization |
+| `workflow/` | Interviews, sprint planning, design review and workflow capture |
+
+Each complete package contains `plugin.json`, `SKILL.md`, authored `evals.md`
+scenarios, and any supporting files. Standalone skill manifests set
+`extensions["ai.iowarp.clio"].kind` to `skill`, declare `resources.skills: "."`,
+and declare exactly one skill component at `SKILL.md`. The package name and
+explicit Semantic Version identify the distributable.
+
+Archify's package is an instruction wrapper for an independently installed
+upstream renderer. It does not claim to ship that renderer's executable,
+schemas or examples. Follow the skill's prerequisite check before using it.
+The raw-source overlay helpers and `remote.yaml` remain authoring/preparation
+utilities; the library installs complete, manifest-bearing trees through the
+common package engine.
+
+## Authoring contract
+
+House skills require `name`, `description`, `version`, and `license` frontmatter,
+and a nested `clio-coder:` map with `registry-id`, `source-url`, `provenance`, and
+`eval-status`. Set `audit: pass` after review. Provenance is `designed`, `adapted`,
+or `imported`. Declare optional whole-phrase `triggers` to improve lexical
+matching. `allowed-tools` and `disallowed-tools` must name canonical Clio tools.
+The description should say when to load the skill; detailed procedure belongs
+in the body or supporting references.
+
+Create an `evals.md` beside every house skill with realistic baseline/treatment
+scenarios and explicit expected evidence. Metadata saying scenarios are recorded
+is not a claim that a model evaluation passed. Authors can start by copying the
+standalone skill template from `library/_authoring/templates/skill/` (with `eval-status: scenarios-recorded`
+prior to maintainer review). The existing `skill-craft` skill provides the authoring and review procedure.
+
+```bash
+clio-coder library validate library/skills/workflow/grill-me/SKILL.md
+clio-coder library validate library/skills/workflow/grill-me --json
+pnpm run skills:pin
+pnpm run skills:check
+pnpm run library:pin
+pnpm run library:check
+```
+
+`skills:pin` and `skills:check` retain the authoring audit records in
+`library/skills/registry.yaml` and `library/skills/skill-marketplace.json`. Those normalized
+skill-body hashes describe reviewed instruction content and are advisory
+provenance evidence; they are not library installation pins. `library:pin`
+generates the canonical `library/registry.yaml` from complete package trees.
+`library:check` verifies every distributed byte and runs in release hygiene.
+Changes to scripts, references, manifests or evals require repinning the library
+just as changes to instructions do.
+
+For local publication, run `clio-coder library register <package-root> --user`
+or `--project`, then install its typed reference. Remote index entries require
+an explicit GitHub tree URL, the manifest version and a complete-tree SHA-256.
+Read the [package authoring guide](../../docs/guide/authoring-plugins.md) for the
+portable manifest and component contract.
+
+## Evaluation
+
+Named suite evals belong in the package manifest's `evals` map and run through
+`clio-coder eval validate/run --package skill:<name> --eval <suite>`. The same
+suite contract works for all five package kinds.
+
+The experimental `clio-coder eval skill <name|path>` lane executes authored
+`evals.md` RED/GREEN scenarios. It runs a baseline without the skill, a treatment
+with it, and a judge over the expected evidence. `--scenario` selects a scenario;
+`--target`, `--workspace`, and `--timeout` configure the run. Fixture shell needs
+`--trust-fixtures`; network tools need `--allow-network`. Unmeasured judge output
+is reported separately from a failed treatment. These model-based measurements
+are independent of deterministic package and script validation.

package/{skills → library/skills}/coding/ast-grep/SKILL.md

@@ -18,7 +18,7 @@ allowed-tools:
   - ls
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/coding/ast-grep
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/coding/ast-grep
   audit: pass
   provenance: adapted
   origin: https://github.com/coleam00/skills/tree/main/.claude/skills/ast-grep

package/{skills → library/skills}/coding/ast-grep/evals.md

@@ -42,7 +42,7 @@ Expected:
 
 ## Smoke record (2026-08-13)
 
-One representative scenario via `clio-coder skills eval` against Nemo-3.5-Lightning
+One representative scenario via `clio-coder eval skill` against Nemo-3.5-Lightning
 (30B local, llamacpp on mini), full-auto sandbox. NOT SMOKED: ast-grep binary absent on the eval host (2026-08-13). Needs the binary, then a re-run.
 
 Follow-up (2026-08-13): the durable fix considered here was a typed read-only

package/library/skills/coding/ast-grep/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "ast-grep",
+	"version": "0.3.0",
+	"description": "Structural code search with ast-grep rules: finds code by shape when grep on text is too noisy, and never rewrites it. Not for plain string or filename lookups; use grep or find.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "ast-grep",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/coding/coding-standards/SKILL.md

@@ -20,7 +20,7 @@ allowed-tools:
   - edit
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/coding/coding-standards
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/coding/coding-standards
   audit: pass
   provenance: adapted
   origin: https://github.com/dmmulroy/skills/tree/main/coding-standards

package/{skills → library/skills}/coding/coding-standards/evals.md

@@ -30,7 +30,7 @@ Expected:
 
 ## Smoke record (2026-08-13)
 
-One representative scenario via `clio-coder skills eval` against Nemo-3.5-Lightning
+One representative scenario via `clio-coder eval skill` against Nemo-3.5-Lightning
 (30B local, llamacpp on mini), full-auto sandbox. PASS (smoke). Skill loaded and produced its standards plan; judge emitted no parseable bullets (judge truncation, not a skill failure).
 
 ## Battletest record (2026-09-03)

package/library/skills/coding/coding-standards/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "coding-standards",
+	"version": "0.4.0",
+	"description": "Correct-by-construction TypeScript rules (errors as values, parse don't validate, illegal states unrepresentable, deep modules) for writing or refactoring TypeScript when the project has not pinned its own standards.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "coding-standards",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/coding/prototype/SKILL.md

@@ -20,7 +20,7 @@ allowed-tools:
   - edit
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/coding/prototype
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/coding/prototype
   audit: pass
   provenance: adapted
   origin: https://github.com/mattpocock/skills/tree/main/skills/engineering/prototype

package/{skills → library/skills}/coding/prototype/evals.md

@@ -38,7 +38,7 @@ Expected:
 
 ## Smoke record (2026-08-13)
 
-One representative scenario via `clio-coder skills eval` against Nemo-3.5-Lightning
+One representative scenario via `clio-coder eval skill` against Nemo-3.5-Lightning
 (30B local, llamacpp on mini), full-auto sandbox. PASS. Verdict captured via terminal artifact; code discarded.
 
 ## Battletest record (2026-09-03)

package/library/skills/coding/prototype/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "prototype",
+	"version": "0.4.0",
+	"description": "Answers a design question with throwaway code: a clearly marked, runnable, no-persistence prototype whose verdict is kept and whose code is discarded. Not for pre-registered performance experiments; use experiment-protocol. Not for production implementation.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "prototype",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/coding/tdd/SKILL.md

@@ -18,7 +18,7 @@ allowed-tools:
   - edit
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/coding/tdd
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/coding/tdd
   audit: pass
   provenance: adapted
   origin: https://github.com/mattpocock/skills/tree/main/skills/engineering/tdd

package/{skills → library/skills}/coding/tdd/evals.md

@@ -37,7 +37,7 @@ Expected:
 
 ## Smoke record (2026-08-13)
 
-One representative scenario via `clio-coder skills eval` against Nemo-3.5-Lightning
+One representative scenario via `clio-coder eval skill` against Nemo-3.5-Lightning
 (30B local, llamacpp on mini), full-auto sandbox. PASS on re-run under working exec: red observed, then green. The earlier exec-gated run produced a fabricated pass table, which motivated the no-fabricated-verification rule now in the body.
 
 ## Empirical Battletest (2026-09-03)

package/library/skills/coding/tdd/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "tdd",
+	"version": "0.4.0",
+	"description": "Builds a feature or fix test-first, red to green at pre-agreed public seams, one vertical slice at a time. Not for designing benchmark criteria; use experiment-protocol.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "tdd",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/context/context-handoff/SKILL.md

@@ -21,7 +21,7 @@ allowed-tools:
   - ask_user
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/context/context-handoff
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/context/context-handoff
   audit: pass
   provenance: designed
   eval-status: smoke-checked

package/{skills → library/skills}/context/context-handoff/evals.md

@@ -53,7 +53,7 @@ Expected:
 
 ## Smoke record (2026-08-13)
 
-One representative scenario via `clio-coder skills eval` against Nemo-3.5-Lightning
+One representative scenario via `clio-coder eval skill` against Nemo-3.5-Lightning
 (30B local, llamacpp on mini), full-auto sandbox. PASS on the re-run with the bare-number scenario form (harness exit 0, all bullets pass, 2026-08-13 12:17 CDT).
 
 ## Battletest record (2026-09-03)

package/library/skills/context/context-handoff/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "context-handoff",
+	"version": "0.5.1",
+	"description": "Writes a durable, redacted, reference-not-copy handoff document when a session winds down or context is about to be compacted or lost, so the next session or agent can continue. Not for orienting at the start of a session; use context-prime.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "context-handoff",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/context/context-prime/SKILL.md

@@ -20,7 +20,7 @@ allowed-tools:
   - ask_user
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/context/context-prime
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/context/context-prime
   audit: pass
   provenance: designed
   eval-status: smoke-checked

package/{skills → library/skills}/context/context-prime/evals.md

@@ -50,7 +50,7 @@ Expected:
 
 ## Smoke record (2026-08-13)
 
-One representative scenario via `clio-coder skills eval` against Nemo-3.5-Lightning
+One representative scenario via `clio-coder eval skill` against Nemo-3.5-Lightning
 (30B local, llamacpp on mini), full-auto sandbox. PASS. Prime sequence ran against the seeded handoff fixture; judge 3/4.
 
 ## Battletest record (2026-09-03)

package/library/skills/context/context-prime/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "context-prime",
+	"version": "0.4.1",
+	"description": "Orients a fresh session in a repository by loading the last handoff, git state, the project constitution, and active-work signals before acting. Not for writing the handoff; use context-handoff.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "context-prime",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/git/branch-closeout/SKILL.md

@@ -20,7 +20,7 @@ allowed-tools:
   - ask_user
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/git/branch-closeout
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/git/branch-closeout
   audit: pass
   provenance: designed
   eval-status: scenarios-recorded

package/library/skills/git/branch-closeout/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "branch-closeout",
+	"version": "0.1.0",
+	"description": "Proves merged work on the canonical base, inspects and removes associated worktrees through Git, deletes local branches safely, and audits surviving repository refs. Not for creating worktrees; use worktree-create. Not for integrating branches; use worktree-merge.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "branch-closeout",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/git/file-ticket/SKILL.md

@@ -20,7 +20,7 @@ allowed-tools:
   - ask_user
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/git/file-ticket
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/git/file-ticket
   audit: pass
   provenance: designed
   eval-status: scenarios-recorded

package/library/skills/git/file-ticket/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "file-ticket",
+	"version": "0.3.0",
+	"description": "Turns something noticed mid-session into a tracker issue: captures evidence, dedups against existing issues, composes a labeled issue with acceptance criteria, confirms, and creates it via gh. Not for batch ticket creation from a PRD; use backlog. Not for diagnosing an existing issue; use fix-issue.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "file-ticket",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/git/fix-issue/SKILL.md

@@ -25,7 +25,7 @@ allowed-tools:
   - edit
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/git/fix-issue
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/git/fix-issue
   audit: pass
   provenance: designed
   eval-status: smoke-checked

package/library/skills/git/fix-issue/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "fix-issue",
+	"version": "0.3.0",
+	"description": "Resolves a tracker issue end to end: fetches it, diagnoses only when the issue does not name the code, fixes test-first, and self-reviews against the acceptance criteria, leaving a verified uncommitted change. Not for filing; use file-ticket. Not for committing or PRs; use ship.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "fix-issue",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/git/resolve-merge-conflicts/SKILL.md

@@ -23,7 +23,7 @@ allowed-tools:
   - ask_user
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/git/resolve-merge-conflicts
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/git/resolve-merge-conflicts
   audit: pass
   provenance: adapted
   origin: https://github.com/mattpocock/skills/tree/main/skills/engineering/resolve-merge-conflicts

package/{skills → library/skills}/git/resolve-merge-conflicts/evals.md

@@ -82,4 +82,4 @@ Expected:
 - Running generic abort when resolution is achievable.
 
 ## Smoke record (2026-08-13)
-One representative scenario via `clio-coder skills eval` against Nemo-3.5-Lightning (30B local, llamacpp on mini), full-auto sandbox. PASS. Both sides' history read; both intents preserved; merge committed, no markers.
+One representative scenario via `clio-coder eval skill` against Nemo-3.5-Lightning (30B local, llamacpp on mini), full-auto sandbox. PASS. Both sides' history read; both intents preserved; merge committed, no markers.

package/library/skills/git/resolve-merge-conflicts/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "resolve-merge-conflicts",
+	"version": "0.4.0",
+	"description": "Resolves a merge, rebase, or cherry-pick stopped on conflicts by reconstructing both sides' intent, validating with the project's own checks, and completing the operation. Not for integrating many branches; use worktree-merge.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "resolve-merge-conflicts",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/git/ship/SKILL.md

@@ -20,7 +20,7 @@ allowed-tools:
   - ask_user
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/git/ship
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/git/ship
   audit: pass
   provenance: designed
   eval-status: smoke-checked

package/library/skills/git/ship/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "ship",
+	"version": "0.5.0",
+	"description": "Ships finished work: writes one reviewed atomic commit, keeps maintainer branches local, or pushes a contributor branch to their fork and opens a PR only on explicit intent. Not for producing the change; use fix-issue.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "ship",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/git/worktree-create/SKILL.md

@@ -21,7 +21,7 @@ allowed-tools:
   - ask_user
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/git/worktree-create
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/git/worktree-create
   audit: pass
   provenance: adapted
   origin: https://github.com/coleam00/skills/tree/main/.claude/skills/worktree-create

package/library/skills/git/worktree-create/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "worktree-create",
+	"version": "0.6.0",
+	"description": "Stands up one or more git worktrees for parallel work, each on its own branch with gitignored config copied in, dependencies installed, and a verified health check. Not for merging finished worktrees; use worktree-merge. Not for closeout; use branch-closeout.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "worktree-create",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}

package/{skills → library/skills}/git/worktree-merge/SKILL.md

@@ -19,7 +19,7 @@ allowed-tools:
   - ask_user
 clio-coder:
   registry-id: iowarp/clio-coder
-  source-url: https://github.com/iowarp/clio-coder/tree/main/skills/git/worktree-merge
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/git/worktree-merge
   audit: pass
   provenance: adapted
   origin: https://github.com/coleam00/skills/tree/main/.claude/skills/worktree-merge

package/library/skills/git/worktree-merge/plugin.json

@@ -0,0 +1,23 @@
+{
+	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+	"name": "worktree-merge",
+	"version": "0.6.0",
+	"description": "Integrates finished worktree branches through one throwaway integration branch, testing after each merge and running the full suite before the main line moves, with exact rollback on failure. Not for creating worktrees; use worktree-create. Not for closeout; use branch-closeout.",
+	"license": "Apache-2.0",
+	"extensions": {
+		"ai.iowarp.clio": {
+			"manifestVersion": 1,
+			"kind": "skill",
+			"resources": {
+				"skills": "."
+			},
+			"components": [
+				{
+					"kind": "skill",
+					"id": "worktree-merge",
+					"path": "SKILL.md"
+				}
+			]
+		}
+	}
+}