# Claude Gladiator

> Use after tool failures or user corrections to record patterns, and when accumulated observations need clustering into rule/hook/skill recommendations. Builds project-specific knowledge that persists across sessions.

- Skill: `vvkmnn/claude-gladiator-2` (Agent Skill)
- Install (CLI): `npx get-skill add vvkmnn/claude-gladiator-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vvkmnn/claude-gladiator-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vvkmnn (https://skillmd.com/u/vvkmnn)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/vvkmnn/claude-gladiator-2

---


# Claude Gladiator

Record mistakes and corrections. Cluster them into actionable recommendations for rules, hooks, and skills.

## When to Observe

**After tool failures:**
- Edit returned `old_string not unique` → Record disambiguation strategy
- Bash command failed → Record correct approach
- Any tool error with a non-obvious fix → Record what worked

**After user corrections:**
- User corrected file structure, naming, or approach → Record the convention
- User preferred a different strategy → Record the preference

```
gladiator_observe(
  summary: "Edit failed on config.ts — 3 identical import blocks, fixed by including surrounding function context",
  tags: ["edit", "disambiguation"],
  context: { error: "old_string not unique", before: "used import line only", after: "included 3 lines above" }
)
```

## When to Reflect

**When observations have accumulated** → `gladiator_reflect()` clusters unprocessed observations, scans existing `~/.claude/rules/`, `~/.claude/hooks/`, `~/.claude/skills/`, and recommends UPDATE to existing artifacts or CREATE new ones.

**Searching past patterns** → `gladiator_reflect(query: "edit")` finds all observations matching a topic.

**Checking stats** → `gladiator_reflect()` with nothing unprocessed shows observation counts by type.

## Quick Reference

| Tool | When | What it does |
|------|------|-------------|
| `gladiator_observe` | After failures, corrections, discoveries | Record pattern with summary, tags, context. Deduped by SHA-256. |
| `gladiator_reflect` | After accumulating observations | Cluster → scan existing config → recommend artifact changes. |

## Common Mistakes

| Mistake | Fix |
|---------|-----|
| Only observing failures | Also observe corrections, conventions, non-obvious solutions |
| Vague summaries | Include the specific error message, what was tried, what worked |
| Creating new rules when existing ones apply | Reflect scans existing artifacts — prefer UPDATE over CREATE |

