gauntlet-help

Diagnose gauntlet stop-hook and gate failures from runtime artifacts and CLI outputs.

29|2|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/pacaplan/agent-gauntlet --skill gauntlet-help
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gauntlet-help
Source: https://github.com/pacaplan/agent-gauntlet/tree/main/.claude/skills/gauntlet-help
Command: npx skills add https://github.com/pacaplan/agent-gauntlet --skill gauntlet-help

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps diagnose gauntlet stop-hook and gate failures using runtime artifacts and CLI outputs, clarifying what happened and why.

Core Features & Use Cases

  • Evidence-based diagnosis using files like .gauntlet/config.yml, .gauntlet/.debug.log, gauntlet logs such as console..log, check_.log, and review_*.json to pinpoint root causes.
  • Explains findings with explicit evidence and differentiates between confirmed facts and inferences to support remediation decisions.
  • Useful for troubleshooting recurring stop-hook issues, CI wait states, and adapter health through structured reasoning.

Quick Start

Examine runtime artifacts and gauntlet logs to begin diagnosing the stop-hook or gate failure.

Frequently Asked Questions about gauntlet-help

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose gauntlet stop-hook failures using runtime artifacts?

Diagnose gauntlet stop-hook failures by analyzing runtime artifacts like .gauntlet/config.yml, .gauntlet/.debug.log, and review JSON files. This process uncovers root causes by examining console logs and CLI outputs to pinpoint exactly what triggered the failure.

Why is my gauntlet gate dispatch stuck in a CI wait state?

A gauntlet gate dispatch may stall in a CI wait state due to adapter health issues or configuration errors. Examine .gauntlet/config.yml, .debug.log, and check_*.log runtime artifacts to find the root cause and resolve the blockage.

What logs do I need to troubleshoot recurring gauntlet stop-hook issues?

Troubleshooting recurring gauntlet stop-hook issues requires console.*.log, check_*.log, review_*.json, and .gauntlet/.debug.log runtime artifacts. These files provide the structured evidence needed to diagnose and resolve repetitive failures.

How does evidence-based diagnosis differentiate confirmed findings from inferences?

Evidence-based diagnosis differentiates confirmed findings from inferences by explicitly citing sources from gauntlet runtime artifacts and CLI outputs. This distinction clarifies which root causes are verified facts and which are logical deductions for remediation.

Can I use gauntlet logs to check adapter health during gate failures?

Yes, you can check adapter health during gate failures by analyzing gauntlet logs and runtime artifacts. Examining .gauntlet/config.yml and .debug.log reveals adapter status and helps identify whether the adapter caused the failure.

What is the best way to find the root cause of a gauntlet CI wait scenario?

The best way to find the root cause of a gauntlet CI wait scenario is by analyzing review_*.json, console.*.log, and .gauntlet/.debug.log. This evidence-based approach traces the failure back to its source for actionable remediation.