Agent skill

Do Not Retry Without Diagnosis

by aiming-lab in aiming-lab/MetaClaw

Common mistake — retrying the same failing command or API call without understanding why it failed.

MITAuto-check passedAI & LLM Engineering

Install Do Not Retry Without Diagnosis

skills CLI
$ npx skills add aiming-lab/MetaClaw --skill do-not-retry-without-diagnosis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aiming-lab/MetaClaw do-not-retry-without-diagnosis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aiming-lab/MetaClaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/memory_data/skills/do-not-retry-without-diagnosis .claude/skills/do-not-retry-without-diagnosis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
do-not-retry-without-diagnosis
GitHub stars
3.5k
Token cost
~189 tokens
SKILL.md length
73 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Common mistake — retrying the same failing command or API call without understanding why it failed.

  • Tasks that involve Root cause analysis
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Do Not Retry Without Diagnosis is an agent skill from aiming-lab/MetaClaw. Common mistake — retrying the same failing command or API call without understanding why it failed. Always diagnose the root cause before retrying anything.

Its SKILL.md is about 190 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Root cause analysis. The repository describes itself as: 🦞 Just talk to your agent — it learns and EVOLVES 🧬. The licence is MIT.

When your agent uses it

  • Tasks that involve Root cause analysis

Example prompts

  • “/do-not-retry-without-diagnosis”

What it can do on your machine

Read from SKILL.md and the folder at commit 922caf3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Do Not Retry Without Diagnosis loads about 189 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 73 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~189

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aiming-lab/MetaClaw at commit 922caf3, republished under its MIT licence (© aiming-lab). 73 words, ~189 tokens.

Download SKILL.mdSave it as .claude/skills/do-not-retry-without-diagnosis/SKILL.md (or your agent's skills folder).
name
do-not-retry-without-diagnosis
description
Common mistake — retrying the same failing command or API call without understanding why it failed. Always diagnose the root cause before retrying anything.
category
common_mistakes

Do Not Retry Without Diagnosis

Mistake pattern: Tool call fails → retry the same call → fails again → repeat.

Fix: After the first failure, read the error message carefully and diagnose the root cause before retrying.

Questions to ask:

  • Is this a transient error (network timeout, rate limit)? Retry with backoff.
  • Is this a permanent error (wrong input, missing resource, permission denied)? Fix the cause.

Anti-pattern: Blindly retrying or escalating without examining the error output.

© aiming-lab, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in memory_data/skills/do-not-retry-without-diagnosis of aiming-lab/MetaClaw.

Open the folder on GitHubat commit 922caf3

Compare with similar skills

Do Not Retry Without Diagnosis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Do Not Retry Without Diagnosis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Do Not Retry Without Diagnosis this skillaiming-lab/MetaClaw3.5k—~189Automated safety check: PassMIT
ML Failure DebuggerLeeroo-AI/superml195—~9.5kAutomated safety check: PassApache-2.0
Train Infer Consistencyverl-project/verl-omni1.2k—~860Automated safety check: PassApache-2.0
The Art of Debuggingstas00/the-art-of-debugging1.7k—~6.1kAutomated safety check: NotesCC-BY-SA-4.0
Xpu CI Health Checkintel/torch-xpu-ops115—~1.5kAutomated safety check: PassApache-2.0
Datadog Query Recipeslangfuse/langfuse36k—~824Automated safety check: PassCustom licence

Similar skills

  • ML Failure Debugger

    Leeroo-AI/superml

    Diagnoses failing ML and AI work, such as OOM, NaN, divergence, crashes, slow throughput, wrong outputs and dependency conflicts, with every claim backed by documentation citations.

    195 GitHub stars~9.5k tokensUpdated 6 mo ago
    AI & LLM EngineeringAuto-check passed
  • Train Infer Consistency

    verl-project/verl-omni

    Route verl-omni training/inference consistency checks through MindStudio's MSProbe collection and root-cause analysis skills.

    1.2k GitHub stars~860 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • The Art of Debugging

    stas00/the-art-of-debugging

    Condensed debugging method and tool recipes for Unix, Python and PyTorch programs: crashes, hangs, segfaults, wrong output, CUDA OOM, NaN values and slowness.

    1.7k GitHub stars~6.1k tokensUpdated 4 days ago
    DevelopmentAuto-check: notes
  • Xpu CI Health Check

    intel/torch-xpu-ops

    Official

    Check PyTorch ciflow/xpu (xpu.yml) on the main branch, collect the failing XPU test cases from the most recent completed run(s), analyze the ROOT CAUSE of each failure with AI, and produce a list…

    115 GitHub stars~1.5k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Datadog Query Recipes

    langfuse/langfuse

    Research Langfuse production telemetry with reusable Datadog queries.

    36k GitHub stars~824 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Tma Illegal Instruction

    facebookexperimental/triton

    Official

    Diagnose CUDA "illegal instruction" / kernel crashes on Triton kernels that reference to TMA loads or stores (maketensordescriptor, TensorDescriptor, descriptor.load, descriptor.store…

    201 GitHub stars~1.1k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from aiming-lab/MetaClaw

All 36 skills in this repo
  • Data Validation First

    aiming-lab/MetaClaw

    Use this skill before any data analysis, transformation, or modeling.

    3.5k GitHub stars~230 tokensUpdated 4 mo ago
    Auto-check passed
  • A skill your agent uses when implementing any endpoint, form handler, CLI tool, or function that accepts external input.

    3.5k GitHub stars~251 tokensUpdated 4 mo ago
    Auto-check passed
  • A skill your agent uses when writing shell scripts, Python automation, or any unattended batch job.

    3.5k GitHub stars~225 tokensUpdated 4 mo ago
    Auto-check passed
  • A skill your agent uses when building production services, pipelines, or automation that needs to be debugged, monitored, or audited.

    3.5k GitHub stars~247 tokensUpdated 4 mo ago
    Auto-check passed
  • Agent Task Handoff

    aiming-lab/MetaClaw

    A skill your agent uses when delegating a subtask to a sub-agent, spawning a parallel worker, or handing off work across sessions.

    3.5k GitHub stars~258 tokensUpdated 4 mo ago
    Auto-check passed
  • A skill your agent uses when writing messages in async channels (Slack, GitHub issues, email threads) where the reader may not have context and cannot ask follow-up questions immediately.

    3.5k GitHub stars~224 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Do Not Retry Without Diagnosis

What does Do Not Retry Without Diagnosis do?

Common mistake — retrying the same failing command or API call without understanding why it failed. Do Not Retry Without Diagnosis is an agent skill from aiming-lab/MetaClaw. Common mistake — retrying the same failing command or API call without understanding why it failed.

When should I use Do Not Retry Without Diagnosis?

Do Not Retry Without Diagnosis fits situations like: tasks that involve Root cause analysis.

How do I install Do Not Retry Without Diagnosis in Claude Code?

Run `npx skills add aiming-lab/MetaClaw --skill do-not-retry-without-diagnosis -a claude-code`. Or copy the skill folder (memory_data/skills/do-not-retry-without-diagnosis in aiming-lab/MetaClaw) into .claude/skills/do-not-retry-without-diagnosis in your project. Claude Code loads it when a task matches its description.

How do I install Do Not Retry Without Diagnosis in Codex?

Run `npx skills add aiming-lab/MetaClaw --skill do-not-retry-without-diagnosis -a codex`. Or copy the skill folder (memory_data/skills/do-not-retry-without-diagnosis in aiming-lab/MetaClaw) into .agents/skills/do-not-retry-without-diagnosis in your project. Codex loads it when a task matches its description.

Can I use Do Not Retry Without Diagnosis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aiming-lab/MetaClaw --skill do-not-retry-without-diagnosis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/do-not-retry-without-diagnosis, .gemini/skills/do-not-retry-without-diagnosis, .github/skills/do-not-retry-without-diagnosis and .opencode/skills/do-not-retry-without-diagnosis in your project.

What does Do Not Retry Without Diagnosis need to run?

SKILL.md names no scripts, command-line tools or credentials: Do Not Retry Without Diagnosis is instructions for the agent only.

Does Do Not Retry Without Diagnosis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Do Not Retry Without Diagnosis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Do Not Retry Without Diagnosis use?

Do Not Retry Without Diagnosis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Do Not Retry Without Diagnosis use?

About 189 tokens (SKILL.md is roughly 756 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Do Not Retry Without Diagnosis?

Skills that share tags, products or a category with Do Not Retry Without Diagnosis: ML Failure Debugger (Leeroo-AI/superml, 195 stars), Train Infer Consistency (verl-project/verl-omni, 1.2k stars), The Art of Debugging (stas00/the-art-of-debugging, 1.7k stars) and Xpu CI Health Check (intel/torch-xpu-ops, 115 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Do Not Retry Without Diagnosis?

aiming-lab (a GitHub organization) maintains it in aiming-lab/MetaClaw, which has 3,459 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on June 7, 2026.

Source: aiming-lab/MetaClaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.