@iowarp/clio-coder 0.4.1 → 0.4.3

package/skills/skill-marketplace.json

@@ -3,7 +3,7 @@
 	"skills": [
 		{
 			"name": "ast-grep",
-			"description": "Use when a code search needs structure, not text — \"find all async functions without error handling\", \"find calls with this argument shape\", \"find X inside Y\" — or when grep returns too much noise to filter. Writes and tests ast-grep rules, then scans the codebase. Search only; never rewrites code. Not for plain string or filename lookups; use grep or find.",
+			"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.",
 			"triggers": [
 				"structural code search",
 				"ast-grep rule",
@@ -12,13 +12,13 @@
 				"grep returns too much noise"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/coding/ast-grep",
-			"version": "0.1.1",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "coding"
 		},
 		{
 			"name": "coding-standards",
-			"description": "Use when writing or refactoring TypeScript and the project has not pinned its own conflicting standards — new modules, error-handling design, schema parsing, module boundaries — or when another skill needs a TypeScript standards reference. Correct-by-construction rules: errors as values, parse don't validate, illegal states unrepresentable, deep modules, functional core / imperative shell.",
+			"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.",
 			"triggers": [
 				"TypeScript coding standards",
 				"errors as values",
@@ -27,13 +27,13 @@
 				"functional core imperative shell"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/coding/coding-standards",
-			"version": "0.1.1",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "coding"
 		},
 		{
 			"name": "prototype",
-			"description": "Use when a design question should be answered with throwaway code — \"does this state model feel right\", \"sanity-check this logic\", \"what should this UI look like\", \"mock something up\". Builds a clearly-marked, trivially-runnable, no-persistence prototype, then captures the verdict and discards the code. Not for pre-registered performance experiments; use experiment-protocol. Not for production implementation.",
+			"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.",
 			"triggers": [
 				"throwaway prototype",
 				"mock up this UI",
@@ -42,13 +42,13 @@
 				"what should this UI look like"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/coding/prototype",
-			"version": "0.2.1",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "coding"
 		},
 		{
 			"name": "tdd",
-			"description": "Use when the user wants to build a feature or fix a bug test-first, says \"TDD\", \"red-green\", or \"write the test first\", or when a change to tricky logic needs its behavior pinned before implementation. Runs the red → green loop at pre-agreed public seams, one vertical slice at a time. Not for designing benchmark criteria; use experiment-protocol.",
+			"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.",
 			"triggers": [
 				"test-driven development",
 				"write the test first",
@@ -57,13 +57,13 @@
 				"reproduce the bug with a test"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/coding/tdd",
-			"version": "0.2.1",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "coding"
 		},
 		{
 			"name": "context-handoff",
-			"description": "Use when a session is winding down and work will continue in a new session or another agent, when context is about to be compacted or lost, or when the user asks for a handoff, brief, summary, or \"notes for the next session.\" Produces a durable, redacted, reference-not-copy handoff document the next session can pick up from.",
+			"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.",
 			"triggers": [
 				"session handoff",
 				"notes for the next session",
@@ -72,13 +72,13 @@
 				"write a continuation brief"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/context/context-handoff",
-			"version": "0.3.3",
+			"version": "0.5.0",
 			"audit": "pass",
 			"category": "context"
 		},
 		{
 			"name": "context-prime",
-			"description": "Use when a coding session begins, when resuming work after a break, or when you land in an unfamiliar or in-progress repository and need to orient before acting. Loads the last handoff, git state, the project constitution, and active-work signals so a fresh agent reconstructs intent instead of guessing. Triggers on \"prime\", \"catch me up\", \"where were we\", \"get up to speed\", or the first substantive request in a new session.",
+			"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.",
 			"triggers": [
 				"prime this repository",
 				"catch me up",
@@ -87,13 +87,28 @@
 				"resume repository work after a break"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/context/context-prime",
-			"version": "0.2.3",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "context"
 		},
+		{
+			"name": "branch-closeout",
+			"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.",
+			"triggers": [
+				"close out this branch",
+				"clean up merged branch",
+				"remove merged worktree",
+				"closeout branch",
+				"branch-closeout"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/git/branch-closeout",
+			"version": "0.1.0",
+			"audit": "pass",
+			"category": "git"
+		},
 		{
 			"name": "file-ticket",
-			"description": "Use when something noticed mid-session must become a tracker issue — \"file a ticket\", \"open an issue for this\", \"log this bug\", \"ticket this behavior\". Captures evidence from the live session, dedups against existing issues, composes a labeled issue with acceptance criteria, confirms, and creates it via gh. Filing only; never fixes. Not for batch ticket creation from a PRD; use backlog. Not for diagnosing an existing issue; use fix-issue.",
+			"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.",
 			"triggers": [
 				"file a ticket",
 				"open an issue for this",
@@ -102,13 +117,13 @@
 				"create a tracker issue"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/git/file-ticket",
-			"version": "0.1.2",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "git"
 		},
 		{
 			"name": "fix-issue",
-			"description": "Use when a tracker issue should be resolved end to end — \"fix issue 123\", \"take this ticket\", \"resolve the bug in #45\". Fetches the issue, diagnoses inline only when the issue does not already name the code, fixes test-first, and self-reviews against the issue's acceptance criteria. Ends with an uncommitted, verified change ready for ship. Not for filing; use file-ticket. Not for committing or PRs; use ship.",
+			"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.",
 			"triggers": [
 				"fix issue 123",
 				"take this ticket",
@@ -117,13 +132,13 @@
 				"fix a GitHub issue end to end"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/git/fix-issue",
-			"version": "0.1.2",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "git"
 		},
 		{
 			"name": "resolve-merge-conflicts",
-			"description": "Use when a git merge, rebase, or cherry-pick is stopped on conflicts and they need resolving — \"fix these conflicts\", \"finish the merge\", conflict markers in files. Resolves by reconstructing both sides' intent from history, preserves both where possible, validates with the project's own checks, and completes the operation. Not for planning an integration of many branches; use worktree-merge.",
+			"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.",
 			"triggers": [
 				"merge conflict",
 				"fix these conflicts",
@@ -132,13 +147,13 @@
 				"resolve conflict markers"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/git/resolve-merge-conflicts",
-			"version": "0.2.1",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "git"
 		},
 		{
 			"name": "ship",
-			"description": "Use when finished work should leave the machine — \"ship this\", \"commit and open the PR\", \"get this up for review\". Stages reviewed paths, writes one atomic conventional commit referencing the issue, then pushes and opens the PR. Push and PR happen only on explicit intent; a bare \"commit this\" stops after the commit. Not for producing the change; use fix-issue.",
+			"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.",
 			"triggers": [
 				"ship this",
 				"commit this",
@@ -147,13 +162,13 @@
 				"get this up for review"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/git/ship",
-			"version": "0.1.2",
+			"version": "0.5.0",
 			"audit": "pass",
 			"category": "git"
 		},
 		{
 			"name": "worktree-create",
-			"description": "Use when the user asks to set up one or more git worktrees for parallel work — \"create a worktree\", \"set up worktrees for these branches\", \"spin up parallel branches\". Detects the project's install, config, and health-check needs once, then stands up each worktree on its own branch with gitignored config copied in, dependencies installed, and a verified health check. Not for merging finished worktrees; use worktree-merge.",
+			"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.",
 			"triggers": [
 				"create a git worktree",
 				"set up worktrees for these branches",
@@ -161,13 +176,13 @@
 				"prepare parallel worktrees"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/git/worktree-create",
-			"version": "0.2.1",
+			"version": "0.6.0",
 			"audit": "pass",
 			"category": "git"
 		},
 		{
 			"name": "worktree-merge",
-			"description": "Use when parallel worktree branches are finished and the user asks to integrate them — \"merge my worktrees\", \"integrate these branches\". Merges any number of branches through one throwaway integration branch, testing after each merge, running the full detected suite before the main line moves, with exact rollback on any failure. Not for creating worktrees; use worktree-create.",
+			"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.",
 			"triggers": [
 				"merge my worktrees",
 				"integrate these worktree branches",
@@ -175,13 +190,13 @@
 				"land finished worktrees"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/git/worktree-merge",
-			"version": "0.2.1",
+			"version": "0.6.0",
 			"audit": "pass",
 			"category": "git"
 		},
 		{
 			"name": "clio-coder-dev",
-			"description": "Use when modifying Clio Coder's own source in this repository, evolving its harness (TUI, skills, agents, tools, prompts, domains), or deciding whether a change stays local versus becomes a contribution. Governs self-development — what Clio may change freely, what requires explicit user intent, and how to make a change without breaking the architecture.",
+			"description": "Governs changes to Clio Coder's own source and harness (TUI, skills, agents, tools, prompts, domains): what may change freely, what needs explicit user intent, and how to change it without breaking the architecture. Not for verifying a change against the harness; use clio-coder-test.",
 			"triggers": [
 				"modify Clio Coder",
 				"change the Clio harness",
@@ -190,13 +205,13 @@
 				"Clio contribution boundary"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/meta/clio-coder-dev",
-			"version": "0.2.2",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "meta"
 		},
 		{
 			"name": "clio-coder-test",
-			"description": "Use when writing or modifying Clio Coder's own source under src/, or verifying a change end-to-end against the real test harness. Covers the three real layers (contracts / smoke / boundaries), choosing which to run for a given change, the mock-provider and ACP-over-stdio harness, and the hot-reload dev loop for picking up latest code. Activate on any src/ edit, before declaring a change verified, or when asked whether Clio still works.",
+			"description": "Verifies a Clio Coder source change against the current contract, smoke, boundary, and application test lanes, including temporary-state and local-provider harnesses. Not for deciding what may change; use clio-coder-dev.",
 			"triggers": [
 				"test Clio Coder",
 				"verify a Clio source change",
@@ -205,13 +220,13 @@
 				"Clio mock provider harness"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/meta/clio-coder-test",
-			"version": "0.1.5",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "meta"
 		},
 		{
 			"name": "credentials",
-			"description": "Use before running any tool or script that needs an API key, token, or other credential, when a command fails with an auth error, when the user must supply a new secret, or when a secret may have leaked into output. Covers facility surfaces such as kerberos tickets, globus and scheduler tokens, ssh agents, and netrc. Triggers on \"API key\", \"credential\", \"token\", \"auth error\", \"permission denied\", \"add a secret\", \"leaked\". Not for provider target configuration; use clio-coder auth and target settings.",
+			"description": "Handles API keys, tokens, and facility credentials (kerberos tickets, globus and scheduler tokens, ssh agents, netrc) before a tool needs one, after an auth error, when a new secret is supplied, or when one may have leaked. Not for provider target configuration; use clio-coder auth and target settings.",
 			"triggers": [
 				"API key",
 				"credential missing",
@@ -221,13 +236,13 @@
 				"secret leaked"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/meta/credentials",
-			"version": "0.1.3",
+			"version": "0.2.0",
 			"audit": "pass",
 			"category": "meta"
 		},
 		{
 			"name": "find-skills",
-			"description": "Use when the user asks \"is there a skill for X\", \"find a skill\", \"install a skill\", \"add a skill\", asks whether a capability exists as an installable skill, or wants to extend the agent with functionality that might already be published. Searches with `clio-coder skills search`, browses the ecosystem read-only, and installs only through `clio-coder skills install`. Not for authoring a new skill; use skill-craft.",
+			"description": "Finds and installs published skills when the user asks whether a capability exists as a skill, searching with clio-coder skills search and installing only through clio-coder skills install. Not for authoring a new skill; use skill-craft.",
 			"triggers": [
 				"find a skill",
 				"is there a skill for this",
@@ -236,13 +251,13 @@
 				"search the skills marketplace"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/meta/find-skills",
-			"version": "0.1.2",
+			"version": "0.2.0",
 			"audit": "pass",
 			"category": "meta"
 		},
 		{
 			"name": "herdr",
-			"description": "Use when the user explicitly mentions Herdr or asks to launch, drive, or inspect another agent or command in a Herdr pane, tab, or workspace — including starting a second Clio Coder instance and delegating work to it. Requires HERDR_ENV=1. Not for background work a plain shell or dispatch already covers; do not activate merely because a task could benefit from parallelism.",
+			"description": "Launches, drives, or inspects another agent or command in a Herdr pane, tab, or workspace, including a second Clio Coder instance; requires HERDR_ENV=1. Not for background work a plain shell or dispatch already covers.",
 			"triggers": [
 				"use Herdr",
 				"launch an agent in a Herdr pane",
@@ -251,13 +266,13 @@
 				"drive a command in a Herdr workspace"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/meta/herdr",
-			"version": "0.1.1",
+			"version": "0.2.0",
 			"audit": "pass",
 			"category": "meta"
 		},
 		{
 			"name": "skill-craft",
-			"description": "Use when writing, reviewing, or pruning a SKILL.md — authoring a new skill, editing an installed one, or judging whether a skill's description, body, or length is earning its cost. Triggers on \"write a skill\", \"improve this skill\", \"why isn't this skill firing\", \"is this skill too long\".",
+			"description": "Writes, reviews, or prunes a SKILL.md, judging whether its description, body, and length earn their cost. Not for packaging a workflow that just happened; use workflow-distiller.",
 			"triggers": [
 				"write a SKILL.md",
 				"create a new skill",
@@ -266,13 +281,33 @@
 				"prune a skill body"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/meta/skill-craft",
-			"version": "0.1.3",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "meta"
 		},
+		{
+			"name": "archify",
+			"description": "Validated interactive system maps and diagrams as standalone HTML from a typed JSON spec, for one of five diagram types (architecture, workflow, sequence, dataflow, lifecycle). Use when the user asks to visualize architecture, a workflow, a call sequence, a data pipeline, or a state machine, or to map this repository. Not for ad hoc drawings or slide art, and not for Mermaid output; use the artifact tool for plain Markdown.",
+			"triggers": [
+				"architecture diagram",
+				"system map",
+				"map this repository",
+				"sequence diagram",
+				"data flow diagram",
+				"state machine diagram",
+				"visualize the architecture"
+			],
+			"sourceUrl": "https://github.com/tt-a1i/archify/tree/v2.16.0/archify",
+			"version": "0.1.0",
+			"audit": "pass",
+			"category": "planning",
+			"origin": "remote",
+			"overlay": "skills/planning/archify",
+			"exclude": ["test", "package-lock.json"]
+		},
 		{
 			"name": "architecture",
-			"description": "Use when an intent (PRD, epic, brief, or idea) needs its engineering approach decided — \"how should we build this\", \"pick the stack\", \"architecture for this feature\". An interactive working session: investigates, proposes 2-3 genuinely different approaches with trade-offs, recommends with reasoning, lets the user decide, and writes a high-level architecture decision doc. Not a task-by-task plan; use cut-it for that. Not a multi-perspective debate; use design-council. Not product intent; use product-intent. Not a typed implementation handoff with code-shaped contracts; use tech-spec.",
+			"description": "Decides the engineering approach for an intent in an interactive session: investigates, proposes two or three genuinely different approaches with trade-offs, recommends, lets the user decide, and writes the decision doc. Not a task-by-task plan; use cut-it. Not a multi-perspective debate; use design-council. Not product intent; use product-intent. Not a typed implementation handoff; use tech-spec.",
 			"triggers": [
 				"how should we build this",
 				"pick the stack",
@@ -281,13 +316,13 @@
 				"compare architecture options"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/planning/architecture",
-			"version": "0.2.2",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "planning"
 		},
 		{
 			"name": "backlog",
-			"description": "Use when a finished PRD or architecture doc must become a real ticket backlog — \"create the stories\", \"turn this PRD into issues\", \"build the backlog\". Decomposes phases and user stories into small tickets with verifiable acceptance criteria, confirms the list, then creates them as GitHub issues (or in another tracker when an integration exists). Not for local sprint slicing into a SPRINT.md; use cut-it.",
+			"description": "Turns a finished PRD or architecture doc into a ticket backlog of small stories with verifiable acceptance criteria, confirmed, then created as GitHub issues or in another configured tracker. Not for local sprint slicing into a SPRINT.md; use cut-it.",
 			"triggers": [
 				"create the stories",
 				"turn this PRD into issues",
@@ -296,13 +331,13 @@
 				"create GitHub issues from this architecture"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/planning/backlog",
-			"version": "0.2.1",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "planning"
 		},
 		{
 			"name": "prd",
-			"description": "Use when the user wants to turn an idea into a product requirements document through a phase-gated interview — each phase locks before the next opens — ending in PRD.md plus per-milestone prompt files ready to drive a coding agent. Triggers on \"write a PRD\", \"spec this out\", \"help me define this feature/product\", or a brain dump that needs structure before planning.",
+			"description": "Turns an idea into a product requirements document through a phase-gated interview, ending in PRD.md plus per-milestone prompt files ready to drive a coding agent. Not for the problem-first product thesis; use product-intent.",
 			"triggers": [
 				"write a PRD",
 				"spec this product out",
@@ -311,13 +346,13 @@
 				"create milestone prompts"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/planning/prd",
-			"version": "0.2.2",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "planning"
 		},
 		{
 			"name": "product-intent",
-			"description": "Use at the start of a greenfield product effort, when the user wants a problem-first product document — \"why are we building this\", \"write the product thesis\", \"PRD for this idea\". Interviews for the problem, evidence, and a falsifiable hypothesis; writes an intent-only PRD with zero engineering decisions. Not for engineering decisions; use architecture. Not for turning a locked idea into milestone build prompts; use prd.",
+			"description": "Writes a problem-first product document for a greenfield effort: interviews for the problem, evidence, and a falsifiable hypothesis, with zero engineering decisions. Not for engineering decisions; use architecture. Not for turning a locked idea into milestone build prompts; use prd.",
 			"triggers": [
 				"why are we building this",
 				"write the product thesis",
@@ -326,13 +361,13 @@
 				"greenfield product intent"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/planning/product-intent",
-			"version": "0.2.1",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "planning"
 		},
 		{
 			"name": "tech-spec",
-			"description": "Write a typed call-stack architecture handoff — code-shaped contracts plus execution flows, implementation-ready for another engineer. User-invoked only. Not for weighing approaches or deciding the design; use architecture first.",
+			"description": "Writes a typed call-stack architecture handoff: code-shaped contracts plus execution flows, implementation-ready for another engineer. User-invoked only. Not for weighing approaches or deciding the design; use architecture first.",
 			"triggers": [
 				"write a tech spec",
 				"typed call-stack handoff",
@@ -341,13 +376,13 @@
 				"specify execution flows"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/planning/tech-spec",
-			"version": "0.1.2",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "planning"
 		},
 		{
 			"name": "arxiv-literature",
-			"description": "Use when the user asks to search arXiv, summarize an arXiv paper, compare papers, find recent research, or build a compact literature survey. Prefer the Researcher shadow agent for noisy multi-paper retrieval; return only citation-ready, source-linked paper cards.",
+			"description": "Searches arXiv, summarizes or compares papers, and builds a compact literature survey as citation-ready, source-linked paper cards. Prefer the Researcher shadow agent for noisy multi-paper retrieval.",
 			"triggers": [
 				"search arXiv",
 				"summarize an arXiv paper",
@@ -356,13 +391,13 @@
 				"build a literature survey"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/research/arxiv-literature",
-			"version": "0.3.1",
+			"version": "0.5.0",
 			"audit": "pass",
 			"category": "research"
 		},
 		{
 			"name": "experiment-protocol",
-			"description": "Use when running a performance study, numerical comparison, parameter sweep, kernel or solver benchmark, or any change justified by \"faster\" or \"more accurate\", and success criteria should be locked before results exist. Pre-registers thresholds, tolerances, environment pins, and verdict conditions into the repository validation contract before any measurement. Triggers on \"benchmark\", \"compare implementations\", \"optimize\", \"tolerance\", \"reproduce results\", \"parameter sweep\". Not for diagnosing a stalled bug; use scientific-debugging.",
+			"description": "Pre-registers a performance study, numerical comparison, parameter sweep, or benchmark: thresholds, tolerances, environment pins, and verdict conditions locked into the validation contract before any measurement. Not for diagnosing a stalled bug; use scientific-debugging.",
 			"triggers": [
 				"benchmark these implementations",
 				"pre-register a performance experiment",
@@ -372,13 +407,13 @@
 				"compare solver accuracy"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/research/experiment-protocol",
-			"version": "0.1.3",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "research"
 		},
 		{
 			"name": "scientific-debugging",
-			"description": "Use when debugging has stalled after the first obvious fix, when a failure spans multiple systems, when someone is about to try random changes, or when a scientific or HPC code produces wrong numbers, NaNs, nondeterministic results, or an unexplained performance regression. Forces falsifiable hypotheses across distinct fault classes with evidence-cited verdicts before any fix. Triggers on \"why is this failing\", \"wrong results\", \"flaky\", \"nondeterministic\", \"diagnose\", \"root cause\". Not for designing benchmarks or pre-registered experiments; use experiment-protocol.",
+			"description": "Diagnoses stalled or cross-system failures and wrong, NaN, nondeterministic, or unexpectedly slow scientific results through falsifiable hypotheses across distinct fault classes, with evidence-cited verdicts before any fix. Not for designing benchmarks or pre-registered experiments; use experiment-protocol.",
 			"triggers": [
 				"wrong scientific results",
 				"nondeterministic HPC code",
@@ -388,13 +423,13 @@
 				"scientific root cause"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/research/scientific-debugging",
-			"version": "0.1.3",
+			"version": "0.3.0",
 			"audit": "pass",
 			"category": "research"
 		},
 		{
 			"name": "scientific-modernization",
-			"description": "Use when modernizing, porting, rewriting, packaging, accelerating, or replacing established scientific software, especially across languages, build systems, CPU/GPU backends, or maintained forks. Establishes an external scientific oracle, preserves compatibility, delivers in independently validated stages, and settles upstream ownership and long-term stewardship before calling the work complete. Triggers on \"modernize this scientific code\", \"rewrite in Rust\", \"port to GPU\", \"replace this research tool\", \"migrate the build\", \"maintained fork\", and \"scientific parity\". Not for an isolated benchmark; use experiment-protocol. Not for diagnosing wrong results; use scientific-debugging.",
+			"description": "Modernizes, ports, rewrites, packages, or replaces established scientific software in independently validated stages against an external scientific oracle, settling compatibility and upstream stewardship before calling it complete. Not for an isolated benchmark; use experiment-protocol. Not for diagnosing wrong results; use scientific-debugging.",
 			"triggers": [
 				"modernize this scientific code",
 				"rewrite this scientific software in Rust",
@@ -404,13 +439,13 @@
 				"preserve scientific parity"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/research/scientific-modernization",
-			"version": "0.2.1",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "research"
 		},
 		{
 			"name": "cut-it",
-			"description": "Use when a plan, PRD, or milestone must become an executable sprint — dependency-ordered vertical slices sized for one focused agent run each, with done-when verification per slice. Never fabricates a plan; if none exists or it is too vague to slice, says so and recommends an interview first. Triggers on \"cut it\", \"slice this plan\", \"make this executable\", \"turn this into a sprint\".",
+			"description": "Slices an existing plan, PRD, or milestone into an executable sprint of dependency-ordered vertical slices sized for one agent run each, with done-when verification per slice; never fabricates a plan. Not for deciding the approach; use architecture.",
 			"triggers": [
 				"cut it",
 				"slice this plan",
@@ -419,13 +454,13 @@
 				"write dependency-ordered vertical slices"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/workflow/cut-it",
-			"version": "0.2.3",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "workflow"
 		},
 		{
 			"name": "design-council",
-			"description": "Use when a design decision has real tradeoffs and needs several expert perspectives that challenge each other before code is written, such as architecture choices, API shapes, storage formats, parallelization strategies, or dependency decisions. Quick mode runs a single round for a fast perspective check. Triggers on \"council\", \"debate this\", \"multiple perspectives\", \"weigh the options\", \"what would experts say\". Not for a one-question-at-a-time interrogation of a plan; use grill-me. Not for splitting implementation work across workers; use dispatch directly.",
+			"description": "Convenes several expert perspectives that challenge each other on a design decision with real trade-offs before code is written; quick mode runs a single round. Not for a one-question-at-a-time interrogation of a plan; use grill-me. Not for splitting implementation across workers; use dispatch directly.",
 			"triggers": [
 				"convene a design council",
 				"debate this design",
@@ -434,13 +469,13 @@
 				"what would experts say"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/workflow/design-council",
-			"version": "0.3.2",
+			"version": "0.5.0",
 			"audit": "pass",
 			"category": "workflow"
 		},
 		{
 			"name": "grill-me",
-			"description": "Use when the user wants a plan, design, or idea stress-tested through a phased one-question-at-a-time interview before any code is written, or when intent is too ambiguous to plan from. Scans available context first, reviews known facts, fills missing decisions, respects stop signals, and ends with a compact decision log. Triggers on \"grill me\", \"interview me\", \"stress-test this plan\", \"poke holes in this\".",
+			"description": "Stress-tests a plan, design, or idea through a phased one-question-at-a-time interview before code is written, ending in a compact decision log. Not for a multi-perspective debate; use design-council.",
 			"triggers": [
 				"grill me",
 				"interview me about this plan",
@@ -449,13 +484,13 @@
 				"clarify this plan one question at a time"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/workflow/grill-me",
-			"version": "0.3.3",
+			"version": "0.5.0",
 			"audit": "pass",
 			"category": "workflow"
 		},
 		{
 			"name": "workflow-distiller",
-			"description": "Use when a workflow that just happened should become reusable, when the user says \"make this a skill\", \"package what we just did\", \"turn this into a workflow\", or when the same multi-step process has been repeated across sessions. Reconstructs the workflow from the session record, interviews, checks overlap with installed skills, gates on approval, then writes the SKILL.md following skill-craft. Not for authoring a skill from scratch with no prior workflow; write the SKILL.md directly following skill-craft. Not for distilling into an agent recipe; propose that as a follow-up when the workflow is dispatch-shaped.",
+			"description": "Packages a workflow that just happened into a reusable SKILL.md: reconstructs it from the session record, checks overlap with installed skills, gates on approval, then writes it following skill-craft. Not for authoring a skill with no prior workflow; use skill-craft.",
 			"triggers": [
 				"make this workflow a skill",
 				"package what we just did",
@@ -464,7 +499,7 @@
 				"create a skill from this session"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/skills/workflow/workflow-distiller",
-			"version": "0.2.2",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "workflow"
 		}