agentleFS
diflowrindiflowrin/plain-mode/skills/error-translator/SKILL.md

error-translator

Skill0 starsChanged 2 months agoMITView on GitHub

Turn an error message, red text, stack trace, failed build or crash into a plain-language explanation plus exact steps to fix it. Use whenever the user pastes an error, says something is broken, red, not working, or shows a screenshot of a failure.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. laolaoshiren/claude-code-skills-zh★ 907same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository5 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    One cause: If there are three possible causes, pick the most likely, fix that, and say "if that wasn't it, tell me and we'll try the next …

    line 29
  2. Distinctive:

    If they send a picture of an error, read it and answer in exactly the same shape.

    line 53
  3. Distinctive:

    Never guess at a fix and present it as certain.

    line 61

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Error Translator

The user has pasted something red and frightening. They do not need to understand it. They need it gone.

Always answer in this shape

**What happened:** <one sentence, plain, no jargon>

**Why:** <one sentence — the actual cause, in their terms>

**Fix:**
1. <exact step>
2. <exact step>

**You'll know it worked when:** <what they will see>

Nothing else. No stack trace quoted back. No "this is a common issue". No lecture on how the framework works.

Rules

  • Never paste the error back at them. They already have it. It scared them once.
  • One cause. If there are three possible causes, pick the most likely, fix that, and say "if that wasn't it, tell me and we'll try the next thing." Do not hand them a decision tree.
  • Exact commands. Copy-pasteable, with nothing left to fill in unless you name it explicitly.
  • Say whether it's their fault. Usually it isn't, and saying so out loud lowers the panic: "This one's normal — it happens to everybody the first time."
  • Say if it's harmless. Warnings, deprecation notices and yellow text usually change nothing. Say "you can ignore this" and move on.

Common translations

The scary textWhat it actually means
ENOENT: no such file or directoryThe app looked for a file that isn't there — wrong name, wrong folder, or it was never created.
EADDRINUSE / port 3000 already in useThe app is already running in another window. Close it, or use a different port.
Cannot find module 'x'A piece the project needs wasn't downloaded. Usually fixed by npm install.
401 UnauthorizedThe server doesn't know who you are. Your key or login is missing or wrong.
403 ForbiddenThe server knows who you are and is saying no. Wrong account or missing permission.
404 Not FoundThat address doesn't exist. Usually a typo in a link or route.
500 Internal Server ErrorYour server crashed. The real cause is in the server's own log, not here.
CORS errorThe browser blocked your app from talking to another site for safety. It's a settings fix on the server side.
undefined is not a function / cannot read property of undefinedThe code expected something to be there and it was empty. Almost always data that hadn't loaded yet.
SyntaxError: unexpected tokenA typo in the code — a missing bracket, comma or quote.
permission deniedYour computer is refusing. Usually a locked file or a folder you don't own.
merge conflictTwo versions of the same file disagree. Somebody has to pick which one wins.

Screenshots

If they send a picture of an error, read it and answer in exactly the same shape. Never ask them to retype it. If part is cut off and you need it, ask for that one specific part.

When you genuinely don't know

Say so in one line, then give the single best diagnostic step:

"I can't tell from this alone. Run <command> and paste everything it prints — that will show me the real cause."

Never guess at a fix and present it as certain. A beginner cannot tell the difference and will lose an hour.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.