ClaudSkills / Security / identity-access

API Error Handling Design

Q: What is a Claude Code skill and how does the API Error Handling Design skill fit in?

A Claude Code skill is a SKILL.md file that lives under ~/.claude/skills/<name>/ and tells the Claude Code CLI agent how to perform a specific task (instructions, prompts, allowed tools). Skills are auto-discovered at session start. API Error Handling Design is one of 67,000+ skills indexed in the open ClaudSkills catalog, classified under the Security category. Learn more at https://claudskills.com/learn/what-is-skill-md/.

Category: Security · Sub-category: identity-access · Last updated: 2026-05-21

tool:salesforce type:integration

Designing HTTP error classification, RFC 7807-style error payload structure, and client-side error parsing for Salesforce REST/SOAP integrations and custom Apex REST endpoints. Use when deciding which HTTP status codes to return from custom Apex REST services, how to structure error response bodies, how to classify inbound API errors as retry-safe vs non-retry-safe, or how to parse Salesforce error responses on the consumer side. NOT for retry execution mechanics or circuit breaker implementation (use retry-and-backoff-patterns). NOT for Apex exception class design (use apex-error-handling-framework). NOT for OAuth error flows (use oauth-flows-and-connected-apps).

About this skill (catalog notes)

API Error Handling Design includes pricing or quota commentary; at least one code block. At roughly 2,610 words the SKILL.md is on the longer end of the catalog distribution.

Source: pypi.org/project/sfskills-mcp
License: Apache-2.0
Original author: Pranav Nagrecha
Indexed lastmod: 2026-05-21
Catalog position: Security · identity-access
Indexed related skills: 10

How API Error Handling Design fits the catalog

API Error Handling Design sits in the Security category under the identity-access sub-topic in the ClaudSkills catalog. There are 10 related skills indexed alongside it; comparing a few before installing usually reveals which fits your workflow best.

These notes are auto-generated from features detected in the SKILL.md file and from this catalog's structure — they aren't part of the source repository.

From the source SKILL.md

This skill activates when a practitioner needs to design the error contract for an integration — deciding which HTTP status codes to return, how to structure error response bodies, how to classify inbound errors as safe or unsafe to retry, how to parse Salesforce's own error response format, and how to handle callout timeouts. It covers both the producer side (custom Apex REST endpoints) and the consumer side (Apex callouts to external systems or to Salesforce). It does not cover retry execution mechanics, which belong in retry-and-backoff-patterns.

What this skill does

API Error Handling Design is a community-contributed Claude Code skill in the identity-access sub-category. It ships as a SKILL.md file that Claude Code auto-discovers under ~/.claude/skills/api-error-handling-design/ and loads when your prompt matches the skill's trigger.

When to invoke it: Use when deciding which HTTP status codes to return from custom Apex REST services, how to structure error response bodies, how to classify inbound API errors as retry-safe vs non-retry-safe, or how to parse Salesforce error responses on the consumer side. NOT for retry execution mechanics or circuit breaker implementation (use retry-and-backoff-patterns).

Who uses this skill

The API Error Handling Design Claude Code skill is built for security engineers, penetration testers, DevSecOps practitioners, and development teams hardening codebases and infrastructure. It's part of ClaudSkills (also referred to as Claude Skills or Claude Code Skills) — the open community-curated registry of 116,000+ SKILL.md files for Anthropic's Claude Code agent and the wider Claude ecosystem (Claude API, Claude Agent SDK).

How to install

Free

Manual install (2 steps)

mkdir -p ~/.claude/skills/api-error-handling-design
curl -L https://claudskills.com/skills/api-error-handling-design/SKILL.md \
  -o ~/.claude/skills/api-error-handling-design/SKILL.md

Or just download SKILL.md directly and drop it into ~/.claude/skills/api-error-handling-design/. Claude Code auto-discovers it on next session.

Skills live at ~/.claude/skills/api-error-handling-design/SKILL.md on macOS/Linux, or %USERPROFILE%\.claude\skills\api-error-handling-design\SKILL.md on Windows. See the full install guide for step-by-step instructions.

📱 Install from your phone or desktop Telegram

Open @claudskills_bot on Telegram, tap Open Desktop App, and the desktop app installs this skill for you. Or share the bot link with a colleague — they get the same one-tap install. Learn more →

Pro

One-click install via the desktop app

The ClaudSkills desktop app installs any skill directly into ~/.claude/skills/ with one click — no terminal required. Pro starts at $9/mo or $149 lifetime.

Pro

For the full experience including quality scoring and one-click install features for each skill — upgrade to Pro.

See pricing → Download desktop app

Frequently asked questions

How do I install the API Error Handling Design Claude Code skill?

Install via the ClaudSkills desktop app (one click) or copy SKILL.md from the source repository to ~/.claude/skills/api-error-handling-design/SKILL.md and restart Claude Code. Both flows are detailed at claudskills.com/install/.

What does the API Error Handling Design skill do?

Is this skill free to install?

Yes. ClaudSkills is an open registry — every skill keeps its source repository's license, and manual install via copy is free. ClaudSkills Pro ($9/mo, $79/yr, or $149 one-time) adds one-click install via the desktop app and a multi-signal Quality Score.

When should I use the API Error Handling Design skill?

Use API Error Handling Design when your Claude Code task falls under the Security category — specifically in the identity access area. Claude Code auto-discovers installed skills and invokes the right one based on the task description, so you can also ask Claude directly (e.g. "use API Error Handling Design" or describe the task and let Claude pick). Browse related skills at /category/security/.

What is a Claude Code skill and how does the API Error Handling Design skill fit in?

A Claude Code skill is a SKILL.md file that lives under ~/.claude/skills/<name>/ and tells the Claude Code CLI agent how to perform a specific task (instructions, prompts, allowed tools). Skills are auto-discovered at session start. API Error Handling Design is one of 67,000+ skills indexed in the open ClaudSkills catalog, classified under the Security category. Learn more at /learn/what-is-a-claude-skill/.

Attribution & license

Source: https://github.com/PranavNagrecha/AwesomeSalesforceSkills/blob/03f41a3ad58e942d13a224a98f3a769869f309f3/skills/integration/api-error-handling-design/SKILL.md
License: Apache-2.0
Author: Pranav Nagrecha
Website: https://pypi.org/project/sfskills-mcp/

Cite this skill

If you reference this skill in a blog post, paper, or documentation, you can cite it as:

APA

Pranav Nagrecha. (2026). API Error Handling Design [Claude Code skill]. ClaudSkills. https://claudskills.com/skills/api-error-handling-design/

BibTeX

@misc{api-error-handling-design-2026,
  author    = {Pranav Nagrecha},
  title     = {API Error Handling Design [Claude Code skill]},
  year      = {2026},
  publisher = {ClaudSkills},
  url       = {https://claudskills.com/skills/api-error-handling-design/}
}

Embed this skill

Promote, attribute, or link this skill from your own README, blog post, or documentation. All three snippets are free to use — no sign-up, no API key. More distribution surfaces →

Badge

[![ClaudSkills](https://claudskills.com/badge/api-error-handling-design.svg)](https://claudskills.com/skills/api-error-handling-design/?utm_source=badge&utm_medium=readme&utm_campaign=skill_badge)

More Security skills

Browse all Security skills in the ClaudSkills registry, or explore these other picks from the same category:

Browse all Security skills → Top 100 skills

Part of ClaudSkills — the open registry for Claude Skills & Claude Code Skills. · What's New · Install guide · About · llms.txt

Part of Acreator Store — Adam Lankamer's AI tools: PerfectStudio · Ucaption · UTagger · AutoXPoster · TestYourSkills · AutomationFlows · Au Naturel · Telegram @acreatorstore