@iowarp/clio-coder 0.4.0 → 0.4.2

package/skills/meta/find-skills/SKILL.md

@@ -1,7 +1,13 @@
 ---
 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.
-version: 0.1.1
+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
+  - install a skill
+  - add an agent skill
+  - search the skills marketplace
+version: 0.2.0
 license: Apache-2.0
 allowed-tools:
   - bash
@@ -9,7 +15,7 @@ allowed-tools:
   - read
   - ls
   - ask_user
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/meta/find-skills
   audit: pass

package/skills/meta/herdr/SKILL.md

@@ -1,13 +1,19 @@
 ---
 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.
-version: 0.1.0
+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
+  - inspect a Herdr agent
+  - start a second Clio Coder instance
+  - drive a command in a Herdr workspace
+version: 0.2.0
 license: Apache-2.0
 allowed-tools:
   - bash
   - read
   - ask_user
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/meta/herdr
   audit: pass

package/skills/meta/skill-craft/SKILL.md

@@ -1,12 +1,18 @@
 ---
 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".
-version: 0.1.1
+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
+  - improve this skill
+  - why isn't this skill firing
+  - prune a skill body
+version: 0.3.0
 license: Apache-2.0
 allowed-tools:
   - read
   - grep
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/meta/skill-craft
   audit: pass
@@ -30,13 +36,27 @@ tool. Project skills live in `.clio-coder/skills/<name>/`; user skills in the Cl
 config dir under `skills/<name>/`. The loader validates on load; check work
 with `clio-coder skills validate`. Frontmatter contract (Agent Skills compatible):
 
-- `name`: lowercase-hyphen, ≤64 chars, must match the folder.
-- `description`: required, ≤1024 chars; its craft is the section below.
+- `name`: lowercase-hyphen, ≤64 chars. Catalog convention requires it to match
+  the folder; the runtime loader warns on a mismatch and uses the frontmatter
+  name.
+- `description`: required, ≤1024 chars; its craft is the section below. Quote
+  it when it contains ` #` — an unquoted YAML scalar is truncated there.
+- `version` and `license`: required for catalog publication. Follow the
+  marketplace versioning policy for body, trigger-surface, and sibling-file
+  changes; the normalized `SKILL.md` hash handles drift separately.
 - `disable-model-invocation: true`: hides the skill from the agent; only the
   user can activate it.
-- `allowed-tools`: tools the skill body may call.
+- `allowed-tools` / `disallowed-tools`: a *narrowing* declaration, not a
+  grant. While every loaded skill declares `allowed-tools`, the turn's tool
+  surface shrinks to their union; `disallowed-tools` always denies. Neither
+  ever admits a tool the safety level would refuse. Canonical lowercase Clio
+  names only (see skills/README.md, "Claude Code interop").
 - `requires`: `skill:<name>` dependencies; the loader warns when one is
   missing. Reference an installed skill by name instead of restating its job.
+- `clio-coder:`: the reserved publication block (`registry-id`, `source-url`,
+  `audit`, `provenance` designed|adapted|imported with `origin` when not
+  designed, `eval-status`, optional `model-size` and `agents`). Required for
+  catalog skills; approval is judged against it (skills/README.md).
 
 Sibling files (`references/*.md`, `evals.md`, scripts) ride along in the
 folder and load only when the body points at them.
@@ -49,17 +69,19 @@ but the user must remember it exists: cognitive load. Keep a description only
 when the agent must reach the skill on its own or another skill requires it;
 if it only ever fires by hand, set `disable-model-invocation: true`.
 
-## Description: Triggers, Not Identity
+## Description and Triggers
 
-The description is the skill's trigger surface, so every word competes with
-every other skill's description:
+Two frontmatter fields share the trigger surface, and every word in both
+competes with every other skill's:
 
-- Front-load the strongest trigger word.
-- One trigger per distinct branch. Synonyms restating one branch ("API key",
-  "credential", "token") are duplication; keep the strongest.
-- Cut identity the body already states; keep triggers, plus one "Not for X;
-  use <other-skill>" clause per real boundary.
-- Word triggers with the language the user actually types.
+- `triggers`: the phrases a user actually types, one per distinct branch.
+  Synonyms restating one branch ("API key", "credential", "token") are
+  duplication; keep the strongest.
+- `description`: one lead sentence saying what the skill does, then one
+  "Not for X; use <other-skill>" clause per real boundary. It is what the
+  agent reads in the `context(scope="skills")` listing on every skill-shaped
+  turn, so it carries no trigger list and no identity the body already
+  states.
 
 ## Body: Steps and Reference
 
@@ -96,7 +118,8 @@ Before finishing any skill, pass the body line by line:
   or split the skill; a split description must earn its permanent context
   load.
 
-Done when: description is triggers-only, every step has a checkable
+Done when: the description is one sentence plus routing clauses and the
+triggers carry the phrases, every step has a checkable
 completion criterion, no line fails the relevance/duplication/no-op pass, and
 an `evals.md` records at least one RED-GREEN scenario distinguishing
 with-skill from without.

package/skills/planning/architecture/SKILL.md

@@ -1,7 +1,13 @@
 ---
 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.'
-version: 0.2.0
+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
+  - architecture for this feature
+  - decide the engineering approach
+  - compare architecture options
+version: 0.3.0
 license: Apache-2.0
 allowed-tools:
   - read
@@ -14,7 +20,7 @@ allowed-tools:
   - web_fetch
   - write
   - ask_user
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/planning/architecture
   audit: pass

package/skills/planning/backlog/SKILL.md

@@ -1,7 +1,13 @@
 ---
 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.
-version: 0.2.0
+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
+  - build the backlog
+  - decompose this plan into tickets
+  - create GitHub issues from this architecture
+version: 0.3.0
 license: Apache-2.0
 allowed-tools:
   - read
@@ -10,7 +16,7 @@ allowed-tools:
   - bash
   - tasks
   - ask_user
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/planning/backlog
   audit: pass

package/skills/planning/prd/SKILL.md

@@ -1,7 +1,13 @@
 ---
 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.
-version: 0.2.1
+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
+  - define this feature
+  - structure this product brain dump
+  - create milestone prompts
+version: 0.3.0
 license: Apache-2.0
 allowed-tools:
   - read
@@ -14,7 +20,7 @@ allowed-tools:
   - write
   - edit
   - ask_user
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/planning/prd
   audit: pass

package/skills/planning/product-intent/SKILL.md

@@ -1,7 +1,13 @@
 ---
 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.
-version: 0.2.0
+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
+  - problem-first PRD
+  - define a falsifiable product hypothesis
+  - greenfield product intent
+version: 0.3.0
 license: Apache-2.0
 allowed-tools:
   - read
@@ -12,7 +18,7 @@ allowed-tools:
   - context
   - write
   - ask_user
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/planning/product-intent
   audit: pass

package/skills/planning/tech-spec/SKILL.md

@@ -1,7 +1,13 @@
 ---
 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.
-version: 0.1.0
+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
+  - code-shaped contracts
+  - implementation-ready technical specification
+  - specify execution flows
+version: 0.2.0
 license: Apache-2.0
 disable-model-invocation: true
 allowed-tools:
@@ -16,7 +22,7 @@ allowed-tools:
   - ask_user
 requires:
   - skill:tdd
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/planning/tech-spec
   audit: pass

package/skills/registry.yaml

@@ -6,131 +6,131 @@ skills:
   # ── coding ──
   - name: ast-grep
     path: coding/ast-grep
-    version: 0.1.0
-    sha256: 24ed3d9490e0923eec1321cb334ae6315194975be1694a243d0d4f45590b586f
+    version: 0.2.0
+    sha256: d21a4b330d1488c43348eaee7fbeec24bb8a1d7c4e536059db02fd9377c62dfa
   - name: coding-standards
     path: coding/coding-standards
-    version: 0.1.0
-    sha256: bd906dad6f244c82e3641078964bf69f56b5b36cb692d6e7c09555555451d893
+    version: 0.2.0
+    sha256: da21ad373252575934ad484a2926e8c7827880c9d91b4e0c656fe92d71335063
   - name: prototype
     path: coding/prototype
-    version: 0.2.0
-    sha256: 243258c7ad15a016d930927181912b4282bf84e698c05beaa03b48be1f6fdb66
+    version: 0.3.0
+    sha256: 151bd153752874d5970dd06bc15df14c0037631283d148195a8fa75c5a59a45b
   - name: tdd
     path: coding/tdd
-    version: 0.2.0
-    sha256: da6c7feb5a56d31d111c0e0f1b795f9c0e9012270e4bbc2a35d32b30cbfa9851
+    version: 0.3.0
+    sha256: f3a03655864d4981791218b085d09f8fe836d0795012cf4c8c07b430730abb2a
   # ── context ──
   - name: context-handoff
     path: context/context-handoff
-    version: 0.3.1
-    sha256: 2dc67e24a88607dbedb12163d8afd412421b004df7a845e301accc4e908e18ff
+    version: 0.4.0
+    sha256: ba0568719d0b58bb3e1631eee72094ec0165bf2fb7f69e1e67d223ff50b364d8
   - name: context-prime
     path: context/context-prime
-    version: 0.2.2
-    sha256: 1228302e03b86bcf829ac0016441f408f78b05c4658085d65628cf05fd282f8b
+    version: 0.3.0
+    sha256: d8413255688f1697d40231df830ce3c8947ac2a551f3e6fbb0d10158c4fa8d0e
   # ── git ──
   - name: file-ticket
     path: git/file-ticket
-    version: 0.1.0
-    sha256: 0532ac43ffacbfe3cbc681e68b2cbb7816751d9041b6f1f365e3d43a106a0e91
+    version: 0.2.0
+    sha256: 07b5d996d459c6c8c99ea44f44421d418f4738075cccd0e4b759a6f8a7daf720
   - name: fix-issue
     path: git/fix-issue
-    version: 0.1.0
-    sha256: 2c1a7d9c252dd8e0c9512b9610e1c467020fd2948d8d189d594e33e87e2d6fce
+    version: 0.2.0
+    sha256: ec5e6a00056041494f9b100da8f0775455124aebc7000ed0edb7c9b8493f74c8
   - name: resolve-merge-conflicts
     path: git/resolve-merge-conflicts
-    version: 0.2.0
-    sha256: 7974a394b560de7e8995a59e7f15fbbb7d6481d2cfdf12238d854cb9278675a0
+    version: 0.3.0
+    sha256: a1df7dee85ef788f257f8b8fbf4c2564cac245c3010d3f60d3b62d721d185f5e
   - name: ship
     path: git/ship
-    version: 0.1.0
-    sha256: 58b76f46629562310f833beb2adebe3cc91a078d2d84523608797ee1b53bb445
+    version: 0.2.0
+    sha256: 8a22f74e56a6e98c85a38051550d1e1a70c9ca5bb5cf271f4e6448f0f791e0ed
   - name: worktree-create
     path: git/worktree-create
-    version: 0.2.0
-    sha256: 9a22d1e0b5bce8f439f4f757ff47f7ec43a94bb80af87f6834d29644d1334e23
+    version: 0.3.0
+    sha256: d40bb0bb9152c4f2e391de1285b6cbd2e67a45492e2cf865b1f82910e30a6bcc
   - name: worktree-merge
     path: git/worktree-merge
-    version: 0.2.0
-    sha256: 407a31fc1e5e21b7aae2af39d09886944272ae8bef5ceed85711ad88122360ed
+    version: 0.3.0
+    sha256: bca803a2484b0eac90939377c81f9e66928242f36ac2d86cef9381b1ff997f3e
   # ── meta ──
-  - name: clio-dev
-    path: meta/clio-dev
-    version: 0.2.0
-    sha256: 386ebfdac9379ebf5630fa7a9af259bb45f473f7d3d679b0a7ef4164f5fc4dea
-  - name: clio-test
-    path: meta/clio-test
-    version: 0.1.4
-    sha256: 90ca1fe7660cd8c3d835801883ebd55d2d17cb652b8585b28ddb82aec642336e
+  - name: clio-coder-dev
+    path: meta/clio-coder-dev
+    version: 0.4.0
+    sha256: 8980f3bed0f06c24685bc0a02f3ffbbcdac9442616dc3ce54122265b666ae0d7
+  - name: clio-coder-test
+    path: meta/clio-coder-test
+    version: 0.3.0
+    sha256: 87f6689d083080e4b80294304f2b2fd36f70ce941ab7265cb573e84e4c5e6a12
   - name: credentials
     path: meta/credentials
-    version: 0.1.2
-    sha256: 3730d1492742922981c87643c878b36e927d8745080d3cb99dfa2c0374322c91
+    version: 0.2.0
+    sha256: d9382790ab30c9a13e5ca451f6f6b6b81eb8bcc6d458ad4931cc0495d39ea78d
   - name: find-skills
     path: meta/find-skills
-    version: 0.1.1
-    sha256: c0be6f4198f490930d9370d3a778ae6e64fed0250720f0ff66c08a0e41e838cc
+    version: 0.2.0
+    sha256: a2f8469b3a15059f8547e7566dcd27894c6e2a2126b3ed83acb470df051cd11d
   - name: herdr
     path: meta/herdr
-    version: 0.1.0
-    sha256: 147ddba47c4bd99844a896858b5ec483aa3df46fbcfadf8226115ba4bf51456b
+    version: 0.2.0
+    sha256: eeda051fe8736344b480fbd0d482a0e0ab82d4fc44e7ced5ff7058378beae3b6
   - name: skill-craft
     path: meta/skill-craft
-    version: 0.1.1
-    sha256: ec67b2dd6c4684886eed3c0c2204cba783b1d7b691f2234ebad5e9ab58caf754
+    version: 0.3.0
+    sha256: ba81e09412f26647a9384b07359201efb08949865c50934778a4ab3173d43096
   # ── planning ──
   - name: architecture
     path: planning/architecture
-    version: 0.2.0
-    sha256: e43e306e49adcc788d71eb534e425e34b13eea8d181a2af38d511308ede39b43
+    version: 0.3.0
+    sha256: 0da15631b3a60946e90b63047047e0ee1d84b6705e4f9f5405036b87fc849454
   - name: backlog
     path: planning/backlog
-    version: 0.2.0
-    sha256: 12c19d24bfac5356089fb225404aa33635b96b4d53bef20751f3389be8680423
+    version: 0.3.0
+    sha256: af92244d2ba8723b656ce00d531df88850c7886915653751e7ba59957b5454be
   - name: prd
     path: planning/prd
-    version: 0.2.1
-    sha256: bc23b47c94ce40df338b8e775f1992fd602f55636548acbb690fffce2f94efa5
+    version: 0.3.0
+    sha256: 505460dcac23b762a87fd0f7f3aaa99806e3b0fbedeaa54f9c48608c49c16356
   - name: product-intent
     path: planning/product-intent
-    version: 0.2.0
-    sha256: 17566702dfb367e9aec1f162a7063b87051af08803be953738a8079f2ab559ed
+    version: 0.3.0
+    sha256: d34300e6e2422fc1071e352f3e0f1b13a4e65dbcfd4eaf6dd9ef2b61f18d72ad
   - name: tech-spec
     path: planning/tech-spec
-    version: 0.1.0
-    sha256: 86b3d72a6c2e155e43bdebf6687b039f3a7443ae55fc765814e62241b1e3e47c
+    version: 0.2.0
+    sha256: 28b1b0a0a3e9b48b29f679ab2377ee66d719c9a670eed622a38ac69be8b72b2e
   # ── research ──
   - name: arxiv-literature
     path: research/arxiv-literature
-    version: 0.3.0
-    sha256: 08e5c6591e28d6195e4a612b3323bcb63eed93b8e07e54515b6417b11780f8b8
+    version: 0.4.0
+    sha256: b0b1bb80dc8d15e52ab180ab4f5645859310b45d7ebdf87649e0e5a7f7bca987
   - name: experiment-protocol
     path: research/experiment-protocol
-    version: 0.1.2
-    sha256: 3af25cbcbd1adc37e3a1290cb975e0c2441f347c03148512b38c4f987f3c9c8e
+    version: 0.2.0
+    sha256: 126e0f6dc3534a141978f2ccd1c6ea659df447beb1015bc92e41856d318584a2
   - name: scientific-debugging
     path: research/scientific-debugging
-    version: 0.1.2
-    sha256: a9d7e2153c18ec93b00c5b58fd1842201de3c75f7cbea051ae2faac777055520
+    version: 0.2.0
+    sha256: f2b2b6442740ef23270fad94f75ba95ce522da1877a468ba112cbaff68e5fa2a
   - name: scientific-modernization
     path: research/scientific-modernization
-    version: 0.2.0
-    sha256: df5aa24fd478c10faac65d0cc9623cfd55ef2405e8f16d3c2d2fee799cf57226
+    version: 0.3.0
+    sha256: 66a99f38b38232735bb70d7924a85d0ab5addabfe3935cc82c0aaa3303d68773
   # ── workflow ──
   - name: cut-it
     path: workflow/cut-it
-    version: 0.2.1
-    sha256: f83526535d43137624a9345dbbfbd9de706ccbe464a0aff96dc4a9de2abaaf16
+    version: 0.3.0
+    sha256: 6429a4725acf874379c1df7736dd95db07acd97ad5bd6f6226649370cd03d177
   - name: design-council
     path: workflow/design-council
-    version: 0.3.0
-    sha256: e02865e1603802acdcb1f3de6c8a43ac7b6f8f1c085f66ed7a5aeae22ab2d8b6
+    version: 0.4.0
+    sha256: 1ecd53397ce97ec78294cc9e8c7291b20e2e7d740bcde8ea999739d359c91055
   - name: grill-me
     path: workflow/grill-me
-    version: 0.3.2
-    sha256: 08f9a165755210dfe942e14fe59803acd19c35ab182b9da10deebdc8554c3f9d
+    version: 0.4.0
+    sha256: 9cc07b89a4a8a3ecd4fb73d2cd9f7893d272d26f592ea3eb9883ff44069a2cea
   - name: workflow-distiller
     path: workflow/workflow-distiller
-    version: 0.2.1
-    sha256: 48238593de4877a7b3a4d63e982f9eca84e47f8ec41654dab97da72e9b590ad5
+    version: 0.3.0
+    sha256: 6aa6bb3088f0e4925946aaba3f217dfc5a6e4b8e31f2f051abeda599da91cd48

package/skills/research/arxiv-literature/SKILL.md

@@ -1,7 +1,13 @@
 ---
 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.
-version: 0.3.0
+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
+  - compare these papers
+  - find recent research papers
+  - build a literature survey
+version: 0.4.0
 license: Apache-2.0
 allowed-tools:
   - web_fetch
@@ -11,7 +17,7 @@ allowed-tools:
   - find
   - ls
   - artifact
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/research/arxiv-literature
   audit: pass

package/skills/research/experiment-protocol/SKILL.md

@@ -1,7 +1,14 @@
 ---
 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.
-version: 0.1.2
+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
+  - run a parameter sweep
+  - define numerical tolerances
+  - reproduce these results
+  - compare solver accuracy
+version: 0.2.0
 license: Apache-2.0
 allowed-tools:
   - read
@@ -13,7 +20,7 @@ allowed-tools:
   - context
   - code_nav
   - bash
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/research/experiment-protocol
   audit: pass

package/skills/research/scientific-debugging/SKILL.md

@@ -1,7 +1,14 @@
 ---
 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.
-version: 0.1.2
+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
+  - unexplained performance regression
+  - diagnose NaNs
+  - debug with falsifiable hypotheses
+  - scientific root cause
+version: 0.2.0
 license: Apache-2.0
 allowed-tools:
   - read
@@ -12,7 +19,7 @@ allowed-tools:
   - context
   - code_nav
   - bash
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/research/scientific-debugging
   audit: pass

package/skills/research/scientific-debugging/evals.md

@@ -42,8 +42,8 @@ if __name__ == "__main__":
     unittest.main()
 PY
 git init -q
-git config user.name "Clio Eval"
-git config user.email "clio-eval@example.invalid"
+git config user.name "Clio Coder Eval"
+git config user.email "eval@clio-coder.local"
 git add diffusion.py tests/test_diffusion.py
 git commit -q -m "add stable weighted mean reference"
 cat > diffusion.py <<'PY'

package/skills/research/scientific-modernization/SKILL.md

@@ -1,7 +1,14 @@
 ---
 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.
-version: 0.2.0
+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
+  - port this solver to GPU
+  - migrate the scientific build system
+  - create a maintained fork
+  - preserve scientific parity
+version: 0.3.0
 license: Apache-2.0
 allowed-tools:
   - read
@@ -13,7 +20,7 @@ allowed-tools:
   - context
   - code_nav
   - bash
-clio:
+clio-coder:
   registry-id: iowarp/clio-coder
   source-url: https://github.com/iowarp/clio-coder/tree/main/skills/research/scientific-modernization
   audit: pass