# fix-agent-issue

> Claude/Codex skill by [@mlflow](https://omgskills.com/library/mlflow/index.md) · 82 stars · Updated 2026-10-23

Fix or change an AI agent's behavior using MLflow traces and regression tests. Use for wrong or incomplete answers, hallucinations, missing tool calls, new business rules, trace-driven debugging, or context and token-cost optimization. Diagnose the actual failure, plan a test, implement the smallest fix, and verify the new behavior without breaking existing cases.

## Install

```sh
git clone https://github.com/mlflow/skills /tmp/skills && ln -s /tmp/skills/fix-agent-issue ~/.claude/skills/fix-agent-issue
```

## From README

Fix Agent Issue The user wants to change an AI agent's behavior — either because something is wrong (pointing at a trace, pasting an answer they didn't like, describing a failure mode) or because they're introducing a new requirement, business rule, or policy ("lead with our premium line," "never reveal internal docs," "always confirm the order ID first"). A new business rule is not a bug, but it earns the same discipline: it's a behavior change that can silently break other behaviors, so it goes through the loop too. They want the change made with confidence that it sticks and doesn't regress anything else. Drive a disciplined improvement loop, never a one-shot patch. The non-negotiable loop EXPLORE → PLAN → IMPLEMENT → VERIFY, in that order. Don't skip phases. Don't edit anything in EXPLORE. Don't write code in PLAN. Don't change tests in VERIFY.

## Links

- HTML page: https://omgskills.com/library/mlflow/skills/fix-agent-issue/
- GitHub: https://github.com/mlflow/skills
- Author: [@mlflow](https://omgskills.com/library/mlflow/index.md)

## More from this repo

- [agent-evaluation](https://omgskills.com/library/mlflow/skills/agent-evaluation/index.md) — Use this when you need to EVALUATE OR IMPROVE or OPTIMIZE an existing LLM agent's output quality - including improving...
   - [@mlflow](https://omgskills.com/library/mlflow/index.md) · 82 stars
- [analyzing-mlflow-session](https://omgskills.com/library/mlflow/skills/analyze-mlflow-chat-session/index.md) — Analyzes an MLflow session — a sequence of traces from a multi-turn chat conversation or interaction.
   - [@mlflow](https://omgskills.com/library/mlflow/index.md) · 82 stars
- [analyzing-mlflow-trace](https://omgskills.com/library/mlflow/skills/analyze-mlflow-trace/index.md) — Analyzes a single MLflow trace to answer a user query about it.
   - [@mlflow](https://omgskills.com/library/mlflow/index.md) · 82 stars