surendranb

Interpreting Errors — Development skill for Claude Code

Development community

Error shapes — no matches, transient upstream failures, and the Gutenberg fallback path.

How to install Interpreting Errors

Installs to ~/.claude/skills/surendranb-book-recommendations-interpreting-errors/SKILL.md

Terminal

mkdir -p ~/.claude/skills/surendranb-book-recommendations-interpreting-errors && curl -fsSL https://raw.githubusercontent.com/surendranb/book-recommendations/HEAD/skills/interpreting-errors.md -o ~/.claude/skills/surendranb-book-recommendations-interpreting-errors/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Interpreting Errors does

description: Error shapes — no matches, transient upstream failures, and the Gutenberg fallback path.

Interpreting errors

`[INPUT_FIXABLE]`

"No books matched" (recommend): the query was too narrow for OpenLibrary. Broaden it ("quiet Japanese novels" instead of "quiet postwar Japanese novels about glassblowing"), drop the exclude list, or switch to blind_date() for serendipity.

`[TRANSIENT]`

"shelf came back empty" (blind_date): OpenLibrary was busy or the

Alternatives in Development

Param Discover — Discover hidden HTTP parameters on a URL or list of URLs using Arjun (or x8 fallback) 4.5k ★
n8n Validation Expert — Fix n8n validation errors with error catalog 3.6k ★
Resolve Drizzle Migrations — Resolve Drizzle migration conflicts by accepting upstream and regenerating local migrations 2.5k ★

Full documentation available on GitHub

View Source Repository