hooks/skills/repair/SKILL.md

name, description

name	description
repair	Repair failed hook wiring by delegating diagnosis to installed AI agent CLIs as subagents, patching the hooks repo, syncing manifests, and opening a PR against develop. Use when hooks-install or report-error.sh reports a failed hook, or when a hook keeps failing after rewiring; not for routine wiring or unrelated work.

repair — repair a failed hook

Single source of guidelines: ../../references/guidelines.md.

Flow

1. Read the failure context from ERROR_{HASH} through jsc-gitea:wiki or from the failed status= line, then confirm the target repo is hooks and the PR base branch is develop. Completion condition: the failure context and target branch are explicit.
2. Detect installed AI CLIs with ../cli/tools/detect-clis.sh, then delegate diagnosis to one subagent per available CLI. Each subagent must receive the failure context and the /jsc-shared:spec-output rules, must stay read-only, and must return one structured repair proposal: root cause, changed files, and verification command. Completion condition: every available CLI has one returned proposal, or there are no CLIs and the main agent has noted that it must diagnose alone.
3. Pick the smallest repair that makes the wiring pass, then apply it in the hooks repo. If the fix touches wiring behavior, update hooks/tools/wire-cli.sh, hooks/skills/hooks-install/SKILL.md, and hooks/README.md together. Run the relevant verification command before moving on. Completion condition: the fix is on disk and the verification command passes.
4. Run ../meta/tools/sync-skill-manifest.sh .. Completion condition: the README skill list and all three manifests show the same new version.
5. Commit, push, and open a PR with jsc-git:pr develop. Completion condition: a PR URL comes back and the repair is ready for review.