Skills
.Work. You
Rest

harness-troubleshoot

Community

Unblock Claude Code harness enforcement

Software Engineering#state management#troubleshooting#claude code#enforcement#harness#automation scripts#scope mismatch
AuthorElvinOuyang
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps you diagnose and fix Claude Code harness enforcement issues that prevent progress, such as infinite stop-hook loops, scope mismatches, stale harness state, stuck phases, or hooks not firing.

Core Features & Use Cases

  • Decision-tree troubleshooting to pinpoint the exact harness failure mode based on symptoms like “can’t stop,” “phases won’t mark complete,” or “hook not working.”
  • Targeted recovery steps for the most common harness breakdowns, including loop gate resets, scope override adjustments, harness state reinitialization, phase verification workflows, and hook wiring checks.
  • Use case: when you hit a harness error after modifying code or switching branches and Claude is either blocked forever or skipping required enforcement, use this Skill to quickly restore correct harness behavior.

Quick Start

Ask the AI to diagnose your harness issue and recommend the most likely fix based on the symptoms you’re seeing.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: harness-troubleshoot
Download link: https://github.com/ElvinOuyang/claude-skill-collection/archive/main.zip#harness-troubleshoot

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.