debug-my-harness

80 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By zernie/vigiles (GitHub) · coding · 15 stars · scanned at commit 1a1de50

Diagnose why an agent harness misbehaved by reading the local flight-recorder ledger (.vigiles/runs.jsonl) — which skills fired or got hijacked, which hooks blocked or wrongly allowed, which subagent tool-contract violations happened, and how a skill's trigger rate moved. Use when asked why a skill stopped firing, why a hook didn't block, why the wrong skill ran, or to debug/investigate what the harness actually did. NOT for writing new rules (use strengthen) or editing the spec (use edit-spec).

Works with any agent that supports SKILL.md skills.

What this skill can do

Runs commands on your computer

The author does not mention this. It runs automatically when the plugin is installed. Expected for a coding skill.

Found in 5 places.

.claude-plugin/plugin.json, line 19"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pre-edit.sh"
.claude-plugin/plugin.json, line 30"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/post-edit.sh"
.claude-plugin/plugin.json, line 39"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/refs-nudge.sh"

Show 2 more

.claude-plugin/plugin.json, line 48"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/eval-lock-nudge.sh"
.claude-plugin/plugin.json, line 59"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh"

Downloads and installs other software

The author does not mention this. It runs automatically when the plugin is installed.

Found in 6 places.

hooks/eval-lock-nudge.sh, line 25printf '%s' "$INPUT" | npx vigiles hook-runtime eval-lock-nudge
hooks/post-edit.sh, line 22npx vigiles generate types 2>&1 || true
hooks/post-edit.sh, line 31npx vigiles compile 2>&1 || true

Show 3 more

hooks/pre-edit.sh, line 343. Run: npx vigiles compile
hooks/refs-nudge.sh, line 16printf '%s' "$INPUT" | npx vigiles hook-runtime refs
hooks/session-start.sh, line 30SUMMARY=$(npx --no-install vigiles lint --summary 2>/dev/null || true)

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'debug-my-harness' ] || [ -L ~/.agents/skills/'debug-my-harness' ]; then echo 'A skill folder named debug-my-harness already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/zernie/vigiles' "$d" && git -C "$d" checkout --quiet '1a1de50f62f5c1093a46455488dcf6e8157c6182' -- 'skills/debug-my-harness' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/debug-my-harness' ~/.agents/skills/'debug-my-harness' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'debug-my-harness' ~/.claude/skills/'debug-my-harness' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for zernie/vigiles shows the score of its lowest-scoring skill.

SkillTrust badge for zernie/vigiles

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/zernie/vigiles.svg)](https://zalavijaysinh.github.io/skilltrust/repos/zernie/vigiles/)

Score history

Date	Version	Score
2026-11-08	`1a1de50`	80