tribunal-kit 9.2.4 → 9.2.5

package/skills/skill-creator/SKILL.md

@@ -1,177 +1,177 @@
----
-name: skill-creator
-description: "Use when Use this skill for creating new skills and iteratively improving them via a structured workflow (draft, evaluate, review, improve)."
-version: 5.0.0
-last-updated: 2026-09-13
-tools: Read, Grep, Glob, Bash, Edit, Write
-scripts-binding:
-  - .agent/scripts/skill_integrator.js
-  - .agent/scripts/verify_all.js
-  - .agent/scripts/lint_runner.js
----
-
-# /skill-creator — Skill Creation & Iterative Improvement Engine
-
-A specialized meta-skill workflow for creating, evaluating, and iteratively refining new AI skills. 
-This skill guides the process from capturing intent to writing the skill, testing it with baseline comparisons, and optimizing its triggering description.
-
----
-
-
----
-
-## 🔁 The Skill Creation Loop
-
-Execute the creation process using this high-level loop:
-1. Decide what the skill should do and how.
-2. Write a draft of the skill (`SKILL.md`).
-3. Create test prompts and run Claude with access to the skill.
-4. Help the user evaluate results (qualitatively and quantitatively).
-5. While runs happen, draft quantitative evals.
-6. Use the eval-viewer (`generate_review.py`) to show results to the user.
-7. Rewrite the skill based on feedback.
-8. Repeat until satisfied, then run the description optimizer.
-
----
-
-## Phase 1 — Capture Intent & Interview
-
-Start by understanding the skill requirements. Ask clarifying questions:
-- What should this skill enable Claude to do?
-- When should this skill trigger? (What user phrases/contexts?)
-- What's the expected output format?
-- Should we set up test cases? (Yes for objective tasks like file transforms; maybe no for subjective ones like writing style).
-
-**Research**: Check available MCPs for research via subagents or inline. Come prepared to reduce the burden on the user.
-
----
-
-## Phase 2 — Write the SKILL.md
-
-Based on the interview, draft the skill components.
-
-- **name**: Skill identifier.
-- **description**: Make it slightly "pushy". Include what it does AND specific contexts to trigger it. 
-  - *Example*: Instead of "Build a dashboard", use "Use this skill whenever the user mentions dashboards, data visualization, internal metrics, or wants to display any kind of company data, even if they don't explicitly ask for a 'dashboard'."
-
-### Anatomy of a Skill
-```text
-skill-name/
-├── SKILL.md (required - YAML frontmatter + Markdown)
-└── Bundled Resources (optional)
-    ├── scripts/    - Executable code for deterministic tasks
-    ├── references/ - Docs loaded into context as needed
-    └── assets/     - Templates, icons, fonts
-```
-
-### Writing Rules:
-- Keep `SKILL.md` under 500 lines. Use progressive disclosure (references) for larger files.
-- **Principle of Lack of Surprise**: No malware, no exploit code, no unauthorized access.
-- Use imperative form. Explain *why* things are important instead of rigid, heavy-handed MUSTs.
-- Include clear input/output examples.
-- **Look for repeated work**: If test cases show subagents independently writing similar helper scripts (e.g. `create_docx.py`), bundle that script into `scripts/` and instruct the skill to use it!
-
----
-
-## Phase 3 — Test Cases & Evaluation
-
-After drafting, create 2-3 realistic test prompts and share them with the user.
-
-Save prompts to `evals/evals.json` (draft assertions later):
-```json
-{
-  "skill_name": "example-skill",
-  "evals": [
-    {
-      "id": 1,
-      "prompt": "User's task prompt",
-      "expected_output": "Description of expected result",
-      "files": []
-    }
-  ]
-}
-```
-
-### Evaluation Execution Protocol (Crucial!)
-1. **Spawn All Runs at Once**: Spawn both with-skill AND baseline subagents in the *same turn*. Save outputs to `<workspace>/iteration-<N>/eval-<ID>/with_skill/outputs/` and `without_skill/outputs/` (or `old_skill/outputs/`).
-2. **Draft Assertions While Running**: While runs are ongoing, draft quantitative assertions. Good assertions are objectively verifiable and have descriptive names. Update `eval_metadata.json` and `evals/evals.json`.
-3. **Capture Timing Data**: Capture `total_tokens` and `duration_ms` from task notifications immediately to `timing.json` inside the run directory.
-4. **Grade and Aggregate**: 
-   - Grade each run using an automated grading agent. Save to `grading.json`.
-   - Aggregate into benchmark: `python -m scripts.aggregate_benchmark <workspace>/iteration-N --skill-name <name>`
-5. **Launch Eval Viewer**:
-   ```bash
-   nohup python <skill-creator-path>/eval-viewer/generate_review.py \
-     <workspace>/iteration-N \
-     --skill-name "my-skill" \
-     --benchmark <workspace>/iteration-N/benchmark.json \
-     > /dev/null 2>&1 &
-   VIEWER_PID=$!
-   ```
-   *For iteration 2+, add `--previous-workspace <workspace>/iteration-<N-1>`.*
-
----
-
-## Phase 4 — Review & Improve
-
-1. Read user feedback from `feedback.json` once the user clicks "Submit All Reviews".
-2. **Improve**: Generalize from the feedback. Don't overfit to specific examples. Keep the prompt lean. Explain the *why* behind your instructions.
-3. Rerun the iteration loop (apply improvements, rerun tests, launch reviewer) until the user is satisfied or feedback is empty.
-4. Kill the viewer server when done: `kill $VIEWER_PID 2>/dev/null`
-
----
-
-## Phase 5 — Description Optimization (Triggering)
-
-Optimize the `description` to ensure Claude triggers the skill correctly.
-
-1. **Generate Eval Queries**: Create 20 queries (10 should-trigger, 10 should-not-trigger) in JSON format.
-   - *Should-trigger*: Concrete, specific, messy real-world prompts (e.g. "my boss sent me this xlsx...").
-   - *Should-not-trigger*: Near-misses, adjacent domains, genuinely tricky cases.
-2. **Review with User**: Use the `assets/eval_review.html` template. Replace placeholders and open in browser. Wait for the user to export `eval_set.json` (check `~/Downloads/`).
-3. **Run Optimization Loop** (in background):
-   ```bash
-   python -m scripts.run_loop \
-     --eval-set <path-to-trigger-eval.json> \
-     --skill-path <path-to-skill> \
-     --model <model-id-powering-this-session> \
-     --max-iterations 5 \
-     --verbose
-   ```
-4. Apply the `best_description` from the output to the skill's frontmatter.
-
----
-
-## Final Step — Package & Present
-
-If the `present_files` tool is available:
-```bash
-python -m scripts.package_skill <path/to/skill-folder>
-```
-Present the `.skill` file path to the user for installation.
-
----
-
-## Claude.ai / Cowork Specific Adaptations
-
-- **Claude.ai (No Subagents)**: Do test cases yourself serially. Skip baseline runs. Skip the browser reviewer—present results directly in chat. Skip description optimization (requires CLI).
-- **Cowork**: You have subagents. Use `--static <output_path>` for `generate_review.py` to write standalone HTML, as there is no browser display. Provide the HTML link to the user.
-  - **CRITICAL**: GENERATE THE EVAL VIEWER BEFORE evaluating inputs yourself. You want to get them in front of the human ASAP!
-
----
-
-## 🚨 Guardrails & Hallucination Traps
-
-```
-❌ Never stop partway through the evaluation sequence.
-❌ Never spawn with-skill runs and baselines in separate turns.
-❌ Never write "ALWAYS" or "NEVER" in all caps if you can explain the reasoning instead.
-❌ Never use simple/trivial queries for trigger evals (e.g., "format data").
-✅ Always generate the eval viewer for the human to look at examples before revising the skill yourself.
-```
-
-## VBC Protocol
-
-**Verification-Before-Completion (VBC)**: Never assert a fix or feature is complete without executing the verification command in the current session. Evidence before claims always.
-1. Run `python -m scripts.run_loop --eval-set <eval.json>` to verify description triggers.
-2. Produce HTML viewer and get human approval before finishing.
+---
+name: skill-creator
+description: "Use when Use this skill for creating new skills and iteratively improving them via a structured workflow (draft, evaluate, review, improve)."
+version: 5.0.0
+last-updated: 2026-09-13
+tools: Read, Grep, Glob, Bash, Edit, Write
+scripts-binding:
+  - .agent/scripts/skill_integrator.js
+  - .agent/scripts/verify_all.js
+  - .agent/scripts/lint_runner.js
+---
+
+# /skill-creator — Skill Creation & Iterative Improvement Engine
+
+A specialized meta-skill workflow for creating, evaluating, and iteratively refining new AI skills. 
+This skill guides the process from capturing intent to writing the skill, testing it with baseline comparisons, and optimizing its triggering description.
+
+---
+
+
+---
+
+## 🔁 The Skill Creation Loop
+
+Execute the creation process using this high-level loop:
+1. Decide what the skill should do and how.
+2. Write a draft of the skill (`SKILL.md`).
+3. Create test prompts and run Claude with access to the skill.
+4. Help the user evaluate results (qualitatively and quantitatively).
+5. While runs happen, draft quantitative evals.
+6. Use the eval-viewer (`generate_review.py`) to show results to the user.
+7. Rewrite the skill based on feedback.
+8. Repeat until satisfied, then run the description optimizer.
+
+---
+
+## Phase 1 — Capture Intent & Interview
+
+Start by understanding the skill requirements. Ask clarifying questions:
+- What should this skill enable Claude to do?
+- When should this skill trigger? (What user phrases/contexts?)
+- What's the expected output format?
+- Should we set up test cases? (Yes for objective tasks like file transforms; maybe no for subjective ones like writing style).
+
+**Research**: Check available MCPs for research via subagents or inline. Come prepared to reduce the burden on the user.
+
+---
+
+## Phase 2 — Write the SKILL.md
+
+Based on the interview, draft the skill components.
+
+- **name**: Skill identifier.
+- **description**: Make it slightly "pushy". Include what it does AND specific contexts to trigger it. 
+  - *Example*: Instead of "Build a dashboard", use "Use this skill whenever the user mentions dashboards, data visualization, internal metrics, or wants to display any kind of company data, even if they don't explicitly ask for a 'dashboard'."
+
+### Anatomy of a Skill
+```text
+skill-name/
+├── SKILL.md (required - YAML frontmatter + Markdown)
+└── Bundled Resources (optional)
+    ├── scripts/    - Executable code for deterministic tasks
+    ├── references/ - Docs loaded into context as needed
+    └── assets/     - Templates, icons, fonts
+```
+
+### Writing Rules:
+- Keep `SKILL.md` under 500 lines. Use progressive disclosure (references) for larger files.
+- **Principle of Lack of Surprise**: No malware, no exploit code, no unauthorized access.
+- Use imperative form. Explain *why* things are important instead of rigid, heavy-handed MUSTs.
+- Include clear input/output examples.
+- **Look for repeated work**: If test cases show subagents independently writing similar helper scripts (e.g. `create_docx.py`), bundle that script into `scripts/` and instruct the skill to use it!
+
+---
+
+## Phase 3 — Test Cases & Evaluation
+
+After drafting, create 2-3 realistic test prompts and share them with the user.
+
+Save prompts to `evals/evals.json` (draft assertions later):
+```json
+{
+  "skill_name": "example-skill",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "User's task prompt",
+      "expected_output": "Description of expected result",
+      "files": []
+    }
+  ]
+}
+```
+
+### Evaluation Execution Protocol (Crucial!)
+1. **Spawn All Runs at Once**: Spawn both with-skill AND baseline subagents in the *same turn*. Save outputs to `<workspace>/iteration-<N>/eval-<ID>/with_skill/outputs/` and `without_skill/outputs/` (or `old_skill/outputs/`).
+2. **Draft Assertions While Running**: While runs are ongoing, draft quantitative assertions. Good assertions are objectively verifiable and have descriptive names. Update `eval_metadata.json` and `evals/evals.json`.
+3. **Capture Timing Data**: Capture `total_tokens` and `duration_ms` from task notifications immediately to `timing.json` inside the run directory.
+4. **Grade and Aggregate**: 
+   - Grade each run using an automated grading agent. Save to `grading.json`.
+   - Aggregate into benchmark: `python -m scripts.aggregate_benchmark <workspace>/iteration-N --skill-name <name>`
+5. **Launch Eval Viewer**:
+   ```bash
+   nohup python <skill-creator-path>/eval-viewer/generate_review.py \
+     <workspace>/iteration-N \
+     --skill-name "my-skill" \
+     --benchmark <workspace>/iteration-N/benchmark.json \
+     > /dev/null 2>&1 &
+   VIEWER_PID=$!
+   ```
+   *For iteration 2+, add `--previous-workspace <workspace>/iteration-<N-1>`.*
+
+---
+
+## Phase 4 — Review & Improve
+
+1. Read user feedback from `feedback.json` once the user clicks "Submit All Reviews".
+2. **Improve**: Generalize from the feedback. Don't overfit to specific examples. Keep the prompt lean. Explain the *why* behind your instructions.
+3. Rerun the iteration loop (apply improvements, rerun tests, launch reviewer) until the user is satisfied or feedback is empty.
+4. Kill the viewer server when done: `kill $VIEWER_PID 2>/dev/null`
+
+---
+
+## Phase 5 — Description Optimization (Triggering)
+
+Optimize the `description` to ensure Claude triggers the skill correctly.
+
+1. **Generate Eval Queries**: Create 20 queries (10 should-trigger, 10 should-not-trigger) in JSON format.
+   - *Should-trigger*: Concrete, specific, messy real-world prompts (e.g. "my boss sent me this xlsx...").
+   - *Should-not-trigger*: Near-misses, adjacent domains, genuinely tricky cases.
+2. **Review with User**: Use the `assets/eval_review.html` template. Replace placeholders and open in browser. Wait for the user to export `eval_set.json` (check `~/Downloads/`).
+3. **Run Optimization Loop** (in background):
+   ```bash
+   python -m scripts.run_loop \
+     --eval-set <path-to-trigger-eval.json> \
+     --skill-path <path-to-skill> \
+     --model <model-id-powering-this-session> \
+     --max-iterations 5 \
+     --verbose
+   ```
+4. Apply the `best_description` from the output to the skill's frontmatter.
+
+---
+
+## Final Step — Package & Present
+
+If the `present_files` tool is available:
+```bash
+python -m scripts.package_skill <path/to/skill-folder>
+```
+Present the `.skill` file path to the user for installation.
+
+---
+
+## Claude.ai / Cowork Specific Adaptations
+
+- **Claude.ai (No Subagents)**: Do test cases yourself serially. Skip baseline runs. Skip the browser reviewer—present results directly in chat. Skip description optimization (requires CLI).
+- **Cowork**: You have subagents. Use `--static <output_path>` for `generate_review.py` to write standalone HTML, as there is no browser display. Provide the HTML link to the user.
+  - **CRITICAL**: GENERATE THE EVAL VIEWER BEFORE evaluating inputs yourself. You want to get them in front of the human ASAP!
+
+---
+
+## 🚨 Guardrails & Hallucination Traps
+
+```
+❌ Never stop partway through the evaluation sequence.
+❌ Never spawn with-skill runs and baselines in separate turns.
+❌ Never write "ALWAYS" or "NEVER" in all caps if you can explain the reasoning instead.
+❌ Never use simple/trivial queries for trigger evals (e.g., "format data").
+✅ Always generate the eval viewer for the human to look at examples before revising the skill yourself.
+```
+
+## VBC Protocol
+
+**Verification-Before-Completion (VBC)**: Never assert a fix or feature is complete without executing the verification command in the current session. Evidence before claims always.
+1. Run `python -m scripts.run_loop --eval-set <eval.json>` to verify description triggers.
+2. Produce HTML viewer and get human approval before finishing.

package/skills/soft-skill/SKILL.md

@@ -1,53 +1,53 @@
----
-name: soft-skill
-description: "Use when High-end visual design guidance for premium typography, spacing, depth, and animation systems."
-version: 5.0.0
-last-updated: 2026-09-13
-skills:
-  - taste-skill
-  - progressive-blur
-  - impeccable
-tools: Read, Grep, Glob, Bash, Edit, Write
-scripts-binding:
-  - .agent/scripts/lint_runner.js
-  - .agent/scripts/verify_all.js
----
-
-# Soft Skill — High-End Luxury Visual Design & Depth
-
----
-
-## 🛠️ Technical Architecture & Reference Recipes
-
----
-
----
-
-## 4 Soft Design Rules
-
-### 1. Multi-Layer Soft Ambient Depth
-
-- Avoid harsh drop-shadows. Use low-opacity multi-layered ambient lighting shadows:
-
-```css
-.soft-depth-card {
-  background: var(--surface);
-  box-shadow:
-    0 2px 4px rgba(0, 0, 0, 0.02),
-    0 8px 16px rgba(0, 0, 0, 0.04),
-    0 24px 48px rgba(0, 0, 0, 0.06);
-  border: 1px solid rgba(0, 0, 0, 0.06);
-}
-```
-
-### 2. Generous Negative Space Cadence
-
-- Increase component padding by 1.5x (e.g. `24px` -> `36px`, `32px` -> `48px`). Generous negative space is the ultimate indicator of luxury software.
-
-### 3. Subdued Monochrome Color Harmonies
-
-- Use quiet, low-chroma monochromatic palettes (`oklch(0.97 0.005 240)` background with `oklch(0.22 0.01 240)` primary text).
-
-### 4. Fluid, Low-Velocity Transitions
-
-- Transition speeds should be gentle ($\approx 250\text{ms}$) with strong ease-out curves (`cubic-bezier(0.16, 1, 0.3, 1)`).
+---
+name: soft-skill
+description: "Use when High-end visual design guidance for premium typography, spacing, depth, and animation systems."
+version: 5.0.0
+last-updated: 2026-09-13
+skills:
+  - taste-skill
+  - progressive-blur
+  - impeccable
+tools: Read, Grep, Glob, Bash, Edit, Write
+scripts-binding:
+  - .agent/scripts/lint_runner.js
+  - .agent/scripts/verify_all.js
+---
+
+# Soft Skill — High-End Luxury Visual Design & Depth
+
+---
+
+## 🛠️ Technical Architecture & Reference Recipes
+
+---
+
+---
+
+## 4 Soft Design Rules
+
+### 1. Multi-Layer Soft Ambient Depth
+
+- Avoid harsh drop-shadows. Use low-opacity multi-layered ambient lighting shadows:
+
+```css
+.soft-depth-card {
+  background: var(--surface);
+  box-shadow:
+    0 2px 4px rgba(0, 0, 0, 0.02),
+    0 8px 16px rgba(0, 0, 0, 0.04),
+    0 24px 48px rgba(0, 0, 0, 0.06);
+  border: 1px solid rgba(0, 0, 0, 0.06);
+}
+```
+
+### 2. Generous Negative Space Cadence
+
+- Increase component padding by 1.5x (e.g. `24px` -> `36px`, `32px` -> `48px`). Generous negative space is the ultimate indicator of luxury software.
+
+### 3. Subdued Monochrome Color Harmonies
+
+- Use quiet, low-chroma monochromatic palettes (`oklch(0.97 0.005 240)` background with `oklch(0.22 0.01 240)` primary text).
+
+### 4. Fluid, Low-Velocity Transitions
+
+- Transition speeds should be gentle ($\approx 250\text{ms}$) with strong ease-out curves (`cubic-bezier(0.16, 1, 0.3, 1)`).

package/skills/sounds-on-the-web/SKILL.md

@@ -1,76 +1,76 @@
----
-name: sounds-on-the-web
-description: "Use when Web Audio API procedural sound synthesis for tactile micro-interaction feedback (clicks, pops, success chimes) with mute toggles and accessibility awareness."
-version: 5.0.0
-last-updated: 2026-09-13
-skills:
-  - delight
-  - micro-interaction
-  - baseline-ui
-tools: Read, Grep, Glob, Bash, Edit, Write
-scripts-binding:
-  - .agent/scripts/lint_runner.js
-  - .agent/scripts/verify_all.js
----
-
-# Sounds on the Web — Web Audio API Sound Feedback
-
----
-
-## 🛠️ Technical Architecture & Reference Recipes
-
----
-
----
-
-## Zero-Asset Web Audio API Click Synthesizer
-
-Never load external MP3 audio files for simple UI clicks. Synthesize clean sine/triangle pops procedurally in under 10 lines of code:
-
-```typescript
-// Lightweight procedural Web Audio pop synthesizer
-class SoundFeedback {
-  private ctx: AudioContext | null = null;
-  private isMuted: boolean = false;
-
-  private init() {
-    if (!this.ctx && typeof window !== 'undefined') {
-      const AudioCtx = window.AudioContext || (window as any).webkitAudioContext;
-      if (AudioCtx) this.ctx = new AudioCtx();
-    }
-  }
-
-  public playPop(frequency = 600, duration = 0.04) {
-    if (this.isMuted) return;
-    this.init();
-    if (!this.ctx) return;
-
-    if (this.ctx.state === 'suspended') {
-      this.ctx.resume();
-    }
-
-    const osc = this.ctx.createOscillator();
-    const gain = this.ctx.createGain();
-
-    osc.type = 'sine';
-    osc.frequency.setValueAtTime(frequency, this.ctx.currentTime);
-    // Frequency pitch drop for tactile "pop"
-    osc.frequency.exponentialRampToValueAtTime(120, this.ctx.currentTime + duration);
-
-    gain.gain.setValueAtTime(0.12, this.ctx.currentTime); // Low volume
-    gain.gain.exponentialRampToValueAtTime(0.001, this.ctx.currentTime + duration);
-
-    osc.connect(gain);
-    gain.connect(this.ctx.destination);
-
-    osc.start();
-    osc.stop(this.ctx.currentTime + duration);
-  }
-
-  public setMute(muted: boolean) {
-    this.isMuted = muted;
-  }
-}
-
-export const soundFX = new SoundFeedback();
-```
+---
+name: sounds-on-the-web
+description: "Use when Web Audio API procedural sound synthesis for tactile micro-interaction feedback (clicks, pops, success chimes) with mute toggles and accessibility awareness."
+version: 5.0.0
+last-updated: 2026-09-13
+skills:
+  - delight
+  - micro-interaction
+  - baseline-ui
+tools: Read, Grep, Glob, Bash, Edit, Write
+scripts-binding:
+  - .agent/scripts/lint_runner.js
+  - .agent/scripts/verify_all.js
+---
+
+# Sounds on the Web — Web Audio API Sound Feedback
+
+---
+
+## 🛠️ Technical Architecture & Reference Recipes
+
+---
+
+---
+
+## Zero-Asset Web Audio API Click Synthesizer
+
+Never load external MP3 audio files for simple UI clicks. Synthesize clean sine/triangle pops procedurally in under 10 lines of code:
+
+```typescript
+// Lightweight procedural Web Audio pop synthesizer
+class SoundFeedback {
+  private ctx: AudioContext | null = null;
+  private isMuted: boolean = false;
+
+  private init() {
+    if (!this.ctx && typeof window !== 'undefined') {
+      const AudioCtx = window.AudioContext || (window as any).webkitAudioContext;
+      if (AudioCtx) this.ctx = new AudioCtx();
+    }
+  }
+
+  public playPop(frequency = 600, duration = 0.04) {
+    if (this.isMuted) return;
+    this.init();
+    if (!this.ctx) return;
+
+    if (this.ctx.state === 'suspended') {
+      this.ctx.resume();
+    }
+
+    const osc = this.ctx.createOscillator();
+    const gain = this.ctx.createGain();
+
+    osc.type = 'sine';
+    osc.frequency.setValueAtTime(frequency, this.ctx.currentTime);
+    // Frequency pitch drop for tactile "pop"
+    osc.frequency.exponentialRampToValueAtTime(120, this.ctx.currentTime + duration);
+
+    gain.gain.setValueAtTime(0.12, this.ctx.currentTime); // Low volume
+    gain.gain.exponentialRampToValueAtTime(0.001, this.ctx.currentTime + duration);
+
+    osc.connect(gain);
+    gain.connect(this.ctx.destination);
+
+    osc.start();
+    osc.stop(this.ctx.currentTime + duration);
+  }
+
+  public setMute(muted: boolean) {
+    this.isMuted = muted;
+  }
+}
+
+export const soundFX = new SoundFeedback();
+```