@su-record/vibe 2.9.25 → 2.9.32

package/skills/vibe-test/SKILL.md

@@ -1,140 +1,140 @@
----
-name: vibe-test
-tier: core
-description: "Self-test vibe by probing every command/skill/hook/agent in a target harness install dir (~/.claude or ~/.coco) and writing a pass/fail report to ~/.vibe/test-reports/. Takes an optional harness argument (cc|coco); empty = current harness. Must use this skill when user runs /vibe.test, when verifying a vibe install before release, or when the user says 'self-test', 'harness 점검', 'vibe 건강'."
-triggers: [test, self-test, "vibe 건강", "harness 점검", "자가검진"]
-priority: 70
-chain-next: []
----
-
-# vibe-test — Self-Test
-
-Probe every shipped vibe surface in one install dir and emit a pass/fail report.
-
-## Why this exists
-
-When vibe ships new commands, skills, hooks, or agents, one side (CC or coco) can end up out of sync with the other, frontmatter can drift, and hook tests can silently break. `/vibe.test` is the single mechanical check: does every surface in the target install actually load and pass its own tests?
-
-## Target harness
-
-The argument selects which install dir to probe:
-
-| Arg | Probed dir |
-|---|---|
-| (empty) | current harness — CC: `~/.claude/`, coco: `~/.coco/` |
-| `cc` | `~/.claude/` |
-| `coco` | `~/.coco/` |
-
-If the target dir does not exist, print a clear message and exit with guidance (not an error). Example:
-
-```
-~/.coco/ not found — coco isn't installed on this machine.
-  To install: pnpm add -g @su-record/vibe-coco
-```
-
-## Probes
-
-All probes are **structural or test-based** — no interactive command is ever actually invoked, and no LLM is called.
-
-| Category | Source | Check |
-|---|---|---|
-| commands | `<install>/commands/*.md` | file readable · frontmatter parses · `description` present · body references a skill (`Load skill \`...\``) if it delegates |
-| skills | `<install>/skills/*/SKILL.md` | frontmatter parses · required fields (`name`, `description`) · `triggers` array non-empty · body non-empty |
-| hooks | repo `hooks/scripts/*.js` | for each script with a matching `__tests__/<name>.test.js`, run `npx vitest run <test> --reporter=json` and parse pass/fail counts |
-| agents | `<install>/agents/*.md` | file readable · frontmatter parses · required fields (`name`, `description`) |
-
-A probe's failure is captured in its `error` field; the overall run never halts because of one failure.
-
-## Report template
-
-Written to `~/.vibe/test-reports/<YYYYMMDD-HHmm>-<harness>.{json,md}`. Exact schema:
-
-### JSON
-
-```json
-{
-  "harness": "cc",
-  "timestamp": "2026-04-16T18:30:00+09:00",
-  "vibe_version": "2.9.24",
-  "install_dir": "/Users/grove/.claude",
-  "summary": {
-    "total": 42,
-    "passed": 40,
-    "failed": 2
-  },
-  "probes": {
-    "commands": [
-      { "name": "vibe.spec", "status": "pass" },
-      { "name": "vibe.test", "status": "pass" }
-    ],
-    "skills": [
-      { "name": "vibe-test", "status": "pass" },
-      { "name": "vibe-spec", "status": "fail", "error": "frontmatter: triggers array is empty" }
-    ],
-    "hooks": [
-      { "name": "pre-tool-guard", "status": "pass", "tests": "38/38" },
-      { "name": "keyword-detector", "status": "pass", "tests": "12/12" }
-    ],
-    "agents": [
-      { "name": "explorer", "status": "pass" }
-    ]
-  },
-  "failed": [
-    {
-      "category": "skills",
-      "name": "vibe-spec",
-      "error": "frontmatter: triggers array is empty"
-    }
-  ]
-}
-```
-
-- `status`: `"pass"` | `"fail"`
-- `error`: required when `status === "fail"`, omitted otherwise
-- `tests` (hooks only): short `passed/total` string from the vitest JSON reporter
-- `failed[]`: flat list of every failure for quick scanning — mirrors entries found across `probes.*`
-
-### Markdown
-
-```markdown
-# vibe self-test · cc · 2026-04-16 18:30
-
-**Version**: 2.9.24   **Install**: /Users/grove/.claude
-
-| Category | Pass | Fail |
-|---|---:|---:|
-| commands | 15 | 0 |
-| skills   | 17 | 1 |
-| hooks    |  6 | 0 |
-| agents   |  3 | 1 |
-| **total**| **41** | **2** |
-
-## Failures
-
-- **skills / vibe-spec** — frontmatter: triggers array is empty
-- **agents / explorer** — agent file not found
-```
-
-If `failed` is empty, replace the Failures section with `_All probes passed._`.
-
-## Steps
-
-1. **Resolve target**: argument (`cc` / `coco` / empty). Empty → detect current harness (`$CLAUDE_PROJECT_DIR` set → `cc`; else fall back to `cc`).
-2. **Resolve install dir**: `cc` → `~/.claude`, `coco` → `~/.coco`. If missing → print guidance + exit.
-3. **Read `vibe_version`** from `package.json` in the current repo.
-4. **Walk each category**, run its check, append `{ name, status, error? }` to `probes.<category>`.
-5. **Compute** `summary` counts and the flat `failed[]` list.
-6. **Ensure** `~/.vibe/test-reports/` exists (`mkdir -p`, dir mode `0o700` — consistent with `~/.vibe/config.json`).
-7. **Write** `<ts>-<harness>.json` and `<ts>-<harness>.md`.
-8. **Print** the Markdown summary to the console.
-9. **If `summary.failed > 0`**, load skill `vibe-regress` with `subcommand: register --from-test` and pass the failed entries. P1 = any probe with `status: fail`.
-
-## Done Criteria
-
-- [ ] No external LLM call — file reads + vitest runs only
-- [ ] One probe failing never halts the overall run
-- [ ] Target install dir missing → clean exit with guidance (not an error)
-- [ ] JSON report matches the template above exactly (fields, types, naming)
-- [ ] Markdown summary printed to console after the run
-- [ ] Reports land in `~/.vibe/test-reports/`, never in project-local `.claude/vibe/`
-- [ ] `failed.length > 0` → auto-invokes `/vibe.regress register --from-test`
+---
+name: vibe-test
+tier: core
+description: "Self-test vibe by probing every command/skill/hook/agent in a target harness install dir (~/.claude or ~/.coco) and writing a pass/fail report to ~/.vibe/test-reports/. Takes an optional harness argument (cc|coco); empty = current harness. Must use this skill when user runs /vibe.test, when verifying a vibe install before release, or when the user says 'self-test', 'harness 점검', 'vibe 건강'."
+triggers: [test, self-test, "vibe 건강", "harness 점검", "자가검진"]
+priority: 70
+chain-next: []
+---
+
+# vibe-test — Self-Test
+
+Probe every shipped vibe surface in one install dir and emit a pass/fail report.
+
+## Why this exists
+
+When vibe ships new commands, skills, hooks, or agents, one side (CC or coco) can end up out of sync with the other, frontmatter can drift, and hook tests can silently break. `/vibe.test` is the single mechanical check: does every surface in the target install actually load and pass its own tests?
+
+## Target harness
+
+The argument selects which install dir to probe:
+
+| Arg | Probed dir |
+|---|---|
+| (empty) | current harness — CC: `~/.claude/`, coco: `~/.coco/` |
+| `cc` | `~/.claude/` |
+| `coco` | `~/.coco/` |
+
+If the target dir does not exist, print a clear message and exit with guidance (not an error). Example:
+
+```
+~/.coco/ not found — coco isn't installed on this machine.
+  To install: pnpm add -g @su-record/vibe-coco
+```
+
+## Probes
+
+All probes are **structural or test-based** — no interactive command is ever actually invoked, and no LLM is called.
+
+| Category | Source | Check |
+|---|---|---|
+| commands | `<install>/commands/*.md` | file readable · frontmatter parses · `description` present · body references a skill (`Load skill \`...\``) if it delegates |
+| skills | `<install>/skills/*/SKILL.md` | frontmatter parses · required fields (`name`, `description`) · `triggers` array non-empty · body non-empty |
+| hooks | repo `hooks/scripts/*.js` | for each script with a matching `__tests__/<name>.test.js`, run `npx vitest run <test> --reporter=json` and parse pass/fail counts |
+| agents | `<install>/agents/*.md` | file readable · frontmatter parses · required fields (`name`, `description`) |
+
+A probe's failure is captured in its `error` field; the overall run never halts because of one failure.
+
+## Report template
+
+Written to `~/.vibe/test-reports/<YYYYMMDD-HHmm>-<harness>.{json,md}`. Exact schema:
+
+### JSON
+
+```json
+{
+  "harness": "cc",
+  "timestamp": "2026-04-16T18:30:00+09:00",
+  "vibe_version": "2.9.24",
+  "install_dir": "/Users/grove/.claude",
+  "summary": {
+    "total": 42,
+    "passed": 40,
+    "failed": 2
+  },
+  "probes": {
+    "commands": [
+      { "name": "vibe.spec", "status": "pass" },
+      { "name": "vibe.test", "status": "pass" }
+    ],
+    "skills": [
+      { "name": "vibe-test", "status": "pass" },
+      { "name": "vibe-spec", "status": "fail", "error": "frontmatter: triggers array is empty" }
+    ],
+    "hooks": [
+      { "name": "pre-tool-guard", "status": "pass", "tests": "38/38" },
+      { "name": "keyword-detector", "status": "pass", "tests": "12/12" }
+    ],
+    "agents": [
+      { "name": "explorer", "status": "pass" }
+    ]
+  },
+  "failed": [
+    {
+      "category": "skills",
+      "name": "vibe-spec",
+      "error": "frontmatter: triggers array is empty"
+    }
+  ]
+}
+```
+
+- `status`: `"pass"` | `"fail"`
+- `error`: required when `status === "fail"`, omitted otherwise
+- `tests` (hooks only): short `passed/total` string from the vitest JSON reporter
+- `failed[]`: flat list of every failure for quick scanning — mirrors entries found across `probes.*`
+
+### Markdown
+
+```markdown
+# vibe self-test · cc · 2026-04-16 18:30
+
+**Version**: 2.9.24   **Install**: /Users/grove/.claude
+
+| Category | Pass | Fail |
+|---|---:|---:|
+| commands | 15 | 0 |
+| skills   | 17 | 1 |
+| hooks    |  6 | 0 |
+| agents   |  3 | 1 |
+| **total**| **41** | **2** |
+
+## Failures
+
+- **skills / vibe-spec** — frontmatter: triggers array is empty
+- **agents / explorer** — agent file not found
+```
+
+If `failed` is empty, replace the Failures section with `_All probes passed._`.
+
+## Steps
+
+1. **Resolve target**: argument (`cc` / `coco` / empty). Empty → detect current harness (`$CLAUDE_PROJECT_DIR` set → `cc`; else fall back to `cc`).
+2. **Resolve install dir**: `cc` → `~/.claude`, `coco` → `~/.coco`. If missing → print guidance + exit.
+3. **Read `vibe_version`** from `package.json` in the current repo.
+4. **Walk each category**, run its check, append `{ name, status, error? }` to `probes.<category>`.
+5. **Compute** `summary` counts and the flat `failed[]` list.
+6. **Ensure** `~/.vibe/test-reports/` exists (`mkdir -p`, dir mode `0o700` — consistent with `~/.vibe/config.json`).
+7. **Write** `<ts>-<harness>.json` and `<ts>-<harness>.md`.
+8. **Print** the Markdown summary to the console.
+9. **If `summary.failed > 0`**, load skill `vibe-regress` with `subcommand: register --from-test` and pass the failed entries. P1 = any probe with `status: fail`.
+
+## Done Criteria
+
+- [ ] No external LLM call — file reads + vitest runs only
+- [ ] One probe failing never halts the overall run
+- [ ] Target install dir missing → clean exit with guidance (not an error)
+- [ ] JSON report matches the template above exactly (fields, types, naming)
+- [ ] Markdown summary printed to console after the run
+- [ ] Reports land in `~/.vibe/test-reports/`, never in project-local `.claude/vibe/`
+- [ ] `failed.length > 0` → auto-invokes `/vibe.regress register --from-test`

package/skills/video-production/SKILL.md

@@ -1,52 +1,52 @@
----
-name: video-production
-tier: standard
-description: "Video processing gotchas — FFmpeg commands, transcoding pipelines, HLS/DASH streaming setup, subtitle embedding (SRT/VTT), and thumbnail extraction. Use when the project involves any video manipulation, media processing, or streaming infrastructure. Covers codec selection, bitrate optimization, and common FFmpeg pitfalls. Must use this skill when user works with video files, mentions FFmpeg, or needs media processing — even for simple tasks like 'generate a thumbnail'."
-triggers: [video, ffmpeg, transcode, encode, stream, media, subtitle, thumbnail, hls, dash]
-priority: 60
----
-
-# Video Production
-
-## Pre-check (K1)
-
-> Are you processing video files programmatically? If just embedding a YouTube/Vimeo player, this skill is not needed.
-
-## Gotchas
-
-| Gotcha | Consequence | Prevention |
-|--------|-------------|------------|
-| Direct CLI string concatenation | Command injection risk | Always use wrapper library (fluent-ffmpeg for TS, ffmpeg-python for Python) |
-| No input validation | Crash on corrupted files | Always `ffprobe` input before processing — check codec, resolution, duration |
-| No temp file cleanup | Disk fills up silently | `try/finally` or cleanup handler — never leave partial outputs |
-| No progress callback | Long encoding appears frozen | Implement progress events for any operation >10s |
-| Memory loading large files | OOM on 4K+ video | Use streaming I/O, never read entire file into memory |
-| Assuming codec availability | Fails on different FFmpeg builds | Check `ffmpeg -codecs` at runtime before encoding |
-| Fixed bitrate encoding | Inconsistent quality | Use CRF-based quality (18-28 for H.264) instead |
-| No timeout | Encoding hangs forever | Set timeout + kill process on expiry |
-
-## Codec Quick Reference
-
-| Use Case | Codec | Note |
-|----------|-------|------|
-| Maximum compatibility | H.264 (libx264) | CRF 23 default |
-| Smaller files | H.265 (libx265) | 50% smaller, slower, licensing issues |
-| Open source | VP9 (libvpx-vp9) | Good for WebM |
-| Best compression | AV1 (libaom-av1) | Very slow encoding |
-
-## Resolution Presets
-
-| Preset | Resolution | Bitrate (H.264) |
-|--------|-----------|-----------------|
-| 360p | 640x360 | 800 kbps |
-| 720p | 1280x720 | 3 Mbps |
-| 1080p | 1920x1080 | 6 Mbps |
-| 4K | 3840x2160 | 15 Mbps |
-
-## Done Criteria (K4)
-
-- [ ] All FFmpeg calls go through wrapper library (no raw CLI strings)
-- [ ] Input files validated with ffprobe before processing
-- [ ] Temp files cleaned up in all paths (success + error)
-- [ ] Progress reporting for long operations
-- [ ] Codec availability checked at runtime
+---
+name: video-production
+tier: standard
+description: "Video processing gotchas — FFmpeg commands, transcoding pipelines, HLS/DASH streaming setup, subtitle embedding (SRT/VTT), and thumbnail extraction. Use when the project involves any video manipulation, media processing, or streaming infrastructure. Covers codec selection, bitrate optimization, and common FFmpeg pitfalls. Must use this skill when user works with video files, mentions FFmpeg, or needs media processing — even for simple tasks like 'generate a thumbnail'."
+triggers: [video, ffmpeg, transcode, encode, stream, media, subtitle, thumbnail, hls, dash]
+priority: 60
+---
+
+# Video Production
+
+## Pre-check (K1)
+
+> Are you processing video files programmatically? If just embedding a YouTube/Vimeo player, this skill is not needed.
+
+## Gotchas
+
+| Gotcha | Consequence | Prevention |
+|--------|-------------|------------|
+| Direct CLI string concatenation | Command injection risk | Always use wrapper library (fluent-ffmpeg for TS, ffmpeg-python for Python) |
+| No input validation | Crash on corrupted files | Always `ffprobe` input before processing — check codec, resolution, duration |
+| No temp file cleanup | Disk fills up silently | `try/finally` or cleanup handler — never leave partial outputs |
+| No progress callback | Long encoding appears frozen | Implement progress events for any operation >10s |
+| Memory loading large files | OOM on 4K+ video | Use streaming I/O, never read entire file into memory |
+| Assuming codec availability | Fails on different FFmpeg builds | Check `ffmpeg -codecs` at runtime before encoding |
+| Fixed bitrate encoding | Inconsistent quality | Use CRF-based quality (18-28 for H.264) instead |
+| No timeout | Encoding hangs forever | Set timeout + kill process on expiry |
+
+## Codec Quick Reference
+
+| Use Case | Codec | Note |
+|----------|-------|------|
+| Maximum compatibility | H.264 (libx264) | CRF 23 default |
+| Smaller files | H.265 (libx265) | 50% smaller, slower, licensing issues |
+| Open source | VP9 (libvpx-vp9) | Good for WebM |
+| Best compression | AV1 (libaom-av1) | Very slow encoding |
+
+## Resolution Presets
+
+| Preset | Resolution | Bitrate (H.264) |
+|--------|-----------|-----------------|
+| 360p | 640x360 | 800 kbps |
+| 720p | 1280x720 | 3 Mbps |
+| 1080p | 1920x1080 | 6 Mbps |
+| 4K | 3840x2160 | 15 Mbps |
+
+## Done Criteria (K4)
+
+- [ ] All FFmpeg calls go through wrapper library (no raw CLI strings)
+- [ ] Input files validated with ffprobe before processing
+- [ ] Temp files cleaned up in all paths (success + error)
+- [ ] Progress reporting for long operations
+- [ ] Codec availability checked at runtime

package/skills/video-production/rubrics/quality-checklist.md

@@ -1,58 +1,58 @@
-# Video Quality Checklist
-
-## Pre-Processing
-
-- [ ] Input file exists and is readable before pipeline starts
-- [ ] `ffprobe` run on input — codec, resolution, duration, bitrate logged
-- [ ] Corrupted/truncated files rejected with clear error (not crash)
-- [ ] Input resolution within supported range (min 360p, max 4K)
-- [ ] Audio stream present — handle gracefully if missing
-
-## Encoding
-
-- [ ] CRF-based encoding used (not fixed bitrate) for consistent visual quality
-- [ ] Target codec available in current FFmpeg build (`ffmpeg -codecs` check)
-- [ ] Encoding runs through wrapper library — no raw CLI string concatenation
-- [ ] `-movflags +faststart` set for MP4 (enables streaming before full download)
-- [ ] Audio normalized: loudness target -16 LUFS (streaming standard)
-- [ ] Aspect ratio preserved — no unintended stretching
-
-## Progress & Monitoring
-
-- [ ] Progress events emitted for any operation exceeding 10 seconds
-- [ ] Encoding timeout configured — process killed on expiry
-- [ ] Estimated time remaining shown in progress (based on bitrate processed)
-
-## Output Validation
-
-- [ ] Output file exists after encoding completes
-- [ ] Output duration verified: within ±2 seconds of input
-- [ ] Output codec matches requested codec (re-run ffprobe on output)
-- [ ] Output file size within acceptable range (flag if >3x input size)
-- [ ] Thumbnail: correct dimensions, not blank/corrupted
-
-## Subtitles (if applicable)
-
-- [ ] Subtitle file encoding is UTF-8 (convert if needed)
-- [ ] Subtitle timing verified — first/last cue in range of video duration
-- [ ] Burn-in subtitles visually tested on dark and light scenes
-
-## HLS / DASH Streaming (if applicable)
-
-- [ ] `.m3u8` manifest references correct segment file names
-- [ ] All segment files present in output directory
-- [ ] Segment duration consistent (target ±1 second of configured value)
-- [ ] CORS headers configured on media server
-
-## Storage & Cleanup
-
-- [ ] Temp directory cleaned in `finally` block — both success and error paths
-- [ ] No partial output files left on disk after failure
-- [ ] Output written to separate directory from temp files
-- [ ] Disk space checked before processing large files (minimum 3x input size free)
-
-## Security
-
-- [ ] Input file path sanitized — no directory traversal (`../`)
-- [ ] FFmpeg invoked via array arguments (not shell string) to prevent injection
-- [ ] Max file size limit enforced before processing begins
+# Video Quality Checklist
+
+## Pre-Processing
+
+- [ ] Input file exists and is readable before pipeline starts
+- [ ] `ffprobe` run on input — codec, resolution, duration, bitrate logged
+- [ ] Corrupted/truncated files rejected with clear error (not crash)
+- [ ] Input resolution within supported range (min 360p, max 4K)
+- [ ] Audio stream present — handle gracefully if missing
+
+## Encoding
+
+- [ ] CRF-based encoding used (not fixed bitrate) for consistent visual quality
+- [ ] Target codec available in current FFmpeg build (`ffmpeg -codecs` check)
+- [ ] Encoding runs through wrapper library — no raw CLI string concatenation
+- [ ] `-movflags +faststart` set for MP4 (enables streaming before full download)
+- [ ] Audio normalized: loudness target -16 LUFS (streaming standard)
+- [ ] Aspect ratio preserved — no unintended stretching
+
+## Progress & Monitoring
+
+- [ ] Progress events emitted for any operation exceeding 10 seconds
+- [ ] Encoding timeout configured — process killed on expiry
+- [ ] Estimated time remaining shown in progress (based on bitrate processed)
+
+## Output Validation
+
+- [ ] Output file exists after encoding completes
+- [ ] Output duration verified: within ±2 seconds of input
+- [ ] Output codec matches requested codec (re-run ffprobe on output)
+- [ ] Output file size within acceptable range (flag if >3x input size)
+- [ ] Thumbnail: correct dimensions, not blank/corrupted
+
+## Subtitles (if applicable)
+
+- [ ] Subtitle file encoding is UTF-8 (convert if needed)
+- [ ] Subtitle timing verified — first/last cue in range of video duration
+- [ ] Burn-in subtitles visually tested on dark and light scenes
+
+## HLS / DASH Streaming (if applicable)
+
+- [ ] `.m3u8` manifest references correct segment file names
+- [ ] All segment files present in output directory
+- [ ] Segment duration consistent (target ±1 second of configured value)
+- [ ] CORS headers configured on media server
+
+## Storage & Cleanup
+
+- [ ] Temp directory cleaned in `finally` block — both success and error paths
+- [ ] No partial output files left on disk after failure
+- [ ] Output written to separate directory from temp files
+- [ ] Disk space checked before processing large files (minimum 3x input size free)
+
+## Security
+
+- [ ] Input file path sanitized — no directory traversal (`../`)
+- [ ] FFmpeg invoked via array arguments (not shell string) to prevent injection
+- [ ] Max file size limit enforced before processing begins