propose-harness-improvement

Diagnose recurring agent failures, classify root causes, and document fixes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/tuanle96/agent-harness-kit --skill propose-harness-improvement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propose-harness-improvement
Source: https://github.com/tuanle96/agent-harness-kit/tree/main/src/templates/.claude/skills/propose-harness-improvement
Command: npx skills add https://github.com/tuanle96/agent-harness-kit --skill propose-harness-improvement

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps identify and systematically address recurring agent failures, preventing future errors through structured problem analysis and documentation.

Core Features & Use Cases

  • Failure analysis and triage: Guides users through diagnosing what went wrong during agent execution.
  • Root cause classification: Helps determine whether issues stem from missing context, rules, skills, architecture, or prompt design.
  • Process documentation: Automates logging of failure details and fixes into docs/agent-failures.md.
  • Use Case: A developer notices the agent consistently misbehaves in a certain scenario and uses this Skill to trace, classify, and document the fix for future reference.

Quick Start

Ask the AI to analyze a recent agent failure and generate a structured report for improvement.

Frequently Asked Questions about propose-harness-improvement

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

FAQPage Schema
How do I systematically analyze agent failures and prevent recurring errors?

To systematically analyze agent failures, you diagnose execution errors, classify root causes by context or architecture, and document fixes to prevent recurring errors. This structured process logs failure details directly into your system documentation.

What is the best way to document recurring agent execution errors for future reference?

Documenting recurring agent execution errors is achieved by logging failure details and their corresponding fixes into a dedicated markdown file. This creates a permanent record in your system documentation for future troubleshooting and fault prevention.

How do I classify the root causes of agent misbehavior during debugging?

Classifying root causes of agent misbehavior involves determining whether failures stem from missing context, broken rules, inadequate skills, flawed architecture, or poor prompt design. This categorization targets the exact source for effective fault prevention.

Can I use this approach to triage agent failures without external dependencies?

Yes, you can triage agent failures without external dependencies because the process operates independently using built-in scripts and references. It guides you through diagnosing execution errors and generating structured reports natively.

Why does my AI agent consistently fail in specific scenarios and how can I trace it?

When an AI agent consistently fails in specific scenarios, tracing the issue requires structured problem analysis to identify missing context or prompt design flaws. Documenting these findings improves overall system robustness and prevents future recurrences.

What are the limitations of relying on manual debugging for agent failure analysis?

Manual debugging for agent failure analysis lacks systematic categorization and automated process documentation, making it harder to prevent future errors. A structured approach ensures failures are consistently classified and logged for robust fault prevention.