Skip to content

Cristhianzl/claude-skills-czl / configs/agnostic/skills/debugging-agent-runs

debugging-agent-runs

Verified

Recover when the AGENT itself is stuck — looping, repeating the same failed action, burning tokens/budget, overflowing context, drifting from the goal, or acting on stale state. Use when a run isn't converging and reworded retries aren't helping. This is a workflow you follow, not a hidden runtime that auto-heals. For bugs in the product code use fixing-bugs.

FileKindSize
SKILL.mdskill md3.3 KB
learnings/README.mdmarkdown789 B

learnings/README.md

View on GitHub
# Learnings

Project-specific knowledge that isn't in `SKILL.md` or `references/`. A learning **overrides** the defaults — the agent reads this folder first.

## When to add one

After you hit a convention, constraint, or trap specific to this project that isn't already captured. Prefer the `/learn` command — it greps for overlap first and decides **Save / Improve / Absorb / Drop** so this folder doesn't fill with duplicates.

## Format

One file per learning: `YYYY-MM-DD-short-slug.md`, body under ~30 lines. Frontmatter says when it applies, then the rule and why.

```markdown
---
description: <one line — when this applies>
---

<the rule>. **Why:** <the reason>. **How to apply:** <what to do>.
```

Keep it specific and current — if a learning becomes wrong, delete it.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall