How should I handle errors in my Oban workers?

This skill advocates for the 'Let It Crash' philosophy. Instead of catching errors, let them bubble up so Oban can handle automatic logging, retries with exponential backoff, and visibility in the dashboard.

Does this skill help with Oban Pro features?

Yes, it includes detailed patterns for Oban Pro Workflows, including when to use Grafting versus Cascades, and how to handle recorded values across job steps.

When should I use Workflows instead of simple job chaining?

Workflows should be reserved for complex dependency graphs, fan-in/fan-out patterns, or when you need recorded values across steps. For simple linear A-to-B chains, the skill suggests manual enqueuing to reduce complexity.

What is the 'Iron Law' of Oban jobs mentioned in this skill?

The Iron Law states that job arguments are serialized to JSON. This means any atom keys used when enqueuing a job will be converted to strings when the job is actually processed, a common source of bugs.

Oban Background Jobs

Name: Oban Background Jobs
Author: georgeguimaraes

bygeorgeguimaraes

•

Developer Tools

Optimizes background job processing in Elixir using Oban and Oban Pro best practices, serialization rules, and workflow patterns.

This skill provides specialized architectural guidance for Elixir developers using the Oban background job library. It helps prevent common debugging headaches by enforcing the 'Iron Law' of JSON serialization, guides users through robust error handling using Elixir's 'let it crash' philosophy, and provides implementation patterns for complex Oban Pro features like Workflows, Grafting, and Batches. Whether you are scheduling simple async tasks or architecting high-throughput data pipelines, this skill ensures your job processing is reliable, scalable, and idiomatic.

Key Features

01JSON serialization and atom-to-string conversion safety checks

02Idiomatic error handling and retry logic patterns

03Expert guidance on Oban Pro Workflows, Cascades, and Grafting

04Strategies for high-throughput job chunking and batch processing

05Testing strategies for asynchronous jobs and complex workflows

0676 GitHub stars

Use Cases

01Optimizing database performance for millions of background tasks

02Implementing reliable email delivery and external API integrations

03Architecting multi-step data processing pipelines with dependencies

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add georgeguimaraes/claude-code-elixir oban-thinking

For use in Claude.ai and ChatGPT

Download Skill