feat: refresh shared skills catalog

skills/skill-architect/references/sample-skill.md

@@ -1,49 +1,23 @@
-# Antigravity & Jev Skill Template Blueprint
+# Skill template
 
-Every skill written, refactored, or audited by the Skill Architect must match this exact structure.
+Use the smallest structure that explains when to activate, what to do, and how to
+verify the result. Headings and numbered phases are optional.
 
+```yaml
 ---
-name: [kebab-case-name]
+name: example-skill
 description: >
-  A concise, 1-2 sentence explanation of what this skill accomplishes and exactly when the agent or dynamic router should activate it.
-concerns: [system-one-balance]   # omit if no protocols needed; see mapping below
+  Perform a specific workflow when the user requests its concrete outcome.
+scope: global
 ---
+```
 
-# [Title of Skill]
+# Example skill
 
-## Phase 0: Setup and Protocols
-- Resolve protocols matching the `concerns` field using the mapping table at the bottom of this document.
-- Review referenced protocols before generating or executing instructions.
+1. Inspect the relevant inputs and existing project conventions.
+2. Perform the requested work within its scope.
+3. Verify the behavior with the smallest relevant check and report the result.
 
-## Phase 1: Ingest and Check
-1. Validate required inputs, file paths, or target environment settings.
-2. Specify exact fallback behavior or default paths if arguments are omitted.
-3. Fail open gracefully on missing dependencies without crashing the harness.
-
-## Phase 2: Processing (Core Logic)
-- Structure workflow into sequential, numbered phases using active imperative verbs:
-  - "Read", "Parse", "Verify", "Mutate", "Execute", "Report".
-- Avoid vague conversational fluff or open-ended speculation.
-- Keep context instructions compact to respect prompt budgets.
-
-## Phase 3: The System One Balance & Anti-Bureaucracy Pass
-- Scan generated workflow against [`.agents/protocols/system-one-balance-protocol.md`](../../protocols/system-one-balance-protocol.md).
-- **Invariants**:
-  - Does NOT shout imperative tool lockouts (`DO NOT CALL TOOLS`).
-  - Does NOT interrupt routine user workflows with confirmation modals.
-  - Keeps instructions mechanical and actionable.
-
-## Phase 4: Output Execution & Verification
-- Define exact output file paths, formats, and artifacts.
-- Verify discovery via `jev_skill_router.py`:
-  ```cmd
-  cmd /c python .agents/hooks/jev_skill_router.py
-  ```
-
----
-
-## Concerns → Protocol Mapping
-
-| Concern | Protocol File |
-|:---|:---|
-| `system-one-balance` | `.agents/protocols/system-one-balance-protocol.md` |
+Link supporting material only where it helps a decision. Preserve user work and
+follow the [shared workflow](../../../protocols/workflow.md). Do not make every
+skill load a common protocol or run another skill before beginning useful work.